Architektura
Jak żądanie jest przesyłane od klienta do Postgres, w jaki sposób organizacje i projekty są izolowane oraz w jaki sposób skaluje się usługi.
Jeden backend, osiem usług#
Aurabase to monorepo Rust, które tworzy osiem usług Axum. Każda usługa ma swój własny port i własne trasy /v1/<service>/…, a usługi komunikują się ze sobą za pośrednictwem żądania/odpowiedzi NATS. Cały ruch z aplikacji przechodzi przez jedną bramę.
Usługa może zostać ponownie uruchomiona, ulec awarii lub zostać wdrożona samodzielnie. Brama śledzi stan każdej usługi za pomocą wyłącznika automatycznego: po 5 awariach w ciągu 60 sekund odpowiada 503 dla tej usługi przez 30 sekund, a następnie próbuje ponownie.
Usługi i obowiązki#
Każda usługa posiada jedną domenę, własne migracje SQL i własne dane. Twoje aplikacje docierają do nich tylko przez bramę.
| Praca | Domena | Obowiązki |
|---|---|---|
aura-gateway | Brama API | Serwer proxy, oprogramowanie pośredniczące do uwierzytelniania, ograniczanie szybkości, wyłącznik automatyczny |
aura-auth | Uwierzytelnianie | Rejestracja, logowanie, OAuth 2.1, TOTP MFA i WebAuthn, sesje, JWKS |
aura-db | Baza danych | CRUD przez PostgREST, migracje wersjonowane, generowanie typów, zarządzanie schematami |
aura-realtime | W czasie rzeczywistym | WebSocket, SSE, przekaźnik zdarzeń, obecność, Postgres zmiana przechwytywania danych |
aura-storage | Składowanie | S3-kompatybilna pamięć obiektów, przesyłanie wieloczęściowe, podpisane adresy URL, transformacje obrazów |
aura-functions | Edge Functions | Środowiska wykonawcze WASM i Deno, cron, asynchroniczna kolejka zadań, kolejka niedostarczonych wiadomości |
aura-notifications | Powiadomienia | E-mail transakcyjny (SMTP), SMS, push mobilny, HMAC-podpisane webhooki |
aura-ai | Brama AI | Wnioskowanie LLM przez jeden punkt końcowy, osadzanie, RAG z pgvector |
Izolacja według organizacji i projektu#
Każda organizacja otrzymuje własny klaster PostgreSQL z obsługą CloudNativePG (CNPG) w zarezerwowanej dla niej przestrzeni nazw Kubernetes. Żaden klaster, przestrzeń nazw ani pula połączeń nie jest współdzielona pomiędzy dwiema organizacjami. Pojemność klastra (vCPU, pamięć, repliki) jest zgodna z planem organizacji.
Wewnątrz tego klastra każdy projekt otrzymuje własną bazę danych Postgres podzieloną na cztery schematy. Każdy projekt ma swoją własną rolę połączenia, która jest członkiem tylko swoich własnych ról. Prawa do schematów projektu są przyznawane tym rolom, a nigdy PUBLIC. Brama ustawia połączenie search_path z projektu w JWT klienta, a tabele aplikacji są chronione przez zabezpieczenia na poziomie wiersza (RLS).
W ofercie Enterprise projekt może także otrzymać dedykowany klaster CNPG we własnej przestrzeni nazw. Izolacja polega wówczas na fizycznym oddzieleniu klastrów, oprócz uprawnień.
| Schemat | Właściciel | Treść |
|---|---|---|
project_{uuid} | Ty | Twoje tabele aplikacji |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | platforma | functions, jobs, cron, api_keys, webhooks |
Następują trzy konsekwencje:
- Brak dostępu między dzierżawcami. Dwie organizacje nigdy nie dzielą klastra, przestrzeni nazw ani puli połączeń.
- Niezależne migracje. Każdy projekt migruje i wycofuje się samodzielnie.
- Zwykły eksport.
pg_dump --schema='project_*'zrzuca dane projektu, rozszerzenia i zasady.
Schemat aura_console jest udostępniony. Zawiera tabelę projects i sesje Studio. Nie przechodzą przez nią żadne dane aplikacji.
Od zawinięcia do Postgres#
Brama sprawdza każde żądanie przed jego skierowaniem. To jest ścieżka GET /v1/db/{projectId}/devices z klienta REST:
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
W każdym kroku zapisywane są dzienniki strukturalne z tracing skorelowane przez request_id.
Ułuskowienie#
Usługi są bezpaństwowe. Aby zwiększyć pojemność, uruchom kolejną replikę pliku binarnego i podłącz ją do NATS. Dołącza do klastra i obsługuje żądania, gdy jest gotowe. Nie ma wyboru lidera ani rozproszonej koordynacji.
Aby pójść dalej#
- Baza danych
Postgres, schematy, migracje, RLS, TypeScript generacja typów
- Autoryt
OAuth, MFA, cykl życia sesji, RBAC
- W czasie rzeczywistym
WebSocket, SSE, obecność, zmiany Postgres
- Składowanie
S3- kompatybilne segmenty, transformacje, podpisane adresy URL
- Edge Functions
Środowiska wykonawcze WASM i Deno, cron, kolejka utraconych wiadomości
- Konwencje
Nazewnictwo schematów, kolumn i polityk RLS