Vai al contenuto
Logo Aurabase
aurabase

CLI aura: riferimento completo

Il binario ufficiale aura ti consente di controllare l'intera piattaforma Aurabase: sviluppo locale, Kubernetes, migrazioni SQL, funzioni archiviate, Edge Functions WASM, RLS, archiviazione e autenticazione.

Riferimento12 min lettoLivello riferimentoRevisionato il 19 ago 2026

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

Un binario autonomo, disponibile ovunque#

La CLI è un binario Rust autonomo. Viene installato oggi da NPM su macOS Apple Silicon e tramite compilazione da fonti ovunque. I pacchetti binari precompilati per Linux, macOS Intel e Windows non sono ancora stati rilasciati: npm install -g @aurabase/cli fallisce lì, non è un tuo errore.

terminalbash
# 1. NPM: macOS Apple Silicon solo da oggi
npm install -g @aurabase/cli
aura --help

# 2. Dall'origine: tutte le piattaforme (Rust 1.7x+)
git clone https://github.com/Aurabase-cloud/Aurabase.git
cargo install --path Aurabase/aura-cli
#    installa il binario `aurabase` in ~/.cargo/bin
aurabase --help

Autenticare la CLI#

Puoi accedere con il tuo account della console o utilizzando un token di accesso personale per le tue pipeline CI/CD:

terminalbash
# Accesso interattivo (apre il browser)
aura login

# Connessione non interattiva (email/password)
aura login --email dev@example.com --password "secret"

# Connessione tramite token di accesso personale (ideale per azioni GitHub / GitLab CI)
aura login --token aura_pat_9a8b7c6d5e4f...

# Controlla l'account e il progetto attivo
aura whoami

Riferimento esaustivo per modulo#

Trova tutti i comandi e sottocomandi supportati dal binario aura:

Impostazione e gestione del progetto

Inizializzazione, connessione e diagnosi del progetto

  • aura init — Inizializza un nuovo progetto Aurabase (struttura, configurazione, finestra mobile)
  • aura login [--email <email>] [--password <pass>] [--token <pat>]: accede all'account della console o con un token di accesso personale
  • aura register [--email <email>] [--password <pass>]: crea un nuovo account sviluppatore della console Aurabase
  • aura logout — Disconnette la sessione locale attiva
  • aura whoami: mostra l'utente che ha effettuato l'accesso, la sua organizzazione e il progetto attivo
  • aura link --project-id <uuid>: collega la directory corrente a un progetto cloud esistente
  • aura status — Mostra lo stato del progetto, la connessione e lo stato del servizio
  • aura doctor — Diagnostica l'ambiente locale (Docker, porte, strumenti di sistema)

Sviluppo locale

Gestione stack locale (Kubernetes/k3d) e log

  • aura start: avvia tutti i microservizi locali Aurabase su k3d
  • aura stop — Arresta il cluster k3d e i servizi locali
  • aura restart — Riavvia i servizi locali
  • aura dev — Modalità di sviluppo continua: monitora le migrazioni e sincronizza i tipi
  • aura studio — Apre l'interfaccia locale di Studio nel tuo browser (localhost:3000)
  • aura logs [-s <service>] [--since 1h] [--tail 100] — Visualizza i log unificati o filtrati per servizio (aura-auth, aura-db, gateway...)
  • aura connect — Apre un terminale psql interattivo sull'endpoint diretto PostgreSQL del progetto (psql richiede la password emessa da aura db connection --new-password)

Organizzazioni e progetti cloud

