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.

Remove the container deployment

9bce37233413e6a56c38d5cf90e79dfa496649b2 · Keenan Nemetz · 3d ago · parent c1edfd3c

Remove the container deployment

A Vole instance is one process whose state is a directory on local disk. A
container therefore adds a layer without removing one, and it costs
something real: the service unit's hardening, and the CI half, which needs
an OCI runtime the container does not have without mounting the host's
socket — the thing the runner docs refuse.

It was also the weakest path in practice. No image is published, so an
upgrade meant a source checkout and a Go build where the package is one
`apt install`. CI never ran the container; it was tested by hand once, which
is a surface that rots quietly.

So the Dockerfile, the compose file, the entrypoint, the image's
configuration, and the guide go. The deployment checker loses its compose
and COPY checks, and the render script is the only shipped script left.

Every other mention of Docker in the repository means the CI container
runtime, and those stay.

Users who manage their machines with Compose or Kubernetes are told where
they stand: give the forge a small virtual machine of its own, and the
first-boot file works there unchanged.

docs/deploy/README.md +9−4

@@ -14,8 +14,7 @@ nothing to install on your own computer except the shell you already have.
14 14 | A Hetzner Cloud account | [Hetzner Cloud](hetzner.md) |
15 15 | A DigitalOcean account | [DigitalOcean](digitalocean.md) |
16 16 | An AWS account | [AWS](aws.md) |
17 | Any other Ubuntu or Debian machine | [Any server](vps.md) |
18 | A container host | [Docker](docker.md) |
17 | Any other Ubuntu or Debian machine, or a machine you already have | [Any server](vps.md) |
19 18
20 19 ## What you need
21 20
@@ -30,6 +29,12 @@ nothing to install on your own computer except the shell you already have.
30 29 architecture: `…/r/vole/releases/<tag>/artifacts/vole_<version>-1_amd64.deb`, or
31 30 `arm64` instead of `amd64`.
32 31
32 There is no container image. Vole is one process whose state is a directory on
33 local disk, so a container would add a layer without removing one, and it would
34 cost the service unit's hardening. If your machines are already managed by
35 Compose or Kubernetes, give the forge a small virtual machine of its own; the
36 first-boot file works there unchanged.
37
33 38 ## What happens on first boot
34 39
35 40 The machine installs the package, writes a configuration that answers on your
@@ -109,5 +114,5 @@ migration cannot be undone, so take a backup first.
109 114 ## The files behind these guides
110 115
111 116 Everything the guides use lives under [`deploy/`](../../deploy/README.md) in this
112 repository: the first-boot file, the renderer that fills it in, and the container
113 files. Read them before you run them; they are short.
117 repository: the two first-boot files and the renderer that fills them in. Read
118 them before you run them; they are short.