windyboy
885d977531
Rebase onto origin/main surfaced runbooks/home-assistant-maintenance.md (W1N-69) which predated the runbook reorg. Add Purpose/Scope/Safety headers and add it to the README routing index (now 17/17 consistent).
2.1 KiB
2.1 KiB
Runbook index
Entry point for all runbooks. Before operational work, read the repo entry
AGENTS.md and the spec RUNBOOKS.md. New
runbooks start from _template.md.
Route by intent
| Intent | Runbook | Type |
|---|---|---|
| mailcow health check | mailcow-health.md | read-only |
| mailcow update | mailcow-update.md | change (gated) |
| mailcow SMTP/IMAP client | mailcow-smtp-client.md | reference |
| Vaultwarden health check | vaultwarden-health.md | read-only |
| Vaultwarden SQLite→PG migrate | vaultwarden-sqlite-to-postgres.md | change (destructive) |
| PowerDNS health check | pdns-health.md | read-only |
| RustDesk health check | rustdesk-health.md | read-only |
| Matrix health check | matrix-health.md | read-only |
| AdGuard Home health check | adguard-home-health.md | read-only |
| Home Assistant maintenance | home-assistant-maintenance.md | change (gated) |
| Routine Ansible operations | ansible-operations.md | change (allowlisted) |
| Linear issue → mergeable change | issue-to-merge.md | delivery |
| Failing health/playbook run | fix-ci.md | change |
| Release a reviewed change to production | release.md | change (gated) |
| Roll back a change | rollback.md | change (gated) |
| Controlled network configuration | network-change.md | change (gated) |
| Network outage / service recovery | network-recovery.md | recovery |
Notes
fix-ci.md,release.md,rollback.md,network-change.md,network-recovery.mdare adapted from the upstream guide to this repo's VPS-ops context (execution layer is Ansible + SSH + Linear, not a software CI/CD pipeline).- Health runbooks are read-only; they stop (
STOP) when live state conflicts with the expected state instead of mutating production.