docs: say which services singleHostSwarm leaves off, and format the table
The services intro claimed singleHostSwarm runs every service with no further setting. The CI runner is never derived, and the builder and cache need their store identities on the host. The overview table is also formatted the way treefmt wants it.
This commit is contained in:
parent
c9bdad0170
commit
c85233efd4
1 changed files with 25 additions and 23 deletions
|
|
@ -98,14 +98,16 @@ that service, not here.
|
||||||
## Services
|
## Services
|
||||||
|
|
||||||
An operator who isn't spreading the swarm over more than one host can skip most of
|
An operator who isn't spreading the swarm over more than one host can skip most of
|
||||||
this page: `singleHostSwarm` runs every service below with no further
|
this page: `singleHostSwarm` turns on the shared services below, with two
|
||||||
setting. The table says what each one does and where its option and its
|
exceptions. The **CI runner** stays off until you set `deploy.ci-runner.enable`,
|
||||||
section are. Only the **builder** and the **CI runner** cost real resources
|
and the **builder** and **binary cache** come on only where the host has their
|
||||||
(they build and run pull-request code), so those are the two worth a look
|
store identities. The table says what each one does and where its option and
|
||||||
before you switch them on.
|
its section are. The builder and the CI runner are the two that cost real
|
||||||
|
resources (they build and run pull-request code), so they're the two worth a
|
||||||
|
look before you switch them on.
|
||||||
|
|
||||||
| Service | What it does | Option | Details |
|
| Service | What it does | Option | Details |
|
||||||
| --- | --- | --- | --- |
|
| ------------------- | --------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------ |
|
||||||
| Forge | Holds the meta flake and every agent's config repo. | `deploy.forgejo.enable` | [forge.md](forge.md) |
|
| Forge | Holds the meta flake and every agent's config repo. | `deploy.forgejo.enable` | [forge.md](forge.md) |
|
||||||
| Matrix | The chat homeserver agents and the operator talk over. | `deploy.matrix.enable` | [matrix.md](matrix.md) |
|
| Matrix | The chat homeserver agents and the operator talk over. | `deploy.matrix.enable` | [matrix.md](matrix.md) |
|
||||||
| Secret store | Keeps the swarm's credentials. | `deploy.bao.enable` | [credentials.md](credentials.md) |
|
| Secret store | Keeps the swarm's credentials. | `deploy.bao.enable` | [credentials.md](credentials.md) |
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue