Files
vps/runbooks
windyboy 906fb4a759 VPS-78: CSG day 费用口径统一 + 断档自愈 (v5) + v3/v5 迁移脚本入库
- compose/pgdb/csg-snapshot-v3.sql: 补提交(此前只存在于工作区,未入 git)
- compose/pgdb/csg-snapshot-v5.sql: 新增
  · csg_ladder_cost_raw() 无舍入阶梯费用助手
  · csg_daily_snapshot() v5: day 费用改累积边际差分 + round(...,2);
    p_month 上移 + 跨月守卫;日期与用量同源 latest_day_kwh
  · 一次性归一历史 day cost(UPDATE 3 行,总差 -0.01)
  · csg_backfill_missing_days() + job 1011(insert-only 断档自愈)
- runbooks/pgdb-health.md: 新增 check 9 CSG 归档新鲜度
- hosts/pgdb.md: v5 事实 + Known issues 2026-09-22
2026-09-22 08:45:45 +08:00
..

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
Gitea health check gitea-health.md read-only
Matrix health check matrix-health.md read-only
Plane health check plane-health.md read-only
pgdb health check pgdb-health.md read-only
pgdb DB restore (pg_restore) pgdb-restore.md change (procedure)
pgdb image/compose update pgdb-update.md change (gated)
AdGuard Home health check adguard-home-health.md read-only
Host disk cleanup (logs/apt/docker) host-disk-cleanup.md change (gated)
Matter packet capture matter-packet-capture.md read-only
Home Assistant maintenance home-assistant-maintenance.md change (gated)
matrix_e2ee integration update matrix-e2ee-update.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.md are 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.