Mimarlık
Bir isteğin müşterinizden Postgres adresine nasıl gittiği, kuruluşların ve projelerin nasıl izole edildiği ve hizmetlerin nasıl ölçeklendiği.
Bir arka uç, sekiz hizmet#
Aurabase, sekiz Axum hizmeti oluşturan bir Rust monorepo'dur. Her hizmetin kendi bağlantı noktası ve kendi /v1/<service>/… yolları vardır ve hizmetler birbirleriyle NATS istek/yanıt üzerinden konuşur. Uygulamalarınızdaki tüm trafik tek bir ağ geçidinden geçer.
Bir hizmet kendi başına yeniden başlatılabilir, çökebilir veya dağıtılabilir. Ağ geçidi, bir devre kesiciyle her hizmetin durumunu izler: 60 saniye içinde 5 arızadan sonra, o hizmet için 30 saniye boyunca 503 yanıtını verir ve ardından yeniden dener.
Hizmetler ve sorumluluklar#
Her hizmetin bir etki alanı, kendi SQL geçişleri ve kendi verileri vardır. Uygulamalarınız onlara yalnızca ağ geçidi üzerinden ulaşır.
| Hizmet | Etki alanı | Sorumluluklar |
|---|---|---|
aura-gateway | API ağ geçidi | Proxy, kimlik doğrulama ara yazılımı, hız sınırlama, devre kesici |
aura-auth | Kimlik doğrulama | Kaydolma, oturum açma, OAuth 2.1, TOTP MFA ve WebAuthn, oturumlar, JWKS |
aura-db | Veritabanı | PostgREST üzerinden CRUD, sürümlendirilmiş geçişler, tür oluşturma, şema yönetimi |
aura-realtime | Gerçek zamanlı | WebSocket, SSE, olay aktarımı, iletişim durumu, Postgres değişiklik verileri yakalama |
aura-storage | Depolama | S3-uyumlu nesne depolama, çok parçalı yükleme, imzalı URL'ler, görüntü dönüştürmeleri |
aura-functions | Edge Functions | WASM ve Deno çalışma zamanları, cron, eşzamansız iş kuyruğu, atılacak ileti kuyruğu |
aura-notifications | Bildirimler | İşlemsel e-posta (SMTP), SMS, mobil push, HMAC imzalı web kancaları |
aura-ai | Yapay Zeka Ağ Geçidi | Bir uç nokta aracılığıyla LLM çıkarımı, yerleştirmeler, pgvector ile RAG |
Organizasyona ve projeye göre izolasyon#
Her kuruluş, kendisine ayrılmış bir Kubernetes ad alanında CloudNativePG (CNPG) ile sağlanan kendi PostgreSQL kümesini alır. İki kuruluş arasında hiçbir küme, ad alanı veya bağlantı havuzu paylaşılmaz. Kümenin kapasitesi (vCPU, bellek, kopyalar) kuruluşun planına uygundur.
Bu kümenin içinde her proje, dört şemaya bölünmüş kendi Postgres veritabanını alır. Her projenin yalnızca kendi rollerinin üyesi olan kendi bağlantı rolü vardır. Bir projenin şemalarındaki haklar bu rollere verilir, asla PUBLIC'ye verilmez. Ağ geçidi, istemcinin JWT projesinden search_path bağlantısını kurar ve uygulama tabloları satır düzeyinde güvenlik (RLS) tarafından korunur.
Kurumsal teklifte bir proje, kendi ad alanında özel bir CNPG kümesi de alabilir. İzolasyon, izinlere ek olarak kümelerin fiziksel olarak ayrılmasından gelir.
| Şema | Sahip | İçerik |
|---|---|---|
project_{uuid} | sen | Uygulama tablolarınız |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | platformu | functions, jobs, cron, api_keys, webhooks |
Üç sonuç takip ediyor:
- Kiracılar arası erişim yok. İki kuruluş asla bir kümeyi, ad alanını veya bağlantı havuzunu paylaşmaz.
- Bağımsız geçişler. Her proje kendi başına taşınır ve geri alınır.
- Düz dışa aktarma.
pg_dump --schema='project_*'bir projenin verilerini, uzantılarını ve politikalarını döker.
aura_console şeması paylaşılıyor. projects tablosunu ve Studio oturumlarını tutar. Üzerinden hiçbir uygulama verisi geçmez.
Kıvrılmadan Postgres'ye#
Ağ geçidi, yönlendirmeden önce her isteği kontrol eder. Bu, bir REST istemcisinden gelen GET /v1/db/{projectId}/devices yoludur:
1. TLS termination client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit token bucket, answers 429 when the limit is reached
4. Authentication JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker the target service is HEALTHY, so the request goes through
6. Execution search_path set to the project's schemas, then the query runs under RLS
Her adım, tracing ile ilişkilendirilen request_id ile yapılandırılmış günlükler yazar.
Ölçekleme#
Hizmetler vatansızdır. Kapasite eklemek için ikili dosyanın başka bir kopyasını başlatın ve onu NATS öğesine bağlayın. Kümeye katılır ve hazır olduğunda istekleri yerine getirir. Lider seçimi ve dağıtılmış koordinasyon yoktur.
Daha ileri gitmek için#
- Veritabanı
Postgres, şemalar, geçişler, RLS, TypeScript tür oluşturma
- Yetki
OAuth, MFA, oturum yaşam döngüsü, RBAC
- Gerçek zamanlı
WebSocket, SSE, iletişim durumu, Postgres değişiklikleri
- Depolama
S3-uyumlu paketler, dönüşümler, imzalı URL'ler
- Edge Functions
WASM ve Deno çalışma zamanları, cron, atılacak ileti kuyruğu
- Sözleşmeler
Şemaların, sütunların ve RLS politikalarının adlandırılması