メインコンテンツまでスキップ

ランブック: バックアップリストアのリハーサル(compose スタック)

四半期ごと、約 20 分です。backup compose サイドカーが作る日次の pg_dump で、実際にデータベースを再構築できることを証明し、コンプライアンスのエビデンステーブル用に RTO/RPO の数値を出します。このドリルの CI 内での自動版は go test -tags=integration -run TestDR_BackupWipeRestoreVerify ./tests/integration/dr/ です(docs/runbooks/dr-drill.md を参照)。このランブックは、稼働中の compose 導入に対する、手を動かす文書テストです。

バックアップを生成するもの​

deploy/docker-compose.prod.yml の backup サービスは、毎日 02:00 UTC に scripts/dr/backup_compose.sh を実行し、backup_data ボリューム(/data/backups)へ書き出します。形式はカスタム(pg_dump -F c)、gzip 圧縮、保持は 7 日です。

ステップ 1 — 新しいバックアップを取る​

cd deploy
docker compose -f docker-compose.prod.yml exec backup /bin/sh /app/backup.sh
docker compose -f docker-compose.prod.yml exec backup ls -lh /data/backups
# e.g. pg_20261005_021500.dump.gz

ステップ 2 — ダンプをボリュームの外へコピーする​

DUMP=pg_20261005_021500.dump.gz # pick the newest
docker compose -f docker-compose.prod.yml cp backup:/data/backups/$DUMP /tmp/$DUMP
ls -lh /tmp/$DUMP # record the size for the evidence table

ステップ 3 — 使い捨て Postgres へリストアする​

ライブの pg_data ボリュームへは、決してリストアしないでください。使い捨てコンテナを使います。

docker run -d --name restore-drill -e POSTGRES_PASSWORD=drill \
-e POSTGRES_DB=yabanin_drill postgres:16-alpine
sleep 5 # let it initialize
docker cp /tmp/$DUMP restore-drill:/tmp/$DUMP
gunzip -c /tmp/$DUMP > /tmp/$DUMP.raw # custom format: gunzip first
START=$(date +%s)
docker exec restore-drill psql -U postgres -c 'SELECT count(*) FROM information_schema.tables WHERE table_schema='"'"'public'"'"''
# ^ must print 0 — the drill target is empty (same fail-closed check as
# scripts/dr/restore.sh; refuse to continue otherwise)
docker exec restore-drill pg_restore -U postgres --no-owner --no-acl \
--exit-on-error -d yabanin_drill /tmp/$DUMP.raw
echo "restore took $(( $(date +%s) - START ))s" # RTO core component

ステップ 4 — リストアしたデータを検証する​

docker exec restore-drill psql -U postgres -d yabanin_drill -c \
"SELECT count(*) AS orgs FROM organizations;
SELECT count(*) AS keys FROM api_keys;
SELECT count(*) AS reqs FROM request_logs;"

組織とキーの件数が、ライブシステムと一致することを期待します(docker compose -f docker-compose.prod.yml exec postgres psql -U yabanin -d yabanin -c "<same queries>")。request_logs は、バックアップの経過時間だけ遅れます。その差分が RPO です。

行数を超える整合性チェック:

監査ハッシュチェーン: 本番の検証器は、自動ドリルで実行されます(pkg/auditlog/verifier、docs/runbooks/dr-drill.md のステップ 6)。手動リハーサルでは、最新の admin_audit_logs のシーケンスが連続していることを、抜き取りで確認します。

docker exec restore-drill psql -U postgres -d yabanin_drill -c \
"SELECT max(seq), count(DISTINCT seq) FROM admin_audit_logs;"

(max(seq) == count(DISTINCT seq) は、欠落がないことを意味します。チェーンハッシュの検証は、自動ドリル側に残します。)

ステップ 5 — エビデンスを記録する​

チームの DR ログに追記します。

日付ダンプサイズリストア時間RPO(バックアップの経過時間)課題承認
2026-Q4

目標(docs/runbooks/dr-drill.md より): エンドツーエンドの RTO は 60 分未満、日次サイドカーの RPO は 24 時間未満です(必要なら、ホスト cron で scripts/dr/backup_all.sh の実行を追加して縮めてください)。

ステップ 6 — 後始末​

docker rm -f restore-drill
rm -f /tmp/$DUMP /tmp/$DUMP.raw

ダンプには顧客データが含まれます。リハーサルホストから削除してください。

リストアが失敗した場合​

  1. --exit-on-error は、最初の不良項目で停止します。最後のエラーではなく、最初のエラーを読んでください。
  2. よくある原因: より新しいマイグレーションセットのダンプを、より古い Postgres へリストアしている。同じメジャーバージョン(postgres:16-alpine)を使ってください。
  3. バックアップが静かに失敗している場合は、サイドカーのログを確認します。docker compose -f docker-compose.prod.yml logs backup(cron の出力はコンテナログへ行きます。スクリプトは set -euo pipefail により、失敗したら直ちに止まります)。
  4. 実際のインシデントでのリストアは、(再作成した)ライブボリュームに対して同じコマンドに従います。ホスト側実行向けのフェイルクローズラッパーは、scripts/dr/restore_all.sh --backup-ts <TS> です。