CLI aurası — Tam referans
Resmi aura ikili dosyası, Aurabase platformunun tamamını kontrol etmenize olanak tanır: yerel geliştirme, Kubernetes, SQL geçişleri, depolanan işlevler, Edge Functions WASM, RLS, Depolama ve Kimlik Doğrulama.
Her yerde kullanılabilen bağımsız bir ikili program#
CLI bağımsız bir Rust ikili dosyasıdır. Bugün NPM tarafından macOS Apple Silicon üzerine ve diğer her yerdeki kaynaklardan derlenerek yüklenmiştir. Linux, macOS Intel ve Windows için önceden derlenmiş ikili paketler henüz yayınlanmadı: npm install -g @aurabase/cli burada başarısız oluyor, bu sizin açınızdan bir hata değil.
# 1. NPM — bugün itibarıyla yalnızca macOS Apple Silicon
npm install -g @aurabase/cli
aura --help
# 2. Kaynaktan — tüm platformlar (Rust 1.7x+)
git clone https://github.com/Aurabase-cloud/Aurabase.git
cargo install --path Aurabase/aura-cli
# ~/.cargo/bin dizinine `aurabase` ikili dosyasını yükleyin
aurabase --help
CLI'nin kimliğini doğrulayın#
Konsol hesabınızla veya CI/CD ardışık düzenleriniz için Kişisel Erişim Belirteci kullanarak oturum açabilirsiniz:
# Etkileşimli oturum açma (tarayıcıyı açar)
aura login
# Etkileşimli olmayan bağlantı (e-posta / şifre)
aura login --email dev@example.com --password "secret"
# Kişisel Erişim Simgesi aracılığıyla bağlantı (GitHub Eylemler / GitLab CI için ideal)
aura login --token aura_pat_9a8b7c6d5e4f...
# Hesabı ve aktif projeyi kontrol edin
aura whoami
Modül başına kapsamlı referans#
aura ikili dosyası tarafından desteklenen tüm komutları ve alt komutları bulun:
Proje kurulumu ve yönetimi
Projenin başlatılması, bağlanması ve teşhisi
aura init— Yeni bir Aurabase projesini başlatır (yapı, yapılandırma, liman işçisi)aura login [--email <email>] [--password <pass>] [--token <pat>]— Konsol hesabında veya Kişisel Erişim Simgesiyle oturum açaraura register [--email <email>] [--password <pass>]— Yeni bir Aurabase Konsol geliştirici hesabı oluştururaura logout— Etkin yerel oturumun bağlantısını keseraura whoami— Oturum açmış kullanıcıyı, kuruluşunu ve etkin projeyi gösteriraura link --project-id <uuid>— Geçerli dizini mevcut bir bulut projesine bağlaraura status— Proje durumunu, bağlantı ve hizmet durumunu gösteriraura doctor— Yerel ortamı tanılar (Docker, bağlantı noktaları, sistem araçları)
Yerel kalkınma
Yerel yığın yönetimi (Kubernetes / k3d) ve günlükler
aura start— k3d'deki tüm Aurabase yerel mikro hizmetleri başlatıraura stop— k3d kümesini ve yerel hizmetleri durdururaura restart— Yerel hizmetleri yeniden başlatıraura dev— Sürekli geliştirme modu: geçişleri izler ve türleri senkronize ederaura studio— Tarayıcınızda yerel Studio arayüzünü açar (localhost:3000)aura logs [-s <service>] [--since 1h] [--tail 100]— Hizmete göre (aura-auth, aura-db, ağ geçidi...) birleştirilmiş veya filtrelenmiş günlükleri görüntüleraura connect— Projenin doğrudan PostgreSQL uç noktasında etkileşimli bir psql terminali açar (psql,aura db connection --new-passwordtarafından verilen parolayı sorar)
Organizasyonlar ve bulut projeleri
Organizasyonların ve projelerin çok kiracılı yönetimi
aura orgs list [--json]— Üyesi olduğunuz kuruluşları listeleraura orgs create --name <name> --slug <slug>— Yeni bir Bulut organizasyonu oluştururaura orgs use <slug>— Siparişler için varsayılan organizasyonu ayarlaraura projects list [--org <slug>] [--json]— Bir kuruluşun projelerini listeleraura projects create <name> [--engine postgres|mongodb] [--org <slug>]— Yeni bir proje hazırlaraura projects delete <id>— Bir projeyi ve verilerini kalıcı olarak sileraura projects api-keys [--project-id <id>]— Projenin API anahtarlarını gösterir (anon, service_role)aura projects rename <id> <name>— Mevcut bir projeyi yeniden adlandırıraura projects retry <id>—erroriçindeki bir projenin provizyonunu yeniden çalıştırır ve hazır olduğunda URL'sini ve anahtarlarını yazdırıraura projects graphql-enable <id> [--wait]— Projede GraphQL uzantısını (pg_graphql) etkinleştiriraura projects graphql-config <id> [--introspection on|off] [--max-rows N] [--inflect-names on|off] [--wait]— pg_graphql ayarlarını gösterir veya değiştirir (bayrak olmadan, geçerli ayarları yazdırır)
Veritabanı şubeleri (aura şubesi)
Dal, PostgreSQL projesinden klonlanmış, kendi URL'si ve anahtarları olan ve TTL'si sona erdiğinde silinen yeni bir projedir. Sınırlar ve neyin kopyalandığı için veritabanı dallarına bakın.
aura branch create <name> [--from <project id|slug|name>] [--org <slug>] [--ttl 72h|3d|2w] [--no-data] [--no-wait] [--json] [--timeout <s>]— Bağlantılı projenin (veya--from) bir dalını oluşturur, hazır olana kadar bekler, ardından URL'sini ve API anahtarlarını bir kez yazdırır.--ttl1 saatten 30 güne (varsayılan 72 saat) gider.--no-datayalnızca şemayı kopyalaraura branch list [--from <project>] [--all] [--json]— Bir projenin veya tüm organizasyonun şubelerini--allile listeler; Başarısız olan şubeler nedenleri ile birlikte 24 saat listede kalıraura branch delete <name> [--from <project>] [--force]— Bir dalı ve veritabanını siler
Veritabanı ve geçişler (aura db)
Şema yönetimi, senkronizasyon, push/pull ve SQL sorguları
aura db push— Bekleyen yerel SQL geçişlerini uygular (+ bağlıysa bulut senkronizasyonu)aura db pull— Uzak şemayı alır ve yerel şemayı güncelleraura db diff [--name <name>]— Uzak şemayı yerel şemayla karşılaştırır ve SQL geçişi oluştururaura db status [--json]— Uygulanan ve bekleyen geçişlerin ayrıntılı durumunu gösteriraura db watch— Şema değişikliklerini izler ve canlı olarak senkronize ederaura db reset [--force]— Yerel veritabanını temizler ve sıfırdan yeniden oluşturur (onay ister; komut dosyaları için--force)aura db seed— Test verilerini yüklemek için tohum.sql betiğini çalıştırıraura db generate [--lang ts|rust]— TypeScript (varsayılan) veya Rust Veritabanı türü tanımlarını oluştururaura db extensions list [--json]/aura db extensions enable <name>— Yüklü uzantıları listeler veya izin verilen uzantılardan birini etkinleştiriraura db inspect <indexes|tables|locks> [--json]— Dizin kullanımı (kullanılmayanlar işaretlenir), tablo boyutları ve ölü satırlar, kilitleri engellemeaura db slow-queries [--limit <n>] [--json]—pg_stat_statementsaracılığıyla en yavaş SQL sorgularını listeleraura db stats [--json]— Bağlantı istatistiklerini ve veritabanı disk kullanımını gösteriraura db connection [--new-password] [--yes] [--json]— Doğrudan PostgreSQL erişimi (psql, Prisma, Drizzle,pg_dump): ana bilgisayar, bağlantı noktası, veritabanı ve rol;--new-passwordile bir parola verir (bir kez gösterilir, hiçbir zaman açık olarak saklanmaz, öncekini iptal eder) ve tam bağlantı dizesini yazdırıraura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json]— Simülasyon ve salt okunur seçeneklerle doğrudan bir SQL sorgusu çalıştırıraura db migration new <name>— Zaman damgalı yeni bir SQL geçiş dosyası oluştururaura db migration list [--json]— Tüm proje geçişlerini ve durumlarını listeleraura db migration down [n]— Uygulanan son n taşıma işlemini iptal eder (varsayılan: 1)aura db migration repair <file> [--applied|--reverted]— Projenin geçiş geçmişinde bir geçişi manuel olarak uygulandığı veya iptal edildiği şekilde işaretler (aura db statusvemigration listokunan geçmişin aynısı)
RLS tablolar ve politikalar (aura db tablosu / politikası)
Bildirime dayalı oluşturma, RLS, gerçek zamanlı CDC ve izinler
aura db table list [--json]— Genel şema tablolarını sütunları ve türleriyle birlikte listeleraura db table create <name> "<cols>"— Bir tablo oluşturur (ör. "başlık:metin,etiketler:metin[],katıştırma:vektör(1536)")aura db table drop <name> [-f]— Bir tabloyu ve kısıtlamalarını sileraura db table rls <name> <on|off>— Tabloda Satır Düzeyinde Güvenlik korumasını etkinleştirir veya devre dışı bırakıraura db table realtime <name> <on|off>— Bir tabloda Gerçek Zamanlı CDC yayınlamayı etkinleştirir veya devre dışı bırakıraura db policy list [--table <name>] [--all] [--json]— Tablolarda tanımlanan RLS güvenlik ilkelerini listeler (--alldahili depolama kurallarını içerir)aura db policy add <table> <name> <cmd> [--using-expr <expr>] [--check-expr <expr>]— Yeni bir RLS politikası oluşturur (SELECT, INSERT, UPDATE, DELETE veya ALL)aura db policy update <table> <name> [--using-expr <expr>] [--check-expr <expr>]— Bir kuralın USING / YOUR CHECK ifadelerini bozmadan değiştiriraura db policy delete <table> <name> [-f]— RLS güvenlik kuralını siler
Postgres SQL işlevleri ve tetikleyicileri (aura db işlevi/tetikleyicisi)
PL/pgSQL saklı yordamları ve tablo tetikleyicileri
aura db function list [--json]— Şemadaki Postgres işlevlerini listeler (ad, bağımsız değişkenler, güvenlik, haklar)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>]— Saklanan bir SQL işlevini katı erişim kontrolüyle oluşturur veya değiştiriraura db function drop <name> [-f]— Bir Postgres SQL işlevini sileraura db trigger list <table> [--json]— Bir tablodaki tüm tetikleyicileri listeleraura db trigger create <table> <name> --function <fn> [--timing before|after|instead_of] --events insert,update [--for-each row|statement]— Bir tetikleyici işlevi tablo olaylarına bağlaraura db trigger drop <table> <name> [-f]— Tablodaki tetikleyiciyi siler
Yedeklemeler ve API anahtarları (aura db yedekleme / api anahtarları)
Erişim belirteçlerinin anlık görüntüleri, restorasyonu ve yönetimi
aura db backup list [--json]— Veritabanının manuel ve otomatik yedeklemelerini listeleraura db backup create [--label <label>]— Veritabanının anında anlık görüntüsünü oluştururaura db backup restore <id> [--verify-only] [--yes]—--yes(veya--force), komut dosyalarında ve CI'da gerekli olan onayı atlar; Belirtilen anlık görüntüden bir veritabanını geri yükleraura db backup download <id> [-o <path>]— Bir yedeğin tam SQL dökümünü indiriraura db backup delete <id> [-f]— Yedekleme arşivini sileraura db backup schedule get [--json]— Yapılandırılmış otomatik yedekleme planına başvururaura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable]— Yedeklemelerin sıklığını ve saklama süresini yapılandırıraura db apikeys list [--json]— Projeyle ilişkili etkin API anahtarlarını listeleraura db apikeys create <name> [--scope anon|authenticated|service_role]— Belirli bir role sahip yeni bir API anahtarı oluştururaura db apikeys revoke <id> [-f]— Bir API anahtarını anında iptal eder
Kimlik doğrulama ve kullanıcılar (aura kimlik doğrulaması)
Hesapların, oturumların, denetim günlüklerinin ve e-posta şablonlarının yönetimi
aura auth users list [--json]— Projeye kayıtlı kullanıcıları listeleraura auth users create [--email <email>] [--password <pass>] [--json]— Şifreli yeni bir kullanıcı oluşturur (--json, komut dosyaları için oluşturulan kullanıcıyıidile yazdırır)aura auth users delete <id> [-f]— Bir kullanıcıyı kalıcı olarak silaura auth users ban <id>— Bir kullanıcıyı yasaklar ve aktif oturumlarını iptal ederaura auth users unban <id>— Bir kullanıcının yasağını kaldırıraura auth sessions list [--json]— Etkin JWT oturumları listeleraura auth audit-log [--limit 50] [--json]— Güvenlik denetim günlüklerini ve bağlantı girişimlerini görüntüleyinaura auth settings get [--json]— Kimlik doğrulama yapılandırmasını görüntüler (OAuth, MFA, zaman aşımları)aura auth settings set KEY=VALUE...— Kimlik doğrulama ayarlarını güncelleraura auth email-templates list [--json]— E-posta şablonlarını listeleyin (onay, sıfırlama, sihirli bağlantı)aura auth email-templates get <type>— Bir şablonun HTML/metin kaynak kodunu görüntüleraura auth email-templates reset <type> [-f]— Şablonu varsayılan değerlere sıfırlar
Kenar işlevleri WASM ve sırlar (aura işlevleri / sırlar)
Edge Özelliklerini ve Şifrelenmiş Ortam Değişkenlerini Dağıtma
aura functions new <name>— Yeni bir Kenar Fonksiyonunun iskeletini oluştururaura functions deploy <name>— WASM ikili dosyasına derler ve işlevi küresel ağa dağıtıraura functions list [--json]— Yerel ve dağıtılan işlevleri durumlarıyla birlikte listeleraura functions logs <name>— Bir işlevin gerçek zamanlı günlük akışını görüntüleraura functions serve— İşlevler için yerel test sunucusunu başlatıraura functions invoke <name> [--data '<json>']— Yük ile dağıtılan bir işlevi çağırın ve test edinaura functions download <name>— Uzak bir işlevin kaynak kodunu indirinaura functions delete <name> [-f]— Dağıtılmış bir Edge İşlevini sileraura secrets list --function <name> [--json]— Bir işlev için yapılandırılan gizli değişkenleri listeleraura secrets set --function <name> KEY=VALUE...— İşleve enjekte edilen şifrelenmiş gizli dizileri tanımlaraura secrets unset --function <name> KEY...— Bir işlevden bir veya daha fazla gizli diziyi kaldırır
Nesne depolama (aura depolama)
Kova yönetimi ve dosya aktarımı
aura storage ls [path]— Bir klasördeki paketleri veya dosyaları listeleraura storage cp <src> <dst>— Dosyaları aktar (yerel ↔ paket)aura storage rm <path>— Bir pakette saklanan dosyayı sileraura storage mb <name> [--public]— Yeni bir paket oluşturur (varsayılan olarak özel veya genel)aura storage buckets list [--json]— Projedeki tüm depolama paketlerini listeleraura storage buckets create <name> [--public]— Bir depolama paketi oluştururaura storage buckets delete <name> [-f]— Bir paketi siler ve içindeki tüm nesneleri temizler
Yerel çevre ve olanaklar
.env değişkenleri, TUI arayüzü, otomatik güncelleme ve otomatik tamamlama
aura env list [--json]— Yerel .env'de tanımlanan değişkenleri gösteriraura env set KEY=VALUE...— Yerel .env dosyasında bir veya daha fazla değişkeni ayarlaraura env unset KEY...— Değişkenleri yerel .env dosyasından kaldırıraura ui— Tam etkileşimli TUI'yi (Terminal Kullanıcı Arayüzü) başlatıraura update— CLI'yi otomatik olarak kontrol eder ve en son kararlı sürüme güncelleraura completions <bash|zsh|fish|powershell|elvish>— Kabuğunuz için otomatik tamamlama komut dosyaları oluşturur
Terminaldeki etkileşimli arayüz#
Aurabase, Ratatui tarafından desteklenen bir metin modu arayüzünü (aura ui) entegre eder. Terminalinizden ayrılmadan veritabanlarınızda gezinmenize, SQL yürütmenize, tabloları incelemenize ve günlükleri takip etmenize olanak tanır.
# TUI arayüzünü başlatın
aura ui
Genel seçenekler ve ayarlar#
--json— Yapılandırılmış JSON çıkışı (komut dosyası oluşturma, jq ve CI/CD otomasyonu için idealdir)--dry-run— Verileri değiştirmeden kısıtlamaları doğrulamak için işlemin sonunda geri alınan bir işlemde komutu çalıştırır--read-only— İşlemi Postgres motorunda kesinlikle salt okunur olarak kilitler-f, --force— Yıkıcı işlemlere ilişkin etkileşimli onay isteklerini yok sayar--project-id <uuid>— Yerel bağlantı dosyasını yok sayarak belirli bir uzak projeyi hedefler
Komutları otomatik olarak sekmek için kabuğunuzda otomatik tamamlamayı etkinleştirin:aura completions zsh > ~/.zfunc/_aura veya aura completions bash > /etc/bash_completion.d/aura.