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
- Jadual
org_home_regionmemetakan org_id → home_region + bendera residency_pinned
Keselamatan Peringkat Baris pada jadual request_logs, messages, sessions:
- Setiap sambungan menetapkan GUC
app.regionmelalui 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:
- Pengepala auth → kunci API → carian org_id
- Panggilan API dalaman → dapatkan home_region + residency_pinned
- Jika home_region ≠ colo semasa → 307 ubah hala ke gerbang rakan sebaya
- 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.