Skip to content

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 PGeligibility-verification-pg16aurora-postgresql16
DB Security Groupsg-0ab38c77bb380fda7
踏み台i-0cefcd4a25e8703e5fd-office-connection・SG sg-0cf2a96d7429ac09e)★fd-platform 踏み台は EVS SG 不許可で不可
Secret / DB 名eligibility-verification / eligibility_verification
endpointeligibility-verification.cluster-ctb7v7xkimcr.ap-northeast-1.rds.amazonaws.com

2. 本番との差(=手順の読み替え)

観点stagingproduction
踏み台i-0cefcd4a25e8703e5i-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 なし)。

フェーズ内容結果
Bsource CPG(PG13・logical_replication=1 / wal_sender_timeout=0)付替 → Writer 1台 reboot(瞬断)→ CREATE EXTENSION pg_stat_statementson / logical / 0 確認・拡張作成 OK
C標準 BG 作成(非-Global・target 16.13・cluster/instance PG=eligibility-verification-pg16)→ Green 検証Green=16.13 / Blue==Green 件数整合 / ライブ複製 OK
DSwitchover → 事後書込断 約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
bash docs/sre/scripts/pg16-verify-eligibility-verification.sh --env staging --label post

期待:

  • 1) server_version16.13
  • 3) 接続元→ECS 属性化eligibility-verification-service の接続が見える
  • 4) シーケンス継続性verdict が全て OK/unused
  • 6) writabilityin_recovery=false

--write-probe は staging でのみ気軽に使える(ocr_results の id を1消費するが ROLLBACK でコミットはしない)。 --api-probeGET /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 はもう走らないため。本番のみ)