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

マルチリージョン導入

アーキテクチャ​

3 つのリージョンをアクティブ-アクティブで導入します。SG(シンガポール、プライマリ)、IN(インド)、EU(フランクフルト)です。 各リージョンは独自の Postgres+Redis+KMS を持ちます。組織データはホームリージョンに固定されます(RLS で強制されます)。

リージョン固定の契約​

  1. org_home_region テーブルは、org_id を home_region と residency_pinned フラグへ対応付けます

request_logs、messages、sessions テーブルの行レベルセキュリティ:

  • 各接続は、AfterConnect フックで app.region GUC を設定します
  • RLS の方針: home_region = current_setting('app.region', true)
  • クロスリージョンのクエリは ゼロ行 を返します。データはホームリージョンの外へ出ません

フェイルオーバーの規則​

  • 固定されていない組織: ホームリージョンが不健全なとき、優先度に従い、次に健全なピアへ経路を向けます
  • 固定された組織: ホームリージョンがダウンしている場合は 503 を返します。クロスリージョンのデータ移動はありません

エッジの経路​

Cloudflare Worker(deploy/cloudflare/edge-router.js)は、上流呼び出しの前に org_id から home_region を解決します。

  1. 認証ヘッダ → API キー → org_id の検索
  2. 内部 API 呼び出し → home_region と residency_pinned を取得
  3. home_region ≠ 現在のコロケーション → ピアのゲートウェイへ 307 リダイレクト
  4. 固定されており、かつリージョンがダウン → 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 を参照します。