Zum Inhalt springen
Aurabase-Logo
Aurabasis

Architektur

Wie eine Anfrage von Ihrem Kunden zu Postgres gelangt, wie Organisationen und Projekte isoliert sind und wie Dienste skaliert werden.

Erklärung7 Min. gelesenEbene MittelstufeÜberarbeitet am 04.11.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

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.

ServiceDomäneVerantwortlichkeiten
aura-gatewayAPI-GatewayProxy, Authentifizierungs-Middleware, Ratenbegrenzung, Leistungsschalter
aura-authAuthentifizierungRegistrierung, Anmeldung, OAuth 2.1, TOTP MFA und WebAuthn, Sitzungen, JWKS
aura-dbDatenbankCRUD über PostgREST, versionierte Migrationen, Typgenerierung, Schemaverwaltung
aura-realtimeEchtzeitWebSocket, SSE, Event Relay, Präsenz, Postgres Änderungsdatenerfassung
aura-storageLagerungS3-kompatibler Objektspeicher, mehrteiliger Upload, signierte URLs, Bildtransformationen
aura-functionsEdge FunctionsWASM- und Deno-Laufzeiten, Cron, asynchrone Jobwarteschlange, Warteschlange für unzustellbare Nachrichten
aura-notificationsBenachrichtigungenTransaktionale E-Mail (SMTP), SMS, mobiler Push, HMAC-signierte Webhooks
aura-aiKI-GatewayLLM-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.

SchemaBesitzerInhalt
project_{uuid}DuIhre Anwendungstabellen
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformPlattformfunctions, 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.
Geteiltes Schema

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:

Anforderungspfadtext
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#