Vai al contenuto
Logo Aurabase
aurabase

Gestione del progetto

Tutto ciò che circonda un progetto Aurabase: creazione, regioni, team, ruoli, chiavi API, monitoraggio, fatturazione. Un progetto = un database Postgres dedicato sul cluster della tua organizzazione + uno spazio dei nomi completo.

Spiegazione6 min lettoLivello principianteRevisionato il 15 apr 2026

La fonte inglese è cambiata da questa traduzione. Alcune informazioni potrebbero non essere aggiornate.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Un progetto, uno spazio dei nomi completo#

Un progetto Aurabase prevede: un database PostgreSQL dedicato con quattro sottoschemi (ospitato sul cluster CNPG della tua organizzazione o su un cluster interamente dedicato al progetto nell'offerta aziendale), una coppia di chiavi API (anon + service_role), un identificatore UUID che funge da prefisso per tutti i suoi percorsi (/v1/<service>/{project_id} — non esiste un dominio per progetto), un bucket di archiviazione predefinito, un ambito per le funzioni edge e un budget.

La fatturazione è a consumo nel piano Pro, a tariffa fissa nel piano Enterprise. Un progetto può essere sospeso (le risorse rimangono allocate, non fatturate) o eliminato (i dati vengono eliminati entro 30 giorni).

Crea un progetto#

Dalla console (console.aurabase.cloud): un nome e un motore di database. La regione è quella dichiarata dalla distribuzione per il cluster di database, l'unica disponibile, mostrata nel modulo, e il piano è quello della tua organizzazione. Provisioning impiega da 45 secondi a 1,5 minuti (misurato: circa 45 s quando viene creato il cluster dell'organizzazione, circa 90 s con la CLI, che attende che il progetto sia attivo) — base creata sul cluster PostgreSQL dell'organizzazione (o cluster dedicato fornito al volo sull'offerta aziendale), schemi inizializzati, chiavi generate, tipi TypeScript pregenerati. Quando elimini l'ultimo progetto di un'organizzazione, il suo cluster viene eliminato immediatamente; il progetto successivo ne crea uno nuovo.

clibash
# Alternativa CLI (non interattiva)
aura projects create my-saas --org <org-slug>

# Chiavi API del progetto (collegate in aurabase.toml o --project-id)
aura projects api-keys --project-id <project-uuid>
Suggerimento

Le chiavi vengono visualizzate solo una volta al momento della creazione. Possono essere rigenerati (i vecchi invalidati immediatamente) dallo Studio o tramite Settings › Connection.

8 regioni GA · Parigi per impostazione predefinita#

Il tuo progetto è bloccato nella sua regione di creazione. Dati, backup, repliche e cache CDN rimangono in questa regione. Il cambio di regione comporta una migrazione assistita dal nostro team (contatta migrate@aurabase.cloud).

  • fr-par — Paris · Scaleway (FR)
  • de-fsn — Falkenstein / Nürnberg · Hetzner (DE)
  • fi-hel — Helsinki · Hetzner (FI)
Informazioni

Solo Enterprise: vincolo a livello nazionale, impegno contrattuale. Non è stata ancora confermata alcuna certificazione di terze parti (SecNumCloud FR, C5 DE): roadmap pubblica sul nostro Trust Center.

Quattro ruoli predefiniti, RBAC personalizzato disponibile#

Ogni progetto ha un owner univoco (il creatore predefinito, trasferibile). Oltre a ciò, inviti membri con un ruolo predefinito o un ruolo personalizzato definito tramite policy.

RuoloAutorizzazioniMassimo per progetto
ownerGestione completa, fatturazione, eliminazione progetti1
adminGestione del team, politiche, implementazioni; nessuna fatturazioneIllimitato
developerLeggere e scrivere tabelle, funzioni e migrazioniIllimitato
viewerAccesso in sola lettura a dati e registri; nessun segretoIllimitato
Attenzione

A viewer non vede mai i segreti o i valori di service_role_key. I log di controllo registrano ogni accesso alle risorse sensibili per 30 giorni (2 anni su Enterprise).

Anon, service_role, JWT personalizzato#

Tre tipi di chiavi. Usa quello giusto per la superficie giusta.

ChiaveVisibilitàUtilizzare
anon_keyPubblicoPacchetti client e app mobili. Si applica RLS e le affermazioni sono anon.
service_role_keySegretoSolo back-end. Ignora RLS. Non spedirlo mai in codice cliente.
user_jwtSessioneEmesso da aura-auth dopo l'accesso. Scade dopo 15 minuti e ruota automaticamente.

Metriche in tempo reale + quote#

Lo Studio espone parametri in tempo reale su ciascun servizio: richieste/sec, latenza p50/p99, connessioni attive, tasso di errore, utilizzo/uscita dello storage. Esporta in Datadog, Grafana Cloud, Honeycomb tramite webhook o endpoint Prometheus.

  • RICHIESTA DB/S: 1 240 (media 5 minuti)
  • P99 LEGGI: 8 ms (seleziona gli ultimi 100)
  • STOCCAGGIO: 4,2GB (100 GB · Piano Pro)
  • BORDO INV: 48k (questo mese · Quota 5 milioni)

Per andare oltre#