İçeriğe geç
Aurabase Logosu
aura tabanı

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.

Referans12 dk. okuSeviye referans19 Ağu 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

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.

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

terminalbash
# 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çar
  • aura register [--email <email>] [--password <pass>] — Yeni bir Aurabase Konsol geliştirici hesabı oluşturur
  • aura logout — Etkin yerel oturumun bağlantısını keser
  • aura whoami — Oturum açmış kullanıcıyı, kuruluşunu ve etkin projeyi gösterir
  • aura link --project-id <uuid> — Geçerli dizini mevcut bir bulut projesine bağlar
  • aura status — Proje durumunu, bağlantı ve hizmet durumunu gösterir
  • aura 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ır
  • aura stop — k3d kümesini ve yerel hizmetleri durdurur
  • aura restart — Yerel hizmetleri yeniden başlatır
  • aura dev — Sürekli geliştirme modu: geçişleri izler ve türleri senkronize eder
  • aura 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üler
  • aura connect — Projenin doğrudan PostgreSQL uç noktasında etkileşimli bir psql terminali açar (psql, aura db connection --new-password tarafı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ı listeler
  • aura orgs create --name <name> --slug <slug> — Yeni bir Bulut organizasyonu oluşturur
  • aura orgs use <slug> — Siparişler için varsayılan organizasyonu ayarlar
  • aura projects list [--org <slug>] [--json] — Bir kuruluşun projelerini listeler
  • aura projects create <name> [--engine postgres|mongodb] [--org <slug>] — Yeni bir proje hazırlar
  • aura projects delete <id> — Bir projeyi ve verilerini kalıcı olarak siler
  • aura 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ır
  • aura projects retry <id> — error içindeki bir projenin provizyonunu yeniden çalıştırır ve hazır olduğunda URL'sini ve anahtarlarını yazdırır
  • aura projects graphql-enable <id> [--wait] — Projede GraphQL uzantısını (pg_graphql) etkinleştirir
  • aura 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. --ttl 1 saatten 30 güne (varsayılan 72 saat) gider. --no-data yalnızca şemayı kopyalar
  • aura branch list [--from <project>] [--all] [--json] — Bir projenin veya tüm organizasyonun şubelerini --all ile listeler; Başarısız olan şubeler nedenleri ile birlikte 24 saat listede kalır
  • aura 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ünceller
  • aura db diff [--name <name>] — Uzak şemayı yerel şemayla karşılaştırır ve SQL geçişi oluşturur
  • aura db status [--json] — Uygulanan ve bekleyen geçişlerin ayrıntılı durumunu gösterir
  • aura db watch — Şema değişikliklerini izler ve canlı olarak senkronize eder
  • aura 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ır
  • aura db generate [--lang ts|rust] — TypeScript (varsayılan) veya Rust Veritabanı türü tanımlarını oluşturur
  • aura db extensions list [--json] / aura db extensions enable <name> — Yüklü uzantıları listeler veya izin verilen uzantılardan birini etkinleştirir
  • aura db inspect <indexes|tables|locks> [--json] — Dizin kullanımı (kullanılmayanlar işaretlenir), tablo boyutları ve ölü satırlar, kilitleri engelleme
  • aura db slow-queries [--limit <n>] [--json] — pg_stat_statements aracılığıyla en yavaş SQL sorgularını listeler
  • aura db stats [--json] — Bağlantı istatistiklerini ve veritabanı disk kullanımını gösterir
  • aura 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-password ile bir parola verir (bir kez gösterilir, hiçbir zaman açık olarak saklanmaz, öncekini iptal eder) ve tam bağlantı dizesini yazdırır
  • aura 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ır
  • aura db migration new <name> — Zaman damgalı yeni bir SQL geçiş dosyası oluşturur
  • aura db migration list [--json] — Tüm proje geçişlerini ve durumlarını listeler
  • aura 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 status ve migration list okunan 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 listeler
  • aura 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ı siler
  • aura db table rls <name> <on|off> — Tabloda Satır Düzeyinde Güvenlik korumasını etkinleştirir veya devre dışı bırakır
  • aura db table realtime <name> <on|off> — Bir tabloda Gerçek Zamanlı CDC yayınlamayı etkinleştirir veya devre dışı bırakır
  • aura db policy list [--table <name>] [--all] [--json] — Tablolarda tanımlanan RLS güvenlik ilkelerini listeler (--all dahili 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ştirir
  • aura 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ştirir
  • aura db function drop <name> [-f] — Bir Postgres SQL işlevini siler
  • aura db trigger list <table> [--json] — Bir tablodaki tüm tetikleyicileri listeler
  • aura 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ğlar
  • aura 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 listeler
  • aura db backup create [--label <label>] — Veritabanının anında anlık görüntüsünü oluşturur
  • aura 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ükler
  • aura db backup download <id> [-o <path>] — Bir yedeğin tam SQL dökümünü indirir
  • aura db backup delete <id> [-f] — Yedekleme arşivini siler
  • aura db backup schedule get [--json] — Yapılandırılmış otomatik yedekleme planına başvurur
  • aura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable] — Yedeklemelerin sıklığını ve saklama süresini yapılandırır
  • aura db apikeys list [--json] — Projeyle ilişkili etkin API anahtarlarını listeler
  • aura db apikeys create <name> [--scope anon|authenticated|service_role] — Belirli bir role sahip yeni bir API anahtarı oluşturur
  • aura 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ı listeler
  • aura 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ı id ile yazdırır)
  • aura auth users delete <id> [-f] — Bir kullanıcıyı kalıcı olarak sil
  • aura auth users ban <id> — Bir kullanıcıyı yasaklar ve aktif oturumlarını iptal eder
  • aura auth users unban <id> — Bir kullanıcının yasağını kaldırır
  • aura auth sessions list [--json] — Etkin JWT oturumları listeler
  • aura auth audit-log [--limit 50] [--json] — Güvenlik denetim günlüklerini ve bağlantı girişimlerini görüntüleyin
  • aura 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ünceller
  • aura 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üler
  • aura 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şturur
  • aura functions deploy <name> — WASM ikili dosyasına derler ve işlevi küresel ağa dağıtır
  • aura functions list [--json] — Yerel ve dağıtılan işlevleri durumlarıyla birlikte listeler
  • aura functions logs <name> — Bir işlevin gerçek zamanlı günlük akışını görüntüler
  • aura functions serve — İşlevler için yerel test sunucusunu başlatır
  • aura functions invoke <name> [--data '<json>'] — Yük ile dağıtılan bir işlevi çağırın ve test edin
  • aura functions download <name> — Uzak bir işlevin kaynak kodunu indirin
  • aura functions delete <name> [-f] — Dağıtılmış bir Edge İşlevini siler
  • aura secrets list --function <name> [--json] — Bir işlev için yapılandırılan gizli değişkenleri listeler
  • aura secrets set --function <name> KEY=VALUE... — İşleve enjekte edilen şifrelenmiş gizli dizileri tanımlar
  • aura 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ı listeler
  • aura storage cp <src> <dst> — Dosyaları aktar (yerel ↔ paket)
  • aura storage rm <path> — Bir pakette saklanan dosyayı siler
  • aura 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 listeler
  • aura storage buckets create <name> [--public] — Bir depolama paketi oluşturur
  • aura 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österir
  • aura env set KEY=VALUE... — Yerel .env dosyasında bir veya daha fazla değişkeni ayarlar
  • aura env unset KEY... — Değişkenleri yerel .env dosyasından kaldırır
  • aura ui — Tam etkileşimli TUI'yi (Terminal Kullanıcı Arayüzü) başlatır
  • aura update — CLI'yi otomatik olarak kontrol eder ve en son kararlı sürüme günceller
  • aura 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.

terminalbash
# 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
İpucu

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.

Daha ileri gitmek için#