Gestione multi-tenant di organizzazioni e progetti

  • aura orgs list [--json] — Elenca le organizzazioni di cui sei membro
  • aura orgs create --name <name> --slug <slug>: crea una nuova organizzazione cloud
  • aura orgs use <slug> — Imposta l'organizzazione predefinita per gli ordini
  • aura projects list [--org <slug>] [--json]: elenca i progetti di un'organizzazione
  • aura projects create <name> [--engine postgres|mongodb] [--org <slug>] — Effettua il provisioning di un nuovo progetto
  • aura projects delete <id> — Elimina permanentemente un progetto e i relativi dati
  • aura projects api-keys [--project-id <id>] — Mostra le chiavi API del progetto (anon, service_role)
  • aura projects rename <id> <name> — Rinomina un progetto esistente
  • aura projects retry <id> — Esegue nuovamente il provisioning di un progetto in error e stampa l'URL e le chiavi una volta pronto
  • aura projects graphql-enable <id> [--wait] — Abilita l'estensione GraphQL (pg_graphql) sul progetto
  • aura projects graphql-config <id> [--introspection on|off] [--max-rows N] [--inflect-names on|off] [--wait] — Mostra o modifica le impostazioni pg_graphql (senza flag, stampa le impostazioni effettive)

Rami del database (ramo aura)

Un ramo è un nuovo progetto clonato da un progetto PostgreSQL, con il proprio URL e chiavi, eliminato al termine del suo TTL. Vedi rami del database per i limiti e cosa viene clonato.

  • aura branch create <name> [--from <project id|slug|name>] [--org <slug>] [--ttl 72h|3d|2w] [--no-data] [--no-wait] [--json] [--timeout <s>] — Crea un ramo del progetto collegato (o di --from), attende finché non è pronto, quindi stampa una volta il suo URL e le sue chiavi API. --ttl va da 1h a 30d (default 72h). --no-data copia solo lo schema
  • aura branch list [--from <project>] [--all] [--json] — Elenca i rami di un progetto, o dell'intera organizzazione con --all; le filiali fallite rimangono elencate per 24 ore con il loro motivo
  • aura branch delete <name> [--from <project>] [--force] — Elimina un ramo e il relativo database

Database e migrazioni (aura db)

Gestione di schemi, sincronizzazione, push/pull e query SQL

  • aura db push: applica le migrazioni SQL locali in sospeso (+ sincronizzazione cloud se collegata)
  • aura db pull — Recupera lo schema remoto e aggiorna lo schema locale
  • aura db diff [--name <name>]: confronta lo schema remoto con quello locale e genera la migrazione SQL
  • aura db status [--json]: mostra lo stato dettagliato delle migrazioni applicate e in sospeso
  • aura db watch: monitora le modifiche allo schema e esegue la sincronizzazione in tempo reale
  • aura db reset [--force] — Elimina e ricrea da zero il database locale (chiede conferma; --force per gli script)
  • aura db seed — Esegue lo script seed.sql per caricare i dati di test
  • aura db generate [--lang ts|rust] — Genera TypeScript (predefinito) o Rust definizioni del tipo di database
  • aura db extensions list [--json] / aura db extensions enable <name> — Elenca le estensioni installate o ne abilita una consentita
  • aura db inspect <indexes|tables|locks> [--json] — Utilizzo dell'indice (quelli non utilizzati contrassegnati), dimensioni della tabella e righe morte, blocchi di blocco
  • aura db slow-queries [--limit <n>] [--json] — Elenca le query SQL più lente tramite pg_stat_statements
  • aura db stats [--json]: mostra le statistiche di connessione e l'utilizzo del disco del database
  • aura db connection [--new-password] [--yes] [--json] — Accesso diretto PostgreSQL (psql, Prisma, Drizzle, pg_dump): host, porta, database e ruolo; con --new-password, emette una password (mostrata una volta, mai memorizzata in chiaro, revoca la precedente) e stampa la stringa di connessione completa
  • aura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json] — Esegue una query SQL diretta con opzioni di simulazione e di sola lettura
  • aura db migration new <name>: crea un nuovo file di migrazione SQL con timestamp
  • aura db migration list [--json] — Elenca tutte le migrazioni del progetto e il relativo stato
  • aura db migration down [n] — Annulla le ultime n migrazioni applicate (impostazione predefinita: 1)
  • aura db migration repair <file> [--applied|--reverted] — Contrassegna manualmente una migrazione come applicata o annullata nella cronologia di migrazione del progetto (la stessa cronologia aura db status e migration list letta)

RLS tabelle e policy (tabella/policy aura db)

