PG16 アップグレード サービス別パラメータ：<service>
このファイルは新規サービス追加用テンプレート。
<service>を対象サービス名に置き換えてコピーし、<...>を実値で埋める。 手順本体は Cloneリハーサル版 / 本番実施版 を参照（本書は固有値と実施記録のみ）。
対象サービス: <service>担当: <name>最終更新: <YYYY-MM-DD>
1. 環境・接続
| 項目 | staging | production |
|---|---|---|
AWS プロファイル（P） | <staging-profile> | <書き込み権限のある production プロファイル>（⚠️ read-only 不可） |
リージョン（R） | ap-northeast-1 | ap-northeast-1 |
| Secrets Manager Secret ID | <secret-id> | <secret-id> |
DB 名（psql dbname） | <db_name> | <db_name> |
| 接続方式 | <例: Prisma DATABASE_URL 単一 Secret / DB_HOST 未使用 など> | 同左 |
2. クラスタ構成（アップグレード対象）
| 項目 | 値 |
|---|---|
クラスタ識別子（SOURCE_CL） | <cluster-id> |
| インスタンス構成 | Writer <N>台 / Reader <N>台（describe-db-clusters の Members で確認） |
| インスタンスクラス | <db.r6g.large 等> |
| DB Subnet Group | <subnet-group> |
| VPC Security Group | <sg-id> |
| 現行エンジン | 13.x |
| target エンジン | 16.13 |
⚠️ Reader がいる場合、フェーズB の再起動は Writer→各 Reader を1台ずつ。台数を必ず実機で確認する。
3. パラメータグループ（#XXXX で作成）
| 役割 | 名前 | family |
|---|---|---|
| ソース側 custom CPG（PG13） | <cpg-name> | aurora-postgresql13 |
| ターゲット側 Cluster/Instance PG（PG16） | <cpg-name>-pg16 | aurora-postgresql16 |
rds.logical_replication=1/wal_sender_timeout=0（両方・pending-reboot）shared_preload_libraries:<source の現値>にpg_stat_statementsを追加（上書き型のため既存値を落とさない）。PG16 ターゲット CPG にも同値を揃える。
4. 使用拡張・後処理の該当有無
| 項目 | 該当 | 備考 |
|---|---|---|
インストール拡張（\dx） | <plpgsql, ...> | |
| pg_stat_statements | <要/不要> | preload 済み・別途 CREATE EXTENSION |
| pg_cron / pg_partman（bgw） | <使用/未使用> | 使用時は PG16 ターゲット CPG の preload に必須 |
| pg_repack | <使用/未使用> | |
| Auto Scaling / Reader | <あり/なし> | あれば Switchover 後に再設定確認 |
5. Blue/Green 名・スナップショット名
| 項目 | 値 |
|---|---|
Blue/Green 名（BG_NAME、本番） | <cluster-id>-bg |
| Blue/Green 名（リハーサル） | <cluster-id>-bgtest |
Clone 名（リハーサル CL） | <cluster-id>-bgtest-blue |
| Switchover 前スナップショット | <cluster-id>-pre-pg16-<YYYYMMDDHHMM> |
6. 整合確認テーブル（Green/Switchover 後の件数確認）
sql
-- services 固有の主要テーブルを列挙
SELECT COUNT(*) FROM <table_a>;
SELECT COUNT(*) FROM <table_b>;7. Terraform 整合対象（Switchover 後）
- パス:
fastdoctor-template/<service>/production/（staging も同様） rds_engine_versionを13.x→16.13へ- parameter group family を
aurora-postgresql16に、PG16 用 CPG/Instance PG 参照へ terraform planに downgrade / replace（ForceNew）が出ないことを確認してから apply
8. 関連 Issue / PR
- 親チケット:
<...> - CPG 追加 PR:
<...>
9. 実施記録
| 日付 | 環境 | フェーズ | 結果・所要・気付き |
|---|---|---|---|
<YYYY-MM-DD> | staging | リハーサル | <Green 作成 約NN分 / 書込断 約N秒 等> |
<YYYY-MM-DD> | production | 本番 | <メンテ枠 / snapshot 名 / 結果> |