Architektur
Wie eine Anfrage von Ihrem Kunden zu Postgres gelangt, wie Organisationen und Projekte isoliert sind und wie Dienste skaliert werden.
Ein Backend, acht Dienste#
Aurabase ist ein Rust-Monorepo, das acht Axum-Dienste erstellt. Jeder Dienst verfügt über einen eigenen Port und eigene /v1/<service>/…-Routen, und die Dienste kommunizieren über NATS-Anfragen/Antworten miteinander. Der gesamte Datenverkehr Ihrer Anwendungen läuft über ein Gateway.
Ein Dienst kann neu starten, abstürzen oder eigenständig bereitgestellt werden. Das Gateway überwacht den Zustand jedes Dienstes mit einem Leistungsschalter: Nach 5 Ausfällen innerhalb von 60 Sekunden antwortet es 30 Sekunden lang mit 503 für diesen Dienst und versucht es dann erneut.
Leistungen und Verantwortlichkeiten#
Jeder Dienst besitzt eine Domäne, seine eigenen SQL-Migrationen und seine eigenen Daten. Ihre Anwendungen erreichen sie nur über das Gateway.
| Service | Domäne | Verantwortlichkeiten |
|---|---|---|
aura-gateway | API-Gateway | Proxy, Authentifizierungs-Middleware, Ratenbegrenzung, Leistungsschalter |
aura-auth | Authentifizierung | Registrierung, Anmeldung, OAuth 2.1, TOTP MFA und WebAuthn, Sitzungen, JWKS |
aura-db | Datenbank | CRUD über PostgREST, versionierte Migrationen, Typgenerierung, Schemaverwaltung |
aura-realtime | Echtzeit | WebSocket, SSE, Event Relay, Präsenz, Postgres Änderungsdatenerfassung |
aura-storage | Lagerung | S3-kompatibler Objektspeicher, mehrteiliger Upload, signierte URLs, Bildtransformationen |
aura-functions | Edge Functions | WASM- und Deno-Laufzeiten, Cron, asynchrone Jobwarteschlange, Warteschlange für unzustellbare Nachrichten |
aura-notifications | Benachrichtigungen | Transaktionale E-Mail (SMTP), SMS, mobiler Push, HMAC-signierte Webhooks |
aura-ai | KI-Gateway | LLM-Inferenz über einen Endpunkt, Einbettungen, RAG mit pgvector |
Isolation durch Organisation und Projekt#
Jede Organisation erhält ihren eigenen PostgreSQL-Cluster, der mit CloudNativePG (CNPG) in einem für sie reservierten Kubernetes-Namespace bereitgestellt wird. Zwischen zwei Organisationen wird kein Cluster, Namespace oder Verbindungspool gemeinsam genutzt. Die Kapazität des Clusters (vCPU, Arbeitsspeicher, Replikate) richtet sich nach dem Plan der Organisation.
Innerhalb dieses Clusters erhält jedes Projekt seine eigene Postgres-Datenbank, aufgeteilt in vier Schemas. Jedes Projekt verfügt über eine eigene Verbindungsrolle, die nur Mitglied seiner eigenen Rollen ist. Rechte an den Schemata eines Projekts werden diesen Rollen gewährt und niemals PUBLIC. Das Gateway stellt die Verbindung search_path vom Projekt im JWT des Clients ein und Anwendungstabellen werden durch Sicherheit auf Zeilenebene (RLS) geschützt.
Im Rahmen des Unternehmensangebots kann ein Projekt auch einen dedizierten CNPG-Cluster in seinem eigenen Namensraum erhalten. Die Isolation ergibt sich dann neben den Berechtigungen auch aus der physischen Trennung der Cluster.
| Schema | Besitzer | Inhalt |
|---|---|---|
project_{uuid} | Du | Ihre Anwendungstabellen |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | Plattform | functions, jobs, cron, api_keys, webhooks |
Daraus ergeben sich drei Konsequenzen:
- Kein mandantenübergreifender Zugriff. Zwei Organisationen teilen sich niemals einen Cluster, einen Namespace oder einen Verbindungspool.
- Unabhängige Migrationen. Jedes Projekt wird einzeln migriert und zurückgesetzt.
- Einfacher Export.
pg_dump --schema='project_*'speichert die Daten, Erweiterungen und Richtlinien eines Projekts.
Das Schema aura_console wird gemeinsam genutzt. Es enthält die Tabelle projects und die Studio-Sitzungen. Es werden keine Anwendungsdaten durchlaufen.
Von Curl zu Postgres#
Das Gateway prüft jede Anfrage, bevor es sie weiterleitet. Dies ist der Pfad von GET /v1/db/{projectId}/devices von einem REST-Client:
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
Jeder Schritt schreibt strukturierte Protokolle mit tracing, korreliert durch request_id.
Skalierung#
Dienste sind staatenlos. Um Kapazität hinzuzufügen, starten Sie ein weiteres Replikat der Binärdatei und verbinden Sie es mit NATS. Es tritt dem Cluster bei und bedient Anfragen, wenn es bereit ist. Es gibt keine Führungswahl und keine verteilte Koordination.
Um weiter zu gehen#
- Datenbank
Postgres, Schemata, Migrationen, RLS, TypeScript Typgenerierung
- Auth
OAuth, MFA, Sitzungslebenszyklus, RBAC
- Echtzeit
WebSocket, SSE, Präsenz, Postgres Änderungen
- Lagerung
S3-kompatible Buckets, Transformationen, signierte URLs
- Edge Functions
Laufzeiten WASM und Deno, Cron, Warteschlange für unzustellbare Nachrichten
- Konventionen
Benennung von Schemata, Spalten und RLS-Richtlinien