Przejdź do treści
Logo Aurabase
aurabaza

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.

Objaśnienie7 min przeczytanePoziom mediatorZmieniono 4 lis 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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ę.

PracaDomenaObowiązki
aura-gatewayBrama APISerwer proxy, oprogramowanie pośredniczące do uwierzytelniania, ograniczanie szybkości, wyłącznik automatyczny
aura-authUwierzytelnianieRejestracja, logowanie, OAuth 2.1, TOTP MFA i WebAuthn, sesje, JWKS
aura-dbBaza danychCRUD przez PostgREST, migracje wersjonowane, generowanie typów, zarządzanie schematami
aura-realtimeW czasie rzeczywistymWebSocket, SSE, przekaźnik zdarzeń, obecność, Postgres zmiana przechwytywania danych
aura-storageSkładowanieS3-kompatybilna pamięć obiektów, przesyłanie wieloczęściowe, podpisane adresy URL, transformacje obrazów
aura-functionsEdge FunctionsŚrodowiska wykonawcze WASM i Deno, cron, asynchroniczna kolejka zadań, kolejka niedostarczonych wiadomości
aura-notificationsPowiadomieniaE-mail transakcyjny (SMTP), SMS, push mobilny, HMAC-podpisane webhooki
aura-aiBrama AIWnioskowanie 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ń.

SchematWłaścicielTreść
project_{uuid}TyTwoje tabele aplikacji
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformplatformafunctions, 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.
Udostępniony schemat

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:

ścieżka żądaniatext
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#