Skip to main content

Pelaksanaan berbilang rantau

Seni bina​

Tiga rantau dilaksanakan secara aktif-aktif: SG (Singapura, utama), IN (India), EU (Frankfurt). Setiap rantau mempunyai Postgres+Redis+KMS sendiri. Data organisasi disematkan pada rantau asal (dikuatkuasakan oleh RLS).

Kontrak penyematan rantau​

  1. Jadual org_home_region memetakan org_id → home_region + bendera residency_pinned

Keselamatan Peringkat Baris pada jadual request_logs, messages, sessions:

  • Setiap sambungan menetapkan GUC app.region melalui cangkuk AfterConnect
  • Dasar RLS: home_region = current_setting('app.region', true)
  • Pertanyaan merentas rantau mengembalikan sifar baris — data tidak pernah meninggalkan rantau asal

Peraturan failover​

  • Organisasi tidak disemat: Apabila rantau asal tidak sihat, halakan ke rakan sebaya sihat terbaik seterusnya (mengikut keutamaan)
  • Organisasi disemat: Kembalikan 503 jika rantau asal terhenti — tiada pergerakan data merentas rantau

Penghalaan pinggir​

Cloudflare Worker (deploy/cloudflare/edge-router.js) menyelesaikan org_id → home_region sebelum panggilan huluan:

  1. Pengepala auth → kunci API → carian org_id
  2. Panggilan API dalaman → dapatkan home_region + residency_pinned
  3. Jika home_region ≠ colo semasa → 307 ubah hala ke gerbang rakan sebaya
  4. Jika disemat + rantau terhenti → 503

Analitik bersekutu​

Gulungan harian dihantar dari setiap rantau ke analitik pusat:

  • org_id dicincang kepada awalan SHA-256 8 aksara (k-anonimiti)
  • Tiada PII, tiada kandungan mesej — hanya kiraan dan metrik token
  • Penghantar mencuba semula 3x dengan undur eksponen

KMS setiap rantau​

Setiap rantau mempunyai kunci KMS sendiri untuk penyulitan sampul:

  • penyedia local: AES-GCM dalam proses (dev/jurang udara)
  • penyedia aws: AWS KMS (pengeluaran)
  • Kunci tidak pernah dikongsi merentas rantau

Pelaksanaan​

Terraform​

cd deploy/terraform/regions/sg && terraform init -backend=false && terraform validate
# Repeat for in/ and eu/ with region-specific data sources

Selepas cipta: dayakan pgvector pada setiap instans RDS:

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

Pelari migrasi​

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

Konfigurasi (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 }

Latih tubi huru-hara​

./scripts/chaos_drill.sh sg
# Kills SG region, verifies non-pinned orgs failover to IN/EU, pinned orgs get 503

Lihat docs/runbooks/region-down.md untuk prosedur operasi.