マルチリージョン導入
アーキテクチャ
3 つのリージョンをアクティブ-アクティブで導入します。SG(シンガポール、プライマリ)、IN(インド)、EU(フランクフルト)です。 各リージョンは独自の Postgres+Redis+KMS を持ちます。組織データはホームリージョンに固定されます(RLS で強制されます)。
リージョン固定の契約
org_home_regionテーブルは、org_id を home_region と residency_pinned フラグへ対応付けます
request_logs、messages、sessions テーブルの行レベルセキュリティ:
- 各接続は、AfterConnect フックで
app.regionGUC を設定します - RLS の方針:
home_region = current_setting('app.region', true) - クロスリージョンのクエリは ゼロ行 を返します。データはホームリージョンの外へ出ません
フェイルオーバーの規則
- 固定されていない組織: ホームリージョンが不健全なとき、優先度に従い、次に健全なピアへ経路を向けます
- 固定された組織: ホームリージョンがダウンしている場合は 503 を返します。クロスリージョンのデータ移動はありません
エッジの経路
Cloudflare Worker(deploy/cloudflare/edge-router.js)は、上流呼び出しの前に org_id から home_region を解決します。
- 認証ヘッダ → API キー → org_id の検索
- 内部 API 呼び出し → home_region と residency_pinned を取得
- home_region ≠ 現在のコロケーション → ピアのゲートウェイへ 307 リダイレクト
- 固定されており、かつリージョンがダウン → 503
連合利用分析
日次のロールアップは、各リージョンから中央の利用分析へ送られます。
- org_id は 8 文字の SHA-256 プレフィックスへハッシュされます(k-匿名性)
- PII もメッセージ内容もありません。件数とトークンの指標だけです
- シッパーは指数バックオフで 3 回再試行します
リージョンごとの KMS
各リージョンは、エンベロープ暗号化用の独自の KMS キーを持ちます。
localプロバイダ: プロセス内の AES-GCM(開発/エアギャップ)awsプロバイダ: AWS KMS(本番)- キーがリージョンをまたいで共有されることはありません
導入
Terraform
cd deploy/terraform/regions/sg && terraform init -backend=false && terraform validate
# Repeat for in/ and eu/ with region-specific data sources
作成後: 各 RDS インスタンスで pgvector を有効にします。
PGHOST=<pg_address> PGUSER=yabanin PGPASSWORD=<pw> psql -d yabanin -c "CREATE EXTENSION IF NOT EXISTS vector;"
Helm
helm upgrade --install yabanin deploy/helm/yabanin/ -f deploy/helm/yabanin/values-sg.yaml
# Repeat for in/eu with their respective values files
マイグレーションランナー
YABANIN_REGION=sg YABANIN_PG_URI="postgres://..." go run cmd/yabanin-migrate/main.go migrations/
# Sets app.region GUC before applying each migration for RLS backfill
設定(config.yaml)
gateway:
region: sg
home_region: SG
kms_provider: local
regions:
sg: { name: sg, country: SG, pg_uri: "...", redis_addr: "...", priority: 1 }
in: { name: in, country: IN, pg_uri: "...", redis_addr: "...", priority: 2 }
eu: { name: eu, country: DE, pg_uri: "...", redis_addr: "...", priority: 3 }
カオスドリル
./scripts/chaos_drill.sh sg
# Kills SG region, verifies non-pinned orgs failover to IN/EU, pinned orgs get 503
運用手順は docs/runbooks/region-down.md を参照します。