Archives
/
ohwgiles_laminar
mirror of https://github.com/ohwgiles/laminar
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
323 Commits
3 Branches
13 Tags
1.4 MiB
 
 
 
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e67e0bc453'
${ noResults }
Go to file
Oliver Giles e67e0bc453
examples: add git post-receive hook example 		3 years ago
docker cmake: more appropriate use of CMAKE_INSTALL_PREFIX 4 years ago
etc Add Documentation links to the systemd service (#139) 3 years ago
examples examples: add git post-receive hook example 3 years ago
pkg pkg: centos8 has cmake not cmake3 3 years ago
src frontend: better dynamic update of graphs 3 years ago
test abort test: use "sleep inf" instead of "yes" 3 years ago
CMakeLists.txt make cmake 3.6 the minimum supported version 3 years ago
COPYING Added GPLv3 license file. 7 years ago
README.md README: Use nproc to get cpu core count 3 years ago
UserManual.md examples: add git post-receive hook example 3 years ago

README.md

Laminar CI status

Laminar (https://laminar.ohwg.net) is a lightweight and modular Continuous Integration service for Linux. It is self-hosted and developer-friendly, eschewing a configuration UI in favour of simple version-controllable configuration files and scripts.

Laminar encourages the use of existing GNU/Linux tools such as bash and cron instead of reinventing them.

Although the status and progress front-end is very user-friendly, administering a Laminar instance requires writing shell scripts and manually editing configuration files. That being said, there is nothing esoteric here and the guide should be straightforward for anyone with even very basic Linux server administration experience.

See the website and the documentation for more information.

Building from source

First install development packages for capnproto (version 0.7.0 or newer), rapidjson, sqlite and boost (for the header-only multi_index_container library) from your distribution's repository or other source.

On Debian Buster, this can be done with:

sudo apt install \
		 capnproto cmake g++ libboost-dev libcapnp-dev libsqlite-dev libsqlite3-dev make rapidjson-dev zlib1g-dev

Then compile and install laminar with:

git clone https://github.com/ohwgiles/laminar.git
cd laminar
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
make -j "$(nproc)"
# Warning: the following will overwrite an existing /etc/laminar.conf
sudo make install

make install includes a systemd unit file. If you intend to use it, consider creating a new user laminar or modifying the user specified in the unit file.

Packaging for distributions

The pkg directory contains shell scripts which use docker to build native packages (deb,rpm) for common Linux distributions. Note that these are very simple packages which may not completely conform to the distribution's packaging guidelines, however they may serve as a starting point for creating an official package, or may be useful if the official package lags.

Contributing

Issues and pull requests via GitHub are most welcome. All pull requests must adhere to the Developer Certificate of Origin.