Skip to content

docs(backups): define application backup contract and restore drill#237

Open
ssdavidai wants to merge 5 commits into
mainfrom
alfred/alfa43-backup-contract
Open

docs(backups): define application backup contract and restore drill#237
ssdavidai wants to merge 5 commits into
mainfrom
alfred/alfa43-backup-contract

Conversation

@ssdavidai

Copy link
Copy Markdown
Owner

Implements GH #189 / ALFA-43 backup contract work.

Summary:

  • Adds deploy/BACKUPS.md as the canonical application-level backup and restore runbook.
  • Enumerates persistent Docker volumes, loss impact, and backup priority, including vault/state/files/Hermes/Caddy/service databases.
  • Replaces the stale Backups & Recovery docs page that claimed automatic restic backups with the current default-off/operator-run contract.
  • Adds scripts/restore-drill.sh, a non-destructive restore smoke that verifies a user-facing vault file and SQLite state artifact survive archive/restore.

Smoke evidence

  • bash scripts/restore-drill.sh — passed locally: restore drill passed: vault file and SQLite state artifact restored.
  • python - <<'PY' ... yaml.safe_load(Path('docker-compose.yaml').read_text()) ... PY — passed locally: compose-yaml-parse-ok.
  • docker compose config / docker compose config --volumes — not runnable in the Hermes worker runtime because Docker is not installed there; the runbook includes these as required operator/CI checks when Docker is available.

No backup credentials, tenant contents, or secret material are included.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant