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.
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.
# 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:
# 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 personaleaura register [--email <email>] [--password <pass>]: crea un nuovo account sviluppatore della console Aurabaseaura logout— Disconnette la sessione locale attivaaura whoami: mostra l'utente che ha effettuato l'accesso, la sua organizzazione e il progetto attivoaura link --project-id <uuid>: collega la directory corrente a un progetto cloud esistenteaura status— Mostra lo stato del progetto, la connessione e lo stato del servizioaura 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 k3daura stop— Arresta il cluster k3d e i servizi localiaura restart— Riavvia i servizi localiaura dev— Modalità di sviluppo continua: monitora le migrazioni e sincronizza i tipiaura 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 daaura 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 membroaura orgs create --name <name> --slug <slug>: crea una nuova organizzazione cloudaura orgs use <slug>— Imposta l'organizzazione predefinita per gli ordiniaura projects list [--org <slug>] [--json]: elenca i progetti di un'organizzazioneaura projects create <name> [--engine postgres|mongodb] [--org <slug>]— Effettua il provisioning di un nuovo progettoaura projects delete <id>— Elimina permanentemente un progetto e i relativi datiaura projects api-keys [--project-id <id>]— Mostra le chiavi API del progetto (anon, service_role)aura projects rename <id> <name>— Rinomina un progetto esistenteaura projects retry <id>— Esegue nuovamente il provisioning di un progetto inerrore stampa l'URL e le chiavi una volta prontoaura projects graphql-enable <id> [--wait]— Abilita l'estensione GraphQL (pg_graphql) sul progettoaura 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.--ttlva da 1h a 30d (default 72h).--no-datacopia solo lo schemaaura 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 motivoaura 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 localeaura db diff [--name <name>]: confronta lo schema remoto con quello locale e genera la migrazione SQLaura db status [--json]: mostra lo stato dettagliato delle migrazioni applicate e in sospesoaura db watch: monitora le modifiche allo schema e esegue la sincronizzazione in tempo realeaura db reset [--force]— Elimina e ricrea da zero il database locale (chiede conferma;--forceper gli script)aura db seed— Esegue lo script seed.sql per caricare i dati di testaura db generate [--lang ts|rust]— Genera TypeScript (predefinito) o Rust definizioni del tipo di databaseaura db extensions list [--json]/aura db extensions enable <name>— Elenca le estensioni installate o ne abilita una consentitaaura db inspect <indexes|tables|locks> [--json]— Utilizzo dell'indice (quelli non utilizzati contrassegnati), dimensioni della tabella e righe morte, blocchi di bloccoaura db slow-queries [--limit <n>] [--json]— Elenca le query SQL più lente tramitepg_stat_statementsaura db stats [--json]: mostra le statistiche di connessione e l'utilizzo del disco del databaseaura 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 completaaura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json]— Esegue una query SQL diretta con opzioni di simulazione e di sola letturaaura db migration new <name>: crea un nuovo file di migrazione SQL con timestampaura db migration list [--json]— Elenca tutte le migrazioni del progetto e il relativo statoaura 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 cronologiaaura db statusemigration listletta)
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 tipiaura 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 vincoliaura db table rls <name> <on|off>— Abilita o disabilita la protezione di sicurezza a livello di riga su una tabellaaura db table realtime <name> <on|off>— Abilita o disabilita la pubblicazione in tempo reale CDC su una tabellaaura db policy list [--table <name>] [--all] [--json]— Elenca le policy di sicurezza RLS definite sulle tabelle (--allinclude 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 interruzioniaura 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 accessoaura db function drop <name> [-f]— Elimina una funzione SQL Postgresaura db trigger list <table> [--json]— Elenca tutti i trigger in una tabellaaura 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 tabellaaura 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 databaseaura db backup create [--label <label>]— Genera uno snapshot immediato del databaseaura db backup restore <id> [--verify-only] [--yes]—--yes(o--force) salta la conferma, richiesta negli script e CI; Ripristina un database da uno snapshot specificatoaura db backup download <id> [-o <path>]: scarica il dump SQL completo di un backupaura db backup delete <id> [-f]— Elimina un archivio di backupaura db backup schedule get [--json]— Consulta la pianificazione del backup automatico configuratoaura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable]— Configura la frequenza e la durata di conservazione dei backupaura db apikeys list [--json]— Elenca le chiavi API attive associate al progettoaura db apikeys create <name> [--scope anon|authenticated|service_role]— Genera una nuova chiave API con un ruolo specificoaura 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 progettoaura auth users create [--email <email>] [--password <pass>] [--json]— Crea un nuovo utente con password (--jsonstampa l'utente creato, con il suoid, per gli script)aura auth users delete <id> [-f]: elimina definitivamente un utenteaura auth users ban <id>— Esclude un utente e revoca le sue sessioni attiveaura auth users unban <id>: sblocca un utenteaura auth sessions list [--json]— Elenca le sessioni JWT attiveaura auth audit-log [--limit 50] [--json]: visualizza i registri di controllo della sicurezza e i tentativi di connessioneaura auth settings get [--json]— Visualizza la configurazione di autenticazione (OAuth, MFA, timeout)aura auth settings set KEY=VALUE...— Aggiorna le impostazioni di autenticazioneaura 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 modelloaura 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 Edgeaura functions deploy <name>— Compila il binario WASM e distribuisce la funzione sulla rete globaleaura functions list [--json]— Elenca le funzioni locali e distribuite con il relativo statoaura functions logs <name>— Visualizza il flusso di log in tempo reale di una funzioneaura functions serve— Avvia il server di test locale per le funzioniaura functions invoke <name> [--data '<json>']— Richiama e testa una funzione distribuita con un payloadaura functions download <name>— Scarica il codice sorgente di una funzione remotaaura functions delete <name> [-f]: elimina una funzione Edge distribuitaaura secrets list --function <name> [--json]— Elenca le variabili segrete configurate per una funzioneaura secrets set --function <name> KEY=VALUE...— Definisce i segreti crittografati inseriti nella funzioneaura 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 cartellaaura storage cp <src> <dst>— Trasferisci file (locale ↔ bucket)aura storage rm <path>— Elimina un file archiviato in un bucketaura 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 progettoaura storage buckets create <name> [--public]— Crea un bucket di archiviazioneaura 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 localeaura env set KEY=VALUE...— Imposta una o più variabili nel file .env localeaura env unset KEY...— Rimuove le variabili dal file .env localeaura ui: avvia la TUI interattiva completa (interfaccia utente terminale)aura update— Controlla e aggiorna automaticamente la CLI all'ultima versione stabileaura 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.
# 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
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.