Przejdź do treści
Logo Aurabase
aurabaza

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.

Referencja12 min przeczytanePoziom odniesienieZmieniono 19 sie 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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.

terminalbash
# 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:

terminalbash
# 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ępu
  • aura register [--email <email>] [--password <pass>] — Tworzy nowe konto programisty Aurabase Console
  • aura logout — Rozłącza aktywną sesję lokalną
  • aura whoami — Pokazuje zalogowanego użytkownika, jego organizację i aktywny projekt
  • aura link --project-id <uuid> — Łączy bieżący katalog z istniejącym projektem w chmurze
  • aura status — Pokazuje status projektu, stan połączenia i usługi
  • aura 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 k3d
  • aura stop — Zatrzymuje klaster k3d i usługi lokalne
  • aura restart — ponownie uruchamia usługi lokalne
  • aura dev — Tryb ciągłego programowania: monitoruje migracje i synchronizuje typy
  • aura 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 przez aura 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łonkiem
  • aura orgs create --name <name> --slug <slug> — Tworzy nową organizację w chmurze
  • aura orgs use <slug> — Ustawia domyślną organizację zamówień
  • aura projects list [--org <slug>] [--json] — Wyświetla listę projektów organizacji
  • aura projects create <name> [--engine postgres|mongodb] [--org <slug>] — Udostępnia nowy projekt
  • aura projects delete <id> — Trwale usuwa projekt i jego dane
  • aura projects api-keys [--project-id <id>] — Pokazuje klucze API projektu (anon, service_role)
  • aura projects rename <id> <name> — Zmienia nazwę istniejącego projektu
  • aura projects retry <id> — Ponownie uruchamia udostępnianie projektu w error i drukuje jego adres URL i klucze, gdy projekt będzie gotowy
  • aura projects graphql-enable <id> [--wait] — Włącza rozszerzenie GraphQL (pg_graphql) w projekcie
  • aura 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. --ttl zmienia się z 1 godziny na 30 dni (domyślnie 72 godziny). --no-data kopiuje tylko schemat
  • aura 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 przyczyny
  • aura 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 lokalny
  • aura db diff [--name <name>] — Porównuje schemat zdalny z lokalnym i generuje migrację SQL
  • aura db status [--json] — Pokazuje szczegółowy stan zastosowanych i oczekujących migracji
  • aura db watch — Monitoruje zmiany schematu i synchronizuje na żywo
  • aura db reset [--force] — Usuń i utwórz ponownie lokalną bazę danych od zera (prosi o potwierdzenie; --force w przypadku skryptów)
  • aura db seed — Uruchamia skrypt nasion.sql w celu załadowania danych testowych
  • aura db generate [--lang ts|rust] — Generuje TypeScript (domyślnie) lub Rust definicje typów baz danych
  • aura db extensions list [--json] / aura db extensions enable <name> — Wyświetla listę zainstalowanych rozszerzeń lub włącza dozwolone
  • aura db inspect <indexes|tables|locks> [--json] — użycie indeksu (oznaczone nieużywane), rozmiary tabel i martwe wiersze, blokady blokujące
  • aura db slow-queries [--limit <n>] [--json] — Wyświetla listę najwolniejszych zapytań SQL za pośrednictwem pg_stat_statements
  • aura db stats [--json] — Pokazuje statystyki połączeń i wykorzystanie dysku bazy danych
  • aura 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łączenia
  • aura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json] — Uruchamia bezpośrednie zapytanie SQL z opcjami symulacji i tylko do odczytu
  • aura db migration new <name> — Tworzy nowy plik migracji SQL ze znacznikiem czasu
  • aura db migration list [--json] — Wyświetla listę wszystkich migracji projektów i ich statusu
  • aura 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 historia aura db status i migration list przeczytana)

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 typami
  • aura 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 ograniczenia
  • aura db table rls <name> <on|off> — Włącza lub wyłącza ochronę tabeli na poziomie wiersza
  • aura db table realtime <name> <on|off> — Włącza lub wyłącza publikowanie CDC w czasie rzeczywistym w tabeli
  • aura db policy list [--table <name>] [--all] [--json] — Wyświetla zasady bezpieczeństwa RLS zdefiniowane w tabelach (--all zawiera 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 przerywania
  • aura 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ępu
  • aura db function drop <name> [-f] — Usuń funkcję SQL Postgres
  • aura db trigger list <table> [--json] — Wyświetla listę wszystkich wyzwalaczy w tabeli
  • aura 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 tabeli
  • aura 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 danych
  • aura db backup create [--label <label>] — Generuje natychmiastową migawkę bazy danych
  • aura db backup restore <id> [--verify-only] [--yes] — --yes (lub --force) pomija potwierdzenie wymagane w skryptach i CI; Przywraca bazę danych z określonej migawki
  • aura db backup download <id> [-o <path>] — Pobierz pełny zrzut SQL kopii zapasowej
  • aura db backup delete <id> [-f] — Usuwa archiwum kopii zapasowych
  • aura db backup schedule get [--json] — sprawdza skonfigurowany harmonogram automatycznego tworzenia kopii zapasowych
  • aura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable] — konfiguruje częstotliwość i czas przechowywania kopii zapasowych
  • aura db apikeys list [--json] — Wyświetla listę aktywnych kluczy API powiązanych z projektem
  • aura 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 projekcie
  • aura auth users create [--email <email>] [--password <pass>] [--json] — Tworzy nowego użytkownika z hasłem (--json drukuje utworzonego użytkownika z jego id dla skryptów)
  • aura auth users delete <id> [-f] — Trwale usuwa użytkownika
  • aura auth users ban <id> — Blokuje użytkownika i odwołuje jego aktywne sesje
  • aura auth users unban <id> — Odbanuj użytkownika
  • aura auth sessions list [--json] — Lista aktywnych sesji JWT
  • aura 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 uwierzytelniania
  • aura 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 szablonu
  • aura 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ędzi
  • aura functions deploy <name> — Kompiluje do pliku binarnego WASM i wdraża funkcję w sieci globalnej
  • aura functions list [--json] — Wyświetla listę funkcji lokalnych i wdrożonych wraz z ich statusem
  • aura functions logs <name> — Wyświetla strumień dziennika funkcji w czasie rzeczywistym
  • aura functions serve — Uruchamia lokalny serwer testowy dla funkcji
  • aura functions invoke <name> [--data '<json>'] — Wywołaj i przetestuj funkcję wdrożoną z ładunkiem
  • aura functions download <name> — Pobierz kod źródłowy funkcji zdalnej
  • aura functions delete <name> [-f] — usuwa wdrożoną funkcję Edge
  • aura secrets list --function <name> [--json] — Wyświetla listę tajnych zmiennych skonfigurowanych dla funkcji
  • aura secrets set --function <name> KEY=VALUE... — Definiuje zaszyfrowane klucze tajne wprowadzone do funkcji
  • aura 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 folderze
  • aura storage cp <src> <dst> — Przesyłaj pliki (lokalny ↔ zasobnik)
  • aura storage rm <path> — Usuwa plik przechowywany w zasobniku
  • aura 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 projekcie
  • aura storage buckets create <name> [--public] — Tworzy zasobnik pamięci
  • aura 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 .env
  • aura env set KEY=VALUE... — Ustawia jedną lub więcej zmiennych w lokalnym pliku .env
  • aura env unset KEY... — Usuń zmienne z lokalnego pliku .env
  • aura ui — uruchamia w pełni interaktywny TUI (interfejs użytkownika terminala)
  • aura update — Automatycznie sprawdza i aktualizuje interfejs CLI do najnowszej stabilnej wersji
  • aura 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.

terminalbash
# 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
Wskazówka

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.

Aby pójść dalej#