~sircmpwn/sr.ht-docs

sr.ht-docs/builds.sr.ht/installation.md -rw-r--r-- 1.1 KiB
81aa7396Dhruvin Gandhi builds.sr.ht/compat: add link to builds.sr.ht-guix 12 hours ago

#title: builds.sr.ht Installation

This document covers the installation steps for builds.sr.ht, a continuous integration service.

builds.sr.ht is comprised of two components: a master server and job runners. Typically, deployments have one master and many runners, which are distributed across multiple servers.

Note: For smaller deployments, job runners can be installed alongside the master server, but not without risk.

#Installation

On the master server, install the builds.sr.ht package.

On each server hosting a job runner, install the builds.sr.ht-worker and builds.sr.ht-images packages.

#Daemons

  • builds.sr.ht — The web service (master server).
  • builds.sr.ht-worker — The job runner.

#Configuration

See Configuration.

#Maintenance

To safely reboot a worker without dropping any running jobs, SIGINT the process and it will stop accepting new work and terminate once all existing jobs are completed.