Vai al contenuto
Logo Aurabase
aurabase

Architettura

Il modo in cui una richiesta viaggia dal tuo cliente a Postgres, il modo in cui le organizzazioni e i progetti vengono isolati e la scalabilità dei servizi.

Spiegazione7 min lettoLivello intermedioRevisionato il 4 nov 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Un backend, otto servizi#

Aurabase è un monorepo Rust che crea otto servizi Axum. Ogni servizio ha la propria porta e le proprie rotte /v1/<service>/… e i servizi comunicano tra loro tramite richiesta/risposta NATS. Tutto il traffico proveniente dalle tue applicazioni passa attraverso un gateway.

Un servizio può riavviarsi, bloccarsi o essere distribuito da solo. Il gateway tiene traccia dello stato di ciascun servizio con un interruttore automatico: dopo 5 errori entro 60 secondi, risponde 503 per quel servizio per 30 secondi, quindi riprova.

Servizi e responsabilità#

Ogni servizio possiede un dominio, le proprie migrazioni SQL e i propri dati. Le tue applicazioni li raggiungono solo attraverso il gateway.

ServizioDominioResponsabilità
aura-gatewayPortale APIProxy, middleware di autenticazione, limitazione della velocità, interruttore automatico
aura-authAutenticazioneRegistrazione, accesso, OAuth 2.1, TOTP MFA e WebAuthn, sessioni, JWKS
aura-dbBanca datiCRUD su PostgREST, migrazioni con versione, generazione di tipi, gestione dello schema
aura-realtimeIn tempo realeWebSocket, SSE, inoltro eventi, presenza, Postgres modifica acquisizione dati
aura-storageStoccaggioS3-archiviazione di oggetti compatibile, caricamento in più parti, URL firmati, trasformazioni di immagini
aura-functionsEdge FunctionsRuntime WASM e Deno, cron, coda lavori asincroni, coda messaggi non recapitabili
aura-notificationsNotificheE-mail transazionale (SMTP), SMS, push mobile, webhook firmati HMAC
aura-aiPortale AIInferenza LLM tramite un endpoint, incorporamenti, RAG con pgvector

Isolamento per organizzazione e progetto#

Ogni organizzazione ottiene il proprio cluster PostgreSQL, fornito con CloudNativePG (CNPG) in uno spazio dei nomi Kubernetes ad esso riservato. Nessun cluster, spazio dei nomi o pool di connessioni è condiviso tra due organizzazioni. La capacità del cluster (vCPU, memoria, repliche) segue il piano dell'organizzazione.

All'interno di quel cluster, ogni progetto ottiene il proprio database Postgres, suddiviso in quattro schemi. Ogni progetto ha il proprio ruolo di connessione, che è membro solo dei propri ruoli. I diritti sugli schemi di un progetto vengono concessi a tali ruoli e mai a PUBLIC. Il gateway imposta la connessione search_path dal progetto nell' JWT del client e le tabelle dell'applicazione sono protette dalla sicurezza a livello di riga (RLS).

Nell'offerta aziendale, un progetto può anche ottenere un cluster CNPG dedicato nel proprio spazio dei nomi. L'isolamento deriva quindi dalla separazione fisica dei cluster, oltre alle autorizzazioni.

SchemaProprietarioContenuto
project_{uuid}tuLe tue tabelle applicative
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformpiattaformafunctions, jobs, cron, api_keys, webhooks

Ne conseguono tre conseguenze:

  • Nessun accesso tra tenant. Due organizzazioni non condividono mai un cluster, uno spazio dei nomi o un pool di connessioni.
  • Migrazioni indipendenti. Ogni progetto viene migrato e ripristinato autonomamente.
  • Esportazione normale. pg_dump --schema='project_*' scarica i dati, le estensioni e le policy di un progetto.
Schema condiviso

Lo schema aura_console è condiviso. Contiene la tabella projects e le sessioni Studio. Nessun dato dell'applicazione lo attraversa.

Dall'arricciatura a Postgres#

Il gateway controlla ogni richiesta prima di instradarla. Questo è il percorso di GET /v1/db/{projectId}/devices da un client REST:

percorso della richiestatext
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

Ogni passaggio scrive log strutturati con tracing, correlati da request_id.

Ridimensionamento#

I servizi sono apolidi. Per aggiungere capacità, avvia un'altra replica del binario e connettila a NATS. Si unisce al cluster e serve le richieste quando è pronto. Non vi è alcuna elezione del leader e nessun coordinamento distribuito.

Per andare oltre#