Creazione dichiarativa, RLS, CDC in tempo reale e autorizzazioni

  • aura db table list [--json] — Elenca le tabelle dello schema pubblico con le relative colonne e tipi
  • aura db table create <name> "<cols>" — Crea una tabella (es: "titolo:testo,tags:testo[],embedding:vettore(1536)")
  • aura db table drop <name> [-f] — Elimina una tabella e i relativi vincoli
  • aura db table rls <name> <on|off> — Abilita o disabilita la protezione di sicurezza a livello di riga su una tabella
  • aura db table realtime <name> <on|off> — Abilita o disabilita la pubblicazione in tempo reale CDC su una tabella
  • aura db policy list [--table <name>] [--all] [--json] — Elenca le policy di sicurezza RLS definite sulle tabelle (--all include le regole di archiviazione interna)
  • aura db policy add <table> <name> <cmd> [--using-expr <expr>] [--check-expr <expr>]: crea una nuova policy RLS (SELECT, INSERT, UPDATE, DELETE o ALL)
  • aura db policy update <table> <name> [--using-expr <expr>] [--check-expr <expr>] — Modifica le espressioni USING / WITH CHECK di una regola senza interruzioni
  • aura db policy delete <table> <name> [-f]: elimina una regola di sicurezza RLS

Postgres Funzioni e trigger SQL (funzione/trigger db aura)

Procedure memorizzate PL/pgSQL e trigger di tabella

  • aura db function list [--json] — Elenca le funzioni Postgres nello schema (nome, argomenti, sicurezza, diritti)
  • aura db function create <name> [--body <sql>|--body-file <f>] [--returns <t>] [--language plpgsql|sql] [--args <a:t>] [--security invoker|definer] [--grant-execute-to <roles>] — Crea o sostituisce una funzione SQL memorizzata con un rigoroso controllo di accesso
  • aura db function drop <name> [-f] — Elimina una funzione SQL Postgres
  • aura db trigger list <table> [--json] — Elenca tutti i trigger in una tabella
  • aura db trigger create <table> <name> --function <fn> [--timing before|after|instead_of] --events insert,update [--for-each row|statement] — Associa una funzione trigger agli eventi della tabella
  • aura db trigger drop <table> <name> [-f] — Elimina un trigger su una tabella

Backup e chiavi API (backup aura db/chiavi API)

Snapshots, ripristino e gestione dei token di accesso

  • aura db backup list [--json] — Elenca i backup manuali e automatici del database
  • aura db backup create [--label <label>] — Genera uno snapshot immediato del database
  • aura db backup restore <id> [--verify-only] [--yes] — --yes (o --force) salta la conferma, richiesta negli script e CI; Ripristina un database da uno snapshot specificato
  • aura db backup download <id> [-o <path>]: scarica il dump SQL completo di un backup
  • aura db backup delete <id> [-f] — Elimina un archivio di backup
  • aura db backup schedule get [--json] — Consulta la pianificazione del backup automatico configurato
  • aura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable] — Configura la frequenza e la durata di conservazione dei backup
  • aura db apikeys list [--json] — Elenca le chiavi API attive associate al progetto
  • aura db apikeys create <name> [--scope anon|authenticated|service_role] — Genera una nuova chiave API con un ruolo specifico
  • aura db apikeys revoke <id> [-f] — Revoca immediatamente una chiave API

Autenticazione e utenti (aura auth)

