eligibility-verification PG16 staging 実施手順・記録(staging-direct/✅ 完了済み)
✅ staging は 2026-06-25〜26 に移行完了(PG 16.13)。2026-08-19 実機で再確認済み (cluster
eligibility-verification=16.13/ CPG =eligibility-verification-pg16)。 本書は 実施記録+再現手順。本番当日の手順は →production.md。調査・固有値は →preflight.md。 汎用手順の背景は../../procedure-staging-direct.md。
関連 Issue: mental-online-karte #14063(staging-direct 実施)/ #13098(staging 調査・検証)
1. 環境(実機確認 2026-08-19・profile staging-admin)
| 項目 | 値 |
|---|---|
| AWS アカウント | 301608970378 |
| リージョン | ap-northeast-1 |
| クラスタ | eligibility-verification(Writer 1台 eligibility-verification-0 / Reader 無し・非-Global) |
| インスタンスクラス | db.t3.medium(PI 無効) |
| エンジン(現在) | 16.13 ← 移行前は 13.x |
| Cluster/Instance PG | eligibility-verification-pg16(aurora-postgresql16) |
| DB Security Group | sg-0ab38c77bb380fda7 |
| 踏み台 | i-0cefcd4a25e8703e5(fd-office-connection・SG sg-0cf2a96d7429ac09e)★fd-platform 踏み台は EVS SG 不許可で不可 |
| Secret / DB 名 | eligibility-verification / eligibility_verification |
| endpoint | eligibility-verification.cluster-ctb7v7xkimcr.ap-northeast-1.rds.amazonaws.com |
2. 本番との差(=手順の読み替え)
| 観点 | staging | production |
|---|---|---|
| 踏み台 | i-0cefcd4a25e8703e5 | i-03b8c9b9fb3c4fe9a |
| プロファイル | staging-admin | 変更系 production-admin |
| メンテ枠・周知 | 不要(社内周知のみ) | 必須(#on本部_release-ops + #fdtech-general) |
| アプリ E2E | 実 PII 不可・ダミー画像で OCR を能動的に起こしてよい | 能動的な OCR は起こさない(実 PII のため)。通常トラフィックの自然増分で確認 |
| ロールバック | snapshot のみで可 | snapshot + old1 + Secret 差し戻し手順(production.md §11) |
その他(CPG 構成・BG コマンド・Green 検証・ゲート・事後処理)は 本番と同一。
3. 実施内容(2026-06-25〜26・#14063)
procedure-staging-direct.md のフェーズ B→C→D を staging 実クラスタ本体に直接適用(Clone なし)。
| フェーズ | 内容 | 結果 |
|---|---|---|
| B | source CPG(PG13・logical_replication=1 / wal_sender_timeout=0)付替 → Writer 1台 reboot(瞬断)→ CREATE EXTENSION pg_stat_statements | on / logical / 0 確認・拡張作成 OK |
| C | 標準 BG 作成(非-Global・target 16.13・cluster/instance PG=eligibility-verification-pg16)→ Green 検証 | Green=16.13 / Blue==Green 件数整合 / ライブ複製 OK |
| D | Switchover → 事後 | 書込断 約2秒(RDS events 実測)/ 拡張 1.10 へ UPDATE / slot 0 / 旧 blue 残留接続 0 |
アプリ検証: 画面(fastdoctor-manager の保険証アップロード)・GraphQL(fdc api graphql)両経路から 新 PG16 への書込(ocr_results +1)を確認。手順は preflight.md §7。
Clone リハーサル(先行・2026-06-16〜17): clone-rehearsal.md 参照。
4. 検証スクリプトによる再確認(いつでも実行可)
staging は移行済みのため、以下は PG16 側の健全性チェックとして使える (本番実施前に「post 側の期待出力」を目視で確認しておく用途にも有用)。
bash docs/sre/scripts/pg16-verify-eligibility-verification.sh --env staging --label post期待:
1) server_version→ 16.133) 接続元→ECS 属性化→eligibility-verification-serviceの接続が見える4) シーケンス継続性→ verdict が全てOK/unused6) writability→in_recovery=false
--write-probeは staging でのみ気軽に使える(ocr_resultsの id を1消費するがROLLBACKでコミットはしない)。--api-probeはGET /health-checkのみ=DB 疎通の証明にはならない点に注意(preflight.md§6-2)。
5. Terraform 整合(staging・完了済み)
fastdoctor-template/eligibility-verification/staging/main.tf:rds_engine_version/rds_familyを PG16 系へ(実績 PR: terraform_for_aws #2263)pg16_param_groups.tf: target CPG(aurora-postgresql16)を作成- ✅ 2026-08-19 実機で CPG=
eligibility-verification-pg16が cluster/instance に付与済みであることを確認 - CloudWatch ダッシュボードは staging には置かない(BG はもう走らないため。本番のみ)