History

Joshua Boniface d366f08a3f Add support for SSH deploy key cloning		2021-10-31 02:11:57 -04:00
..
README.md	Add systemd example configurations	2021-10-31 00:51:38 -04:00
bbuilder-api.service	Remove extra spaces around =	2021-10-31 01:12:07 -04:00
bbuilder-worker.service	Remove extra spaces around =	2021-10-31 01:12:07 -04:00
environment.example	Add support for SSH deploy key cloning	2021-10-31 02:11:57 -04:00

README.md

Example Systemd configuration for Basic Builder

This directory contains an example configuration set for running Basic Builder under systemd.

This presumes you've done a pip3 install . in the root of the repository (or in a virtualenv, etc.).

For demonstration purposes, the ExecStart path is /usr/local/bin/bbuilder, the EnvironmentFile is located at /etc/default/bbuilder, and that the User to execute as is named git.

Copy environment.example to /etc/default/bbuilder and edit it to suit your needs.

NOTE: This file contains the sensitive BB_AUTH_KEY value. Ensure this file is only readable by trusted users (e.g. mode 400)!
Copy bbuilder-api.service and bbuilder-worker.service into /etc/systemd/system.
Run sudo systemctl daemon-reload to load the changes to Systemd.
If applicable, create your service user.
Start the API (sudo systemctl start bbuilder-api.service) and Worker (sudo systemctl start bbuilder-worker.service).
Configure your webhooks, etc.