Gestione di account, sessioni, registri di controllo e modelli di posta elettronica

  • aura auth users list [--json] — Elenca gli utenti registrati nel progetto
  • aura auth users create [--email <email>] [--password <pass>] [--json] — Crea un nuovo utente con password (--json stampa l'utente creato, con il suo id, per gli script)
  • aura auth users delete <id> [-f]: elimina definitivamente un utente
  • aura auth users ban <id> — Esclude un utente e revoca le sue sessioni attive
  • aura auth users unban <id>: sblocca un utente
  • aura auth sessions list [--json] — Elenca le sessioni JWT attive
  • aura auth audit-log [--limit 50] [--json]: visualizza i registri di controllo della sicurezza e i tentativi di connessione
  • aura auth settings get [--json] — Visualizza la configurazione di autenticazione (OAuth, MFA, timeout)
  • aura auth settings set KEY=VALUE... — Aggiorna le impostazioni di autenticazione
  • aura auth email-templates list [--json]: elenca i modelli di email (conferma, ripristino, collegamento magico)
  • aura auth email-templates get <type> — Visualizza il codice sorgente HTML/testo di un modello
  • aura auth email-templates reset <type> [-f] — Reimposta un modello sui valori predefiniti

Funzioni Edge WASM e segreti (funzioni/segreti dell'aura)

Distribuzione di funzionalità Edge e variabili di ambiente crittografate

  • aura functions new <name> — Genera lo scheletro di una nuova funzione Edge
  • aura functions deploy <name> — Compila il binario WASM e distribuisce la funzione sulla rete globale
  • aura functions list [--json] — Elenca le funzioni locali e distribuite con il relativo stato
  • aura functions logs <name> — Visualizza il flusso di log in tempo reale di una funzione
  • aura functions serve — Avvia il server di test locale per le funzioni
  • aura functions invoke <name> [--data '<json>'] — Richiama e testa una funzione distribuita con un payload
  • aura functions download <name> — Scarica il codice sorgente di una funzione remota
  • aura functions delete <name> [-f]: elimina una funzione Edge distribuita
  • aura secrets list --function <name> [--json] — Elenca le variabili segrete configurate per una funzione
  • aura secrets set --function <name> KEY=VALUE... — Definisce i segreti crittografati inseriti nella funzione
  • aura secrets unset --function <name> KEY... — Rimuove uno o più segreti da una funzione

Archiviazione di oggetti (archiviazione dell'aura)

Gestione dei bucket e trasferimento dei file

  • aura storage ls [path] — Elenca i bucket o i file in una cartella
  • aura storage cp <src> <dst> — Trasferisci file (locale ↔ bucket)
  • aura storage rm <path> — Elimina un file archiviato in un bucket
  • aura storage mb <name> [--public] — Crea un nuovo bucket (privato per impostazione predefinita o pubblico)
  • aura storage buckets list [--json] — Elenca tutti i bucket di archiviazione nel progetto
  • aura storage buckets create <name> [--public] — Crea un bucket di archiviazione
  • aura storage buckets delete <name> [-f] — Elimina un bucket ed elimina tutti i suoi oggetti

Ambiente locale e servizi pubblici

Variabili .env, interfaccia TUI, aggiornamento automatico e completamento automatico

  • aura env list [--json] — Mostra le variabili definite nel file .env locale
  • aura env set KEY=VALUE... — Imposta una o più variabili nel file .env locale
  • aura env unset KEY... — Rimuove le variabili dal file .env locale
  • aura ui: avvia la TUI interattiva completa (interfaccia utente terminale)
  • aura update — Controlla e aggiorna automaticamente la CLI all'ultima versione stabile
  • aura completions <bash|zsh|fish|powershell|elvish> — Genera script di completamento automatico per la tua shell

Interfaccia interattiva nel terminale#

Aurabase integra un'interfaccia in modalità testo (aura ui) alimentata da Ratatui. Ti consente di navigare nei tuoi database, eseguire SQL, ispezionare tabelle e seguire i log senza lasciare il terminale.

terminalbash
# Avvia l'interfaccia TUI
aura ui

Opzioni e impostazioni globali#

  • --json — Output JSON strutturato (ideale per scripting, jq e automazione CI/CD)
  • --dry-run — Esegue il comando in una transazione sottoposta a rollback alla fine per convalidare i vincoli senza modificare i dati
  • --read-only: blocca la transazione in sola lettura sul motore Postgres
  • -f, --force — Ignora le richieste di conferma interattive per operazioni distruttive
  • --project-id <uuid> — Prende di mira un progetto remoto specifico, ignorando il file di collegamento locale
Suggerimento

Abilita il completamento automatico nella shell per eseguire automaticamente i comandi di tabulazione:
aura completions zsh > ~/.zfunc/_aura o aura completions bash > /etc/bash_completion.d/aura.

Per andare oltre#