bluegit-runner — aparte CI-runner
bluegit-runner draait BlueGit CI-jobs op je eigen machine, in Docker, net als de ingebouwde runner. De runner maakt alleen uitgaande HTTPS-verbindingen naar BlueGit (long-poll); er hoeft geen poort open. De ingebouwde BlueGit-runner blijft gewoon bestaan.
Installeren (Arch / AUR)
yay -S bluegit-runner # of: git clone https://aur.archlinux.org/bluegit-runner.git && makepkg -si
Het pakket maakt de systeemgebruiker bluegit-runner (lid van docker), installeert bluegit-runner.service en zet die aan. De service start zodra /etc/bluegit-runner/config.yml bestaat; een upgrade herstart hem.
Andere systemen: go build -o /usr/bin/bluegit-runner ./cmd/bluegit-runner en kopieer de bestanden uit packaging/runner/ naar systemd (bluegit-runner.service, sysusers.d, tmpfiles.d).
Registreren
1. In BlueGit: Instellingen → Runners → Nieuw registratietoken voor een account-runner, of Groep → Instellingen → Runners voor een groepsrunner (maintainer). Het token (bgrr_…) is 24 uur geldig, eenmalig, en je ziet het één keer. 2. Op de machine:
sudo bluegit-runner register --url https://git.timfalken.com --token bgrr_... [--name mijn-pc]
De runner krijgt een eigen runner-token (bgr_…); de server bewaart alleen de hash. Het token staat in /etc/bluegit-runner/config.yml (mode 0600, eigenaar bluegit-runner). register start de service. 3. In de UI staat de runner nu als online. Intrekken kan daar ook; het token werkt dan meteen niet meer.
Het registratietoken mag ook via BLUEGIT_RUNNER_REGISTRATION_TOKEN.
Config
/etc/bluegit-runner/config.yml:
| sleutel | standaard | |
|---|---|---|
url | — | BlueGit-adres (door register) |
token | — | runner-token (door register) |
name | hostname | naam in de UI en in de joblog |
docker | docker | docker-binary |
git | git | git-binary |
work_dir | /var/lib/bluegit-runner | werkmappen en cache |
network | bridge | docker-netwerk voor jobs zonder services |
concurrency | 1 | jobs tegelijk |
Welke runner krijgt een job?
Repo van een account — voorkeur onder Instellingen → Runners:
- Mijn runners alleen als de BlueGit-runner niet meteen beschikbaar is
(standaard): BlueGit-runner → eigen runners.
- Eigen runners eerst: eigen runners → BlueGit-runner.
Repo van een groep: groepsrunners → account-runners van maintainers die toestemming gaven (Groep → Instellingen → Runners → "Mijn runners toestaan") → BlueGit-runner. Met Probeer BlueGit runner eerst staat de BlueGit-runner vooraan.
Een trede zonder online runner wordt meteen overgeslagen. Pakt geen runner de job binnen 20 seconden op, of is de BlueGit-runner vol, dan gaat de job naar de volgende trede (en daarna weer rond). Een runner die midden in een job 5 minuten niets van zich laat horen, laat de job mislukken met runner_system_failure (retry-regels gelden).
Privacy: een account-runner krijgt alleen jobs uit repo's die zijn eigenaar mag lezen; een groepsrunner alleen uit repo's van die groep. Toestemming van een maintainer telt alleen zolang die maintainer is. Het runner-token mag alleen de repo clonen van een job die die runner op dat moment draait. De rechten van CI_JOB_TOKEN zijn ongewijzigd.
Wat gebeurt er per job
1. Long-poll POST /api/v1/runner/jobs/request geeft de job: script, variabelen (incl. geheimen en CI_JOB_TOKEN), maskers, clone-URL, sha. 2. Clone via HTTPS met het runner-token, checkout van de sha. 3. Artifacts van eerdere jobs: GET /api/v1/runner/jobs/{id}/inputs. 4. Container draaien (zelfde code als de ingebouwde runner, incl. image presets en services); log elke seconde naar POST /api/v1/runner/jobs/{id}/log (antwoord {"cancel":true} stopt de job). 5. Artifacts: PUT /api/v1/runner/jobs/{id}/artifacts (alleen de gedeclareerde paden). 6. POST /api/v1/runner/jobs/{id}/finish.
Heartbeat: POST /api/v1/runner/heartbeat elke 30 s; online = contact in de laatste 90 s. De cache (cache:) blijft lokaal op de runnermachine in work_dir/cache.
De job-UI en de API (runner in job-JSON: {id, name, kind}) tonen welke runner een job draaide.
Problemen
journalctl -u bluegit-runner -f
sudo -u bluegit-runner docker info # moet werken (groep docker)
Source
| 1 | # bluegit-runner — aparte CI-runner |
| 2 | |
| 3 | `bluegit-runner` draait BlueGit CI-jobs op je eigen machine, in Docker, |
| 4 | net als de ingebouwde runner. De runner maakt alleen **uitgaande** |
| 5 | HTTPS-verbindingen naar BlueGit (long-poll); er hoeft geen poort open. |
| 6 | De ingebouwde BlueGit-runner blijft gewoon bestaan. |
| 7 | |
| 8 | ## Installeren (Arch / AUR) |
| 9 | |
| 10 | ```sh |
| 11 | yay -S bluegit-runner # of: git clone https://aur.archlinux.org/bluegit-runner.git && makepkg -si |
| 12 | ``` |
| 13 | |
| 14 | Het pakket maakt de systeemgebruiker `bluegit-runner` (lid van `docker`), |
| 15 | installeert `bluegit-runner.service` en zet die aan. De service start |
| 16 | zodra `/etc/bluegit-runner/config.yml` bestaat; een upgrade herstart hem. |
| 17 | |
| 18 | Andere systemen: `go build -o /usr/bin/bluegit-runner ./cmd/bluegit-runner` |
| 19 | en kopieer de bestanden uit `packaging/runner/` naar systemd |
| 20 | (`bluegit-runner.service`, `sysusers.d`, `tmpfiles.d`). |
| 21 | |
| 22 | ## Registreren |
| 23 | |
| 24 | 1. In BlueGit: **Instellingen → Runners → Nieuw registratietoken** voor een |
| 25 | account-runner, of **Groep → Instellingen → Runners** voor een |
| 26 | groepsrunner (maintainer). Het token (`bgrr_…`) is 24 uur geldig, |
| 27 | eenmalig, en je ziet het één keer. |
| 28 | 2. Op de machine: |
| 29 | |
| 30 | ```sh |
| 31 | sudo bluegit-runner register --url https://git.timfalken.com --token bgrr_... [--name mijn-pc] |
| 32 | ``` |
| 33 | |
| 34 | De runner krijgt een eigen runner-token (`bgr_…`); de server bewaart |
| 35 | alleen de hash. Het token staat in `/etc/bluegit-runner/config.yml` |
| 36 | (mode 0600, eigenaar `bluegit-runner`). `register` start de service. |
| 37 | 3. In de UI staat de runner nu als **online**. Intrekken kan daar ook; |
| 38 | het token werkt dan meteen niet meer. |
| 39 | |
| 40 | Het registratietoken mag ook via `BLUEGIT_RUNNER_REGISTRATION_TOKEN`. |
| 41 | |
| 42 | ## Config |
| 43 | |
| 44 | `/etc/bluegit-runner/config.yml`: |
| 45 | |
| 46 | | sleutel | standaard | | |
| 47 | |---|---|---| |
| 48 | | `url` | — | BlueGit-adres (door register) | |
| 49 | | `token` | — | runner-token (door register) | |
| 50 | | `name` | hostname | naam in de UI en in de joblog | |
| 51 | | `docker` | `docker` | docker-binary | |
| 52 | | `git` | `git` | git-binary | |
| 53 | | `work_dir` | `/var/lib/bluegit-runner` | werkmappen en cache | |
| 54 | | `network` | `bridge` | docker-netwerk voor jobs zonder services | |
| 55 | | `concurrency` | `1` | jobs tegelijk | |
| 56 | |
| 57 | ## Welke runner krijgt een job? |
| 58 | |
| 59 | **Repo van een account** — voorkeur onder Instellingen → Runners: |
| 60 | |
| 61 | - *Mijn runners alleen als de BlueGit-runner niet meteen beschikbaar is* |
| 62 | (standaard): BlueGit-runner → eigen runners. |
| 63 | - *Eigen runners eerst*: eigen runners → BlueGit-runner. |
| 64 | |
| 65 | **Repo van een groep**: groepsrunners → account-runners van maintainers |
| 66 | die toestemming gaven (Groep → Instellingen → Runners → "Mijn runners |
| 67 | toestaan") → BlueGit-runner. Met **Probeer BlueGit runner eerst** staat |
| 68 | de BlueGit-runner vooraan. |
| 69 | |
| 70 | Een trede zonder online runner wordt meteen overgeslagen. Pakt geen |
| 71 | runner de job binnen 20 seconden op, of is de BlueGit-runner vol, dan |
| 72 | gaat de job naar de volgende trede (en daarna weer rond). Een runner die |
| 73 | midden in een job 5 minuten niets van zich laat horen, laat de job |
| 74 | mislukken met `runner_system_failure` (retry-regels gelden). |
| 75 | |
| 76 | **Privacy**: een account-runner krijgt alleen jobs uit repo's die zijn |
| 77 | eigenaar mag lezen; een groepsrunner alleen uit repo's van die groep. |
| 78 | Toestemming van een maintainer telt alleen zolang die maintainer is. |
| 79 | Het runner-token mag alleen de repo clonen van een job die die runner op |
| 80 | dat moment draait. De rechten van `CI_JOB_TOKEN` zijn ongewijzigd. |
| 81 | |
| 82 | ## Wat gebeurt er per job |
| 83 | |
| 84 | 1. Long-poll `POST /api/v1/runner/jobs/request` geeft de job: script, |
| 85 | variabelen (incl. geheimen en `CI_JOB_TOKEN`), maskers, clone-URL, sha. |
| 86 | 2. Clone via HTTPS met het runner-token, checkout van de sha. |
| 87 | 3. Artifacts van eerdere jobs: `GET /api/v1/runner/jobs/{id}/inputs`. |
| 88 | 4. Container draaien (zelfde code als de ingebouwde runner, incl. image |
| 89 | presets en services); log elke seconde naar |
| 90 | `POST /api/v1/runner/jobs/{id}/log` (antwoord `{"cancel":true}` stopt de job). |
| 91 | 5. Artifacts: `PUT /api/v1/runner/jobs/{id}/artifacts` (alleen de gedeclareerde paden). |
| 92 | 6. `POST /api/v1/runner/jobs/{id}/finish`. |
| 93 | |
| 94 | Heartbeat: `POST /api/v1/runner/heartbeat` elke 30 s; online = contact in |
| 95 | de laatste 90 s. De **cache** (`cache:`) blijft lokaal op de |
| 96 | runnermachine in `work_dir/cache`. |
| 97 | |
| 98 | De job-UI en de API (`runner` in job-JSON: `{id, name, kind}`) tonen |
| 99 | welke runner een job draaide. |
| 100 | |
| 101 | ## Problemen |
| 102 | |
| 103 | ```sh |
| 104 | journalctl -u bluegit-runner -f |
| 105 | sudo -u bluegit-runner docker info # moet werken (groep docker) |
| 106 | ``` |