Archives/ohwgiles_laminar
1
0
Fork 0
mirror of https://github.com/ohwgiles/laminar.git synced 2024-10-27 20:34:20 +00:00
Code Issues Projects Releases Wiki Activity
232 Commits 3 Branches 13 Tags 1.5 MiB
C++ 65.1%
JavaScript 13.4%
Shell 6.1%
HTML 4.6%
CSS 3.8%
Other 7%
39ca7e86cf
Go to file
Oliver Giles 39ca7e86cf replace websockets with sse and refactor 
Large refactor that more closely aligns the codebase to the kj async
style, more clearly exposes an interface for functional testing and
removes cruft. There is a slight increase in coupling between the
Laminar and Http/Rpc classes, but this was always an issue, just until
now more obscured by the arbitrary pure virtual LaminarInterface class
(which has been removed in this change) and the previous lumping
together of all the async stuff in the Server class (which is now
more spread around the code according to function).

This change replaces the use of Websockets with Server Side Events
(SSE). They are simpler and more suitable for the publish-style messages
used by Laminar, and typically require less configuration of the
reverse proxy HTTP server.

Use of gmock is also removed, which eases testing in certain envs.

Resolves #90.
2019-10-05 20:06:35 +03:00
docker resolves #102: example Dockerfile to build laminar docker image 2019-09-19 09:10:05 +03:00
etc resolves #85: systemd unit file After=network.target 2019-03-31 08:36:08 +03:00
example-scripts quote args to xsltproc 2015-09-20 09:23:50 +02:00
src replace websockets with sse and refactor 2019-10-05 20:06:35 +03:00
test replace websockets with sse and refactor 2019-10-05 20:06:35 +03:00
CMakeLists.txt replace websockets with sse and refactor 2019-10-05 20:06:35 +03:00
COPYING Added GPLv3 license file. 2017-10-11 09:56:26 +02:00
docker-build-centos.sh Install bash/zsh completions in correct locations 2018-10-16 20:38:48 +03:00
docker-build-debian.sh build scripts: debian 10 is now current stable 2019-09-04 09:33:16 +03:00
docker-xbuild-debian-armhf.sh build scripts: debian 10 is now current stable 2019-09-04 09:33:16 +03:00
README.md README: add explicit instruction for installing dependencies 2019-08-25 07:48:56 +03:00
UserManual.md replace websockets with sse and refactor 2019-10-05 20:06:35 +03:00

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=/
make -j4
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.