vole
Clone
Read only, no credentials:
https://rodent.software/git/vole.git
Write over SSH with a registered key:
git clone ssh://git@0.0.0.0:2222/vole.git
A free and open-source forge that lives in your Git repo.
Document runners, and check the three files that describe one agree
e21f6c5e26cc49d5a08d337cb1c7b70d373a8cce · Keenan Nemetz · 3d ago · parent d0d4239f
Document runners, and check the three files that describe one agree A runner is a second decision after the forge, not part of its first boot: it executes repository code, it can read every secret a job declares, and the allowlist that lets it take work is per repository. The guide says what the deployment creates, how to set one up on a machine you already have, the one step only an admin can do, what to know before giving it a repository, and how to upgrade it. render.sh now renders either first-boot file, taking its placeholder list from the render line it uses, so the checker reads the same line instead of keeping a second copy. check-deploy.py renders both templates, requires each one's promised files with literal modes, and holds the runner's three descriptions together: the template writes the arguments, the unit reads them, and the package ships the example an operator copies. A name that drifts leaves a machine enabled and idle, which looks exactly like a runner that is working.
docs/packaging.md +2
| @@ -32,6 +32,8 @@ when the driver's bundled copy is used instead. | |||
| 32 | 32 | |---|---| | |
| 33 | 33 | | `/usr/bin/vole` | The binary, built from the tag with `vole version` set to it | | |
| 34 | 34 | | `/usr/lib/systemd/system/vole.service` | The unit, with hardening and a `/var/lib/vole` state directory | | |
| 35 | | `/usr/lib/systemd/system/vole-runner.service` | The CI runner's unit. Not enabled, and inert until `/etc/vole/runner.env` names an instance | | ||
| 36 | | `/etc/vole/runner.env` | Arguments for that unit, as a conffile. See [Deploying § CI runners](deploy/runner.md) | | ||
| 35 | 37 | | `/etc/vole/vole.toml` | Configuration, marked as a conffile so your edits survive upgrades | | |
| 36 | 38 | | `/usr/share/doc/vole/` | `LICENSE` and `NOTICE` | | |
| 37 | 39 | | `/var/lib/vole/data` | The instance: repositories, databases, stores, host key, audit log | | |