Sign in

Search issue titles and bodies, change requests and comments. Private repositories you cannot read are not included.

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/deploy/README.md +11

@@ -59,6 +59,17 @@ When it is up:
59 59 Your own shell access to the machine is on port 22 and stays useful for upgrades
60 60 and backups. Vole's Git over SSH is on port 2222 and is a separate listener.
61 61
62 ## CI is a second machine
63
64 These guides create the forge. A runner — the machine that leases jobs and runs
65 them in containers — is a separate decision and a separate machine, because it
66 executes repository code and can read every secret a job declares. Each Terraform
67 configuration takes `-var runner=true` to create one, and it needs one more step
68 per repository before it takes work.
69
70 - [CI runners](runner.md) — creating one, registering it, and allowing it on a
71 repository
72
62 73 ## Backups are still your job
63 74
64 75 A cloud's daily snapshot is the fastest way to get a machine back after a bad