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/digitalocean.md +8

@@ -63,6 +63,10 @@ Everything else has a working default. Pass these with `-var` or in a
63 63 | `enable_backups` | `true` | Weekly droplet backups, for about 20% of the droplet price |
64 64 | `tls_mode` | `acme` | `proxy` leaves TLS to a proxy you run instead, and serves plain HTTP on loopback |
65 65 | `instance_name` | `Vole` | What the landing page calls this forge |
66 | `runner` | `false` | Create a second machine that runs CI jobs. See [CI runners](runner.md): it needs one more step per repository before it takes work |
67 | `runner_type` | `s-2vcpu-4gb` | Droplet size for that machine. Builds want memory, so raise this before the forge's own size |
68 | `runner_labels` | `["linux"]` | What the runner advertises; a job with `runs-on` only comes to a machine carrying every label it asks for |
69 | `runner_network` | `bridge` | Whether a job that asks for a network gets one. Jobs that fetch dependencies need it |
66 70
67 71 The droplet reports CPU, memory, and disk to DigitalOcean's graphs, which is the
68 72 quickest way to see that a build filled the disk.
@@ -70,6 +74,10 @@ quickest way to see that a build filled the disk.
70 74 `terraform apply` is safe to run again: it reports no changes. It does not upgrade
71 75 Vole, and it does not touch the machine's data.
72 76
77 With `-var runner=true`, `terraform output runner_setup` prints the commands that
78 let the second machine take jobs. It needs one step per repository before it
79 receives any work; see [CI runners](runner.md).
80
73 81 DigitalOcean has no delete protection on droplets, so `terraform destroy` does
74 82 what it says. The instance's repositories and accounts are on that droplet.
75 83