docs: keep infrastructure page navigational, not implementation detail

This commit is contained in:
inference-admin committed 2026-11-20 02:12:31 +00:00
1 parent 5ec2504426
commit 695c6cfcf3
1 file changed
+9 -18
+9 -18
View File
@@ -43,10 +43,8 @@ stays an agent problem: it cannot reach the chat, the gateway or member data.
Cloudron writes **encrypted** backups to Infomaniak's object storage in Cloudron writes **encrypted** backups to Infomaniak's object storage in
Switzerland every night and keeps the last **seven days**, so a failed upgrade Switzerland every night and keeps the last **seven days**, so a failed upgrade
or a lost server can be restored. The automation host backs up its own data to or a lost server can be restored. The automation host keeps its own encrypted
the same object storage; its backup credentials are root-only and never held by backup as well, with credentials kept apart from the agent's environment.
the agent. Bucket versioning is enabled, so a deleted snapshot object remains
recoverable rather than vanishing.
### Domain and DNS ### Domain and DNS
@@ -217,23 +215,16 @@ private, loopback, and internal addresses. The
independent and independently rotatable, so a leak has bounded scope. independent and independently rotatable, so a leak has bounded scope.
- **No secrets in version control.** Credentials live in the hosting platform's - **No secrets in version control.** Credentials live in the hosting platform's
environment, never in the repos. environment, never in the repos.
- **Least-privilege automation.** The steward agent runs as its own Unix user. - **Least-privilege automation.** The steward agent runs as its own Unix user;
Host root access is limited to a small allowlist of docs and backup service host-level actions that need root are operator-controlled.
commands; package installs, user management and arbitrary root commands need
the operator.
- **Backup keys stay outside the agent.** The nightly backup credentials live in
a root-only file, not the agent's environment.
- **Machine feeds are signed.** The portal's chat-key feed is reachable only
from the internal network and requires a timestamped HMAC in addition to its
sync token.
- **CI is advisory, not a trust boundary.** Woodpecker runs in a shared root
container, so its status is visible but does not gate merges; Owners review is
the gate. The operator docs record the runner-isolation work.
- **Accepted trade-offs** (documented, not hidden): member keys are stored in - **Accepted trade-offs** (documented, not hidden): member keys are stored in
the portal database so the co-op can serve them, and the API gateway must stay the portal database so the co-op can serve them, and the API gateway must stay
publicly reachable. Its admin surfaces are disabled; only the public API is publicly reachable. Its admin surfaces are disabled; only the public API is
exposed. The automation host's remaining backup-timer root hardening is exposed.
tracked in operator docs. - **Operational detail lives with operators.** Token scopes, backup handling,
CI trust and host access are recorded in
[`co-op/ops-docs`](https://git.inference.coop/co-op/ops-docs), not on this
page.
## For operators ## For operators