Aura CLI — Pełne odniesienie
Oficjalny plik binarny aura pozwala kontrolować całą platformę Aurabase: lokalny deweloper, Kubernetes, migracje SQL, funkcje przechowywane, Edge Functions WASM, RLS, przechowywanie i uwierzytelnianie.
Samodzielny plik binarny, dostępny wszędzie#
Interfejs CLI jest samodzielnym plikiem binarnym Rust. Jest instalowany dzisiaj przez NPM na macOS Apple Silicon i poprzez kompilację ze źródeł z całego świata. Prekompilowane pakiety binarne dla systemów Linux, macOS Intel i Windows nie zostały jeszcze wydane: npm install -g @aurabase/cli kończy się niepowodzeniem, nie jest to błąd z Twojej strony.
# 1. NPM — na dzień dzisiejszy tylko macOS Apple Silicon
npm install -g @aurabase/cli
aura --help
# 2. Ze źródła — wszystkie platformy (Rust 1.7x+)
git clone https://github.com/Aurabase-cloud/Aurabase.git
cargo install --path Aurabase/aura-cli
# zainstaluj plik binarny `aurabase` w ~/.cargo/bin
aurabase --help
Uwierzytelnij interfejs wiersza polecenia#
Możesz zalogować się na swoje konto konsoli lub przy użyciu osobistego tokena dostępu do swoich potoków CI/CD:
# Interaktywne logowanie (otwiera przeglądarkę)
aura login
# Połączenie nieinteraktywne (e-mail/hasło)
aura login --email dev@example.com --password "secret"
# Połączenie poprzez osobisty token dostępu (idealny dla akcji GitHub / GitLab CI)
aura login --token aura_pat_9a8b7c6d5e4f...
# Sprawdź konto i aktywny projekt
aura whoami
Wyczerpujące odniesienia do każdego modułu#
Znajdź wszystkie polecenia i podpolecenia obsługiwane przez plik binarny aura:
Konfiguracja i zarządzanie projektem
Inicjalizacja, podłączenie i diagnoza projektu
aura init— Inicjuje nowy projekt Aurabase (struktura, konfiguracja, okno dokowane)aura login [--email <email>] [--password <pass>] [--token <pat>]— Loguje się na konto konsoli lub za pomocą osobistego tokena dostępuaura register [--email <email>] [--password <pass>]— Tworzy nowe konto programisty Aurabase Consoleaura logout— Rozłącza aktywną sesję lokalnąaura whoami— Pokazuje zalogowanego użytkownika, jego organizację i aktywny projektaura link --project-id <uuid>— Łączy bieżący katalog z istniejącym projektem w chmurzeaura status— Pokazuje status projektu, stan połączenia i usługiaura doctor— Diagnozuje środowisko lokalne (Docker, porty, narzędzia systemowe)
Rozwój lokalny
Lokalne zarządzanie stosem (Kubernetes/k3d) i logami
aura start— Uruchamia wszystkie lokalne mikrousługi Aurabase na k3daura stop— Zatrzymuje klaster k3d i usługi lokalneaura restart— ponownie uruchamia usługi lokalneaura dev— Tryb ciągłego programowania: monitoruje migracje i synchronizuje typyaura studio— Otwiera lokalny interfejs Studio w przeglądarce (localhost:3000)aura logs [-s <service>] [--since 1h] [--tail 100]— Wyświetla logi ujednolicone lub filtrowane według usługi (aura-auth, aura-db, brama...)aura connect— Otwiera interaktywny terminal psql na bezpośrednim punkcie końcowym projektu PostgreSQL (psql pyta o hasło wydane przezaura db connection --new-password)
Organizacje i projekty w chmurze
Zarządzanie wieloma najemcami organizacjami i projektami
aura orgs list [--json]— Lista organizacji, których jesteś członkiemaura orgs create --name <name> --slug <slug>— Tworzy nową organizację w chmurzeaura orgs use <slug>— Ustawia domyślną organizację zamówieńaura projects list [--org <slug>] [--json]— Wyświetla listę projektów organizacjiaura projects create <name> [--engine postgres|mongodb] [--org <slug>]— Udostępnia nowy projektaura projects delete <id>— Trwale usuwa projekt i jego daneaura projects api-keys [--project-id <id>]— Pokazuje klucze API projektu (anon, service_role)aura projects rename <id> <name>— Zmienia nazwę istniejącego projektuaura projects retry <id>— Ponownie uruchamia udostępnianie projektu werrori drukuje jego adres URL i klucze, gdy projekt będzie gotowyaura projects graphql-enable <id> [--wait]— Włącza rozszerzenie GraphQL (pg_graphql) w projekcieaura projects graphql-config <id> [--introspection on|off] [--max-rows N] [--inflect-names on|off] [--wait]— Pokazuje lub zmienia ustawienia pg_graphql (bez flagi, drukuje obowiązujące ustawienia)
Gałęzie bazy danych (gałąź aury)
Gałąź to nowy projekt sklonowany z projektu PostgreSQL, z własnym adresem URL i kluczami, usuwanymi po zakończeniu TTL. Zobacz gałęzie bazy danych gałęzie bazy danych, aby poznać limity i to, co jest klonowane.
aura branch create <name> [--from <project id|slug|name>] [--org <slug>] [--ttl 72h|3d|2w] [--no-data] [--no-wait] [--json] [--timeout <s>]— Tworzy gałąź połączonego projektu (lub--from), czeka, aż będzie gotowa, a następnie jednokrotnie wypisuje jego adres URL i klucze API.--ttlzmienia się z 1 godziny na 30 dni (domyślnie 72 godziny).--no-datakopiuje tylko schemataura branch list [--from <project>] [--all] [--json]— Wyświetla listę gałęzi projektu lub całej organizacji z--all; Nieudane gałęzie pozostają na liście przez 24 godziny wraz z podaniem przyczynyaura branch delete <name> [--from <project>] [--force]— Usuwa gałąź i jej bazę danych
Baza danych i migracje (aura db)
Zarządzanie schematami, synchronizacja, zapytania typu push/pull i SQL
aura db push— dotyczy oczekujących lokalnych migracji SQL (+ synchronizacja z chmurą, jeśli jest połączona)aura db pull— Pobiera schemat zdalny i aktualizuje schemat lokalnyaura db diff [--name <name>]— Porównuje schemat zdalny z lokalnym i generuje migrację SQLaura db status [--json]— Pokazuje szczegółowy stan zastosowanych i oczekujących migracjiaura db watch— Monitoruje zmiany schematu i synchronizuje na żywoaura db reset [--force]— Usuń i utwórz ponownie lokalną bazę danych od zera (prosi o potwierdzenie;--forcew przypadku skryptów)aura db seed— Uruchamia skrypt nasion.sql w celu załadowania danych testowychaura db generate [--lang ts|rust]— Generuje TypeScript (domyślnie) lub Rust definicje typów baz danychaura db extensions list [--json]/aura db extensions enable <name>— Wyświetla listę zainstalowanych rozszerzeń lub włącza dozwoloneaura db inspect <indexes|tables|locks> [--json]— użycie indeksu (oznaczone nieużywane), rozmiary tabel i martwe wiersze, blokady blokująceaura db slow-queries [--limit <n>] [--json]— Wyświetla listę najwolniejszych zapytań SQL za pośrednictwempg_stat_statementsaura db stats [--json]— Pokazuje statystyki połączeń i wykorzystanie dysku bazy danychaura db connection [--new-password] [--yes] [--json]— Bezpośredni dostęp PostgreSQL (psql, Prisma, Drizzle,pg_dump): host, port, baza danych i rola; z--new-password, wystawia hasło (pokazywane raz, nigdy nie przechowywane w postaci jasnej, unieważnia poprzednie) i drukuje pełny ciąg połączeniaaura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json]— Uruchamia bezpośrednie zapytanie SQL z opcjami symulacji i tylko do odczytuaura db migration new <name>— Tworzy nowy plik migracji SQL ze znacznikiem czasuaura db migration list [--json]— Wyświetla listę wszystkich migracji projektów i ich statusuaura db migration down [n]— Anuluje ostatnio zastosowanych n migracji (domyślnie: 1)aura db migration repair <file> [--applied|--reverted]— Ręcznie oznacza migrację jako zastosowaną lub anulowaną w historii migracji projektu (ta sama historiaaura db statusimigration listprzeczytana)
RLS tabele i zasady (tabela / zasady aura db)
Tworzenie deklaratywne, RLS, w czasie rzeczywistym CDC i uprawnienia
aura db table list [--json]— Wyświetla listę tabel schematów publicznych wraz z ich kolumnami i typamiaura db table create <name> "<cols>"— Tworzy tabelę (np.: „tytuł:tekst, tagi:tekst[], osadzanie:vector(1536)”)aura db table drop <name> [-f]— Usuwa tabelę i jej ograniczeniaaura db table rls <name> <on|off>— Włącza lub wyłącza ochronę tabeli na poziomie wierszaaura db table realtime <name> <on|off>— Włącza lub wyłącza publikowanie CDC w czasie rzeczywistym w tabeliaura db policy list [--table <name>] [--all] [--json]— Wyświetla zasady bezpieczeństwa RLS zdefiniowane w tabelach (--allzawiera reguły dotyczące pamięci wewnętrznej)aura db policy add <table> <name> <cmd> [--using-expr <expr>] [--check-expr <expr>]— Tworzy nową politykę RLS (WYBIERZ, WSTAW, AKTUALIZUJ, USUŃ lub WSZYSTKIE)aura db policy update <table> <name> [--using-expr <expr>] [--check-expr <expr>]— Modyfikuje wyrażenia USING / WITH CHECK reguły bez przerywaniaaura db policy delete <table> <name> [-f]— Usuwa regułę bezpieczeństwa RLS
Postgres Funkcje i wyzwalacze SQL (funkcja / wyzwalacz aura db)
Procedury składowane PL/pgSQL i wyzwalacze tabel
aura db function list [--json]— Wyświetla listę funkcji Postgres w schemacie (nazwa, argumenty, zabezpieczenia, uprawnienia)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>]— Tworzy lub zastępuje przechowywaną funkcję SQL ze ścisłą kontrolą dostępuaura db function drop <name> [-f]— Usuń funkcję SQL Postgresaura db trigger list <table> [--json]— Wyświetla listę wszystkich wyzwalaczy w tabeliaura db trigger create <table> <name> --function <fn> [--timing before|after|instead_of] --events insert,update [--for-each row|statement]— Wiąże funkcję wyzwalającą ze zdarzeniami w tabeliaura db trigger drop <table> <name> [-f]— Usuń wyzwalacz ze stołu
Kopie zapasowe i klucze API (kopia zapasowa aura db / klucze api)
Migawki, przywracanie i zarządzanie tokenami dostępu
aura db backup list [--json]— Wyświetla listę ręcznych i automatycznych kopii zapasowych bazy danychaura db backup create [--label <label>]— Generuje natychmiastową migawkę bazy danychaura db backup restore <id> [--verify-only] [--yes]—--yes(lub--force) pomija potwierdzenie wymagane w skryptach i CI; Przywraca bazę danych z określonej migawkiaura db backup download <id> [-o <path>]— Pobierz pełny zrzut SQL kopii zapasowejaura db backup delete <id> [-f]— Usuwa archiwum kopii zapasowychaura db backup schedule get [--json]— sprawdza skonfigurowany harmonogram automatycznego tworzenia kopii zapasowychaura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable]— konfiguruje częstotliwość i czas przechowywania kopii zapasowychaura db apikeys list [--json]— Wyświetla listę aktywnych kluczy API powiązanych z projektemaura db apikeys create <name> [--scope anon|authenticated|service_role]— Generuje nowy klucz API z określoną roląaura db apikeys revoke <id> [-f]— Natychmiast unieważnia klucz API
Uwierzytelnianie i użytkownicy (auth aura)
Zarządzanie kontami, sesjami, dziennikami audytu i szablonami wiadomości e-mail
aura auth users list [--json]— Wyświetla listę użytkowników zarejestrowanych w projekcieaura auth users create [--email <email>] [--password <pass>] [--json]— Tworzy nowego użytkownika z hasłem (--jsondrukuje utworzonego użytkownika z jegoiddla skryptów)aura auth users delete <id> [-f]— Trwale usuwa użytkownikaaura auth users ban <id>— Blokuje użytkownika i odwołuje jego aktywne sesjeaura auth users unban <id>— Odbanuj użytkownikaaura auth sessions list [--json]— Lista aktywnych sesji JWTaura auth audit-log [--limit 50] [--json]— Wyświetl dzienniki audytu bezpieczeństwa i próby połączeńaura auth settings get [--json]— Wyświetla konfigurację uwierzytelniania (OAuth, MFA, limity czasu)aura auth settings set KEY=VALUE...— Aktualizuje ustawienia uwierzytelnianiaaura auth email-templates list [--json]— Lista szablonów e-maili (potwierdzenie, reset, magiczny link)aura auth email-templates get <type>— Wyświetla kod źródłowy HTML/tekstowy szablonuaura auth email-templates reset <type> [-f]— Resetuje szablon do wartości domyślnych
Funkcje krawędziowe WASM i sekrety (funkcje aury / sekrety)
Wdrażanie funkcji brzegowych i zaszyfrowanych zmiennych środowiskowych
aura functions new <name>— Generuje szkielet nowej funkcji krawędziaura functions deploy <name>— Kompiluje do pliku binarnego WASM i wdraża funkcję w sieci globalnejaura functions list [--json]— Wyświetla listę funkcji lokalnych i wdrożonych wraz z ich statusemaura functions logs <name>— Wyświetla strumień dziennika funkcji w czasie rzeczywistymaura functions serve— Uruchamia lokalny serwer testowy dla funkcjiaura functions invoke <name> [--data '<json>']— Wywołaj i przetestuj funkcję wdrożoną z ładunkiemaura functions download <name>— Pobierz kod źródłowy funkcji zdalnejaura functions delete <name> [-f]— usuwa wdrożoną funkcję Edgeaura secrets list --function <name> [--json]— Wyświetla listę tajnych zmiennych skonfigurowanych dla funkcjiaura secrets set --function <name> KEY=VALUE...— Definiuje zaszyfrowane klucze tajne wprowadzone do funkcjiaura secrets unset --function <name> KEY...— Usuwa jeden lub więcej kluczy tajnych z funkcji
Przechowywanie obiektów (przechowywanie aury)
Zarządzanie wiadrami i przesyłanie plików
aura storage ls [path]— Wyświetla listę zasobników lub plików w folderzeaura storage cp <src> <dst>— Przesyłaj pliki (lokalny ↔ zasobnik)aura storage rm <path>— Usuwa plik przechowywany w zasobnikuaura storage mb <name> [--public]— Tworzy nowy segment (domyślnie prywatny lub publiczny)aura storage buckets list [--json]— Wyświetla listę wszystkich zasobników pamięci w projekcieaura storage buckets create <name> [--public]— Tworzy zasobnik pamięciaura storage buckets delete <name> [-f]— Usuwa wiadro i czyści wszystkie znajdujące się w nim obiekty
Lokalne środowisko i media
zmienne .env, interfejs TUI, automatyczna aktualizacja i automatyczne uzupełnianie
aura env list [--json]— Pokazuje zmienne zdefiniowane w lokalnym pliku .envaura env set KEY=VALUE...— Ustawia jedną lub więcej zmiennych w lokalnym pliku .envaura env unset KEY...— Usuń zmienne z lokalnego pliku .envaura ui— uruchamia w pełni interaktywny TUI (interfejs użytkownika terminala)aura update— Automatycznie sprawdza i aktualizuje interfejs CLI do najnowszej stabilnej wersjiaura completions <bash|zsh|fish|powershell|elvish>— Generuje skrypty automatycznego uzupełniania dla powłoki
Interaktywny interfejs w terminalu#
Aurabase integruje interfejs trybu tekstowego (aura ui) obsługiwany przez Ratatui. Umożliwia nawigację po bazach danych, wykonywanie SQL, sprawdzanie tabel i śledzenie logów bez opuszczania terminala.
# Uruchom interfejs TUI
aura ui
Opcje i ustawienia globalne#
--json— Strukturalne wyjście JSON (idealne do skryptów, automatyzacji jq i CI/CD)--dry-run— Wykonuje polecenie w transakcji wycofanej na końcu w celu sprawdzenia ograniczeń bez zmiany danych--read-only— Blokuje transakcję wyłącznie do odczytu w silniku Postgres-f, --force— Ignoruje interaktywne prośby o potwierdzenie destrukcyjnych operacji--project-id <uuid>— Celuje w konkretny projekt zdalny, ignorując lokalny plik łączący
Włącz autouzupełnianie w powłoce, aby automatycznie tabulować polecenia:aura completions zsh > ~/.zfunc/_aura lub aura completions bash > /etc/bash_completion.d/aura.