Dağıtım
Sıfır kesinti süreli geçişler, atomik geri alma, GitHub Eylemler / GitLab / CLI aracılığıyla CI/CD ve veritabanı dalları: üretim öncesinde bir geçişi veya politikayı test etmek için bir projenin kopyası.
Üç dağıtım yüzeyi#
Bir Aurabase projesi dağıtılacak üç yüzeyi kullanıma sunar: Postgres şema (sürümlendirilmiş SQL geçişleri), uç işlevleri (WASM + cron + işler), ilkeler ve sırlar (RLS, env) değişkenler, OAuth uygulamalar). Her biri aura CLI aracılığıyla kendisini bağımsız olarak iter.
CLI (aura), aynı zamanda npm install -g @aurabase/cli ile kurulabilen tek bir ikili dosyadır ve kuru çalışmayı, onaylama istemlerini ve fark önizlemesini destekler. Linux/macOS/Windows uyumludur.
Geliştirme, önizleme, üretim#
Varsayılan olarak bir projenin iki ortamı vardır: dev (yerel, Kubernetes) ve prod (bulut). Üretimden önce verilerinizin bir kopyasında değişiklik yapmayı denemek için veritabanı dalı oluşturun.
LOCAL DEV
$ ./start.sh → full local stack (k3d)
$ aura dev → watch mode + types gen
BRANCH (copy of a project, deleted by its TTL)
$ aura branch create pr-142 --from my-app --ttl 3d
$ aura db push → on the branch project, to try the migration
$ aura branch delete pr-142
PRODUCTION
merge to main → CI run: aura db push
→ aura deploy functions
Sürümlendirilmiş SQL, atomik geri alma#
Taşıma işlemleri aurabase/migrations içinde gerçekleşir. Değişiklik başına bir dosya, önekte zaman damgası. CLI eksik geçişleri bağlı projeye uygular; bir değişiklikten sonra TypeScript türlerinizi npx @aurabase/gen ile yeniden oluşturun.
# Yeni bir taşıma oluştur
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql
# Hangi taşıma işlemlerinin uygulandığını veya beklemede olduğunu görün ve ardından bunları bağlantılı projeye uygulayın
aura db status
aura db push
# TypeScript türlerini yeniden oluştur
npx @aurabase/gen --out src/aurabase.types.ts
# Uygulanan taşıma işlemlerini listeleme
aura db migration list
Sıfır kesinti süreli geçişler. Kurallara uyun: önce null yapılabilir sütun ekleyin, dolguyu ayırın, son olarak NOT NULL kısıtlamasını ekleyin. CLI sizin için geriye dönük uyumluluğu kontrol etmez: aura db push öncesindeki yıkıcı ifadeleri (drop column, alter column … type) gözden geçirin.
Veritabanı şubeleri#
Dal, mevcut bir PostgreSQL projesinden kopyalanmış yeni bir proje'dir: şeması, satır düzeyinde güvenlik politikaları, işlevleri, tetikleyicileri, görünümleri ve (yalnızca şemayı istemediğiniz sürece) satırları. Kendi URL'sine, API anahtarlarına ve veritabanına sahiptir; böylece kaynağa dokunmadan bir taşıma işlemini çalıştırabilir, bir politikayı test edebilir veya bir önizleme dağıtımını ona yönlendirebilirsiniz. Şubeler, yaşam süreleri sona erdiğinde otomatik olarak silinir.
# Bağlantılı projeden (aura bağlantısı), varsayılan olarak 72 saat
aura branch create feat/new-checkout
# Başka bir projeden 7 gün tutuldu
aura branch create pr-142 --from my-app --ttl 7d
# Yalnızca şema: hiçbir satır kopyalanmaz, diziler baştan başlar
aura branch create schema-test --no-data
aura branch list # bağlantılı projenin şubeleri
aura branch list --all # örgütün her şubesi
aura branch delete feat/new-checkout
aura branch create dal hazır olana kadar bekler, ardından URL'sini ve API anahtarlarını yazdırır, yalnızca bir kez gösterilir aura projects create'deki gibi (--json bunları komut dosyaları için yazdırır). Hemen geri dönmek için --no-wait kullanın ve onu aura branch list ile takip edin. Dal bir projedir: aura link --project-id <id> ile bir klasörü ona bağlayın ve geçişi denemek için orada aura db push çalıştırın.
Dal, canlı bir kopya veya yazma sırasında kopyalanan bir klon değil, oluşturma sırasında oluşturulan bir kopyadır: daha sonra hiçbir şey kaynağa veya kaynaktan geri akmaz. Platform, kaynağı tek bir tutarlı anlık görüntüde okur ve satırları şube veritabanına kopyalar, böylece zaman verilerle orantılı olur. Yerel test yığınında, 350.000 satırdan oluşan 333 MB'lık bir tablo 14 saniyede klonlandı. Daha sonra dalda çalışan bir geçiş, olağan aura db push ile üretime uygulanır.
Sınırlar, tam olarak#
| Kimler oluşturabilir? | Etkin olan ve hazırda bekletme modunda olmayan bir PostgreSQL projesinden developer veya daha fazla role sahip üyeler. Bir MongoDB projesi reddedildi. |
| Bir şubeyi dallandırma | Reddedildi: şubeyi ana projeden oluşturun. |
| Ad | Harfler, rakamlar, ., _, - ve /, en fazla 63 karakter, canlı dallar arasında proje başına benzersiz (büyük/küçük harfe duyarlı değildir). |
| Yaşama zamanı | Varsayılan olarak 72 saat, 1 saatten 30 güne kadar (--ttl 1h - --ttl 30d arası). Süresi dolan şube ve veritabanı, son teslim tarihinden yaklaşık bir dakika sonra otomatik olarak silinir. Daha önce silebilirsiniz. |
| Plan sınırı | Bir şube proje sınırınıza (max_projects) göre sayılmaz; kuruluş başına kendi aktif şube sınırı vardır (max_branches): Ücretsiz'de 1, Pro'da 10, Takım'da 25. Bunu geçtikten sonra, oluşturma işlemi BRANCH_LIMIT_REACHED ile reddedilir. Başarısız bir dal sayılmaz. sınırlarına bakın. |
| Veri boyutu | Satırların akışı sağlanır, bellekte tutulmaz, dolayısıyla 32 MiB tavanı yoktur. Tablolar dağıtım sınırından fazlasını tuttuğunda klonlama birkaç saniye içinde reddedilir (varsayılan olarak 2 GiB, BRANCH_CLONE_MAX_BYTES ana bilgisayarını barındırdığınızda Aurabase): mesaj boyutu verir ve --no-data önerisini yapar. Bir klon da 30 dakika sonra durur. |
Klonlanmayan şey#
- Klonlanmış: tablolar ve satırları, sütun türleri, varsayılanlar, kimlik sütunları, diziler ve bunların geçerli değerleri, kısıtlamalar, dizinler, satır düzeyinde güvenlik (etkin, zorunlu, politikalar), SQL işlevleri ve prosedürleri, tetikleyiciler, görünümler ve materyalleştirilmiş görünümler, numaralandırma türleri ve bunların tamamındaki ayrıcalıklar.
- Klonlanmadı: kimlik doğrulama kullanıcıları, oturumlar ve kimlik doğrulama ayarları; depolama kovaları ve nesneler; uç işlevler, sırlar, ortam değişkenleri ve cron işleri; gerçek zamanlı tablo ayarları (şubede yeniden etkinleştirin);
@graphqlyönergeleri dahil tablo ve sütun yorumları; sütun düzeyinde ayrıcalıklar; pg_graphql aktivasyonu (daldaaura projects graphql-enable). Nesneler şubenin yönetici rolüne aittir. - Reddedildi (dal eksik olurdu): bölümlenmiş ve devralınan tablolar, yabancı tablolar, alanlar, bileşik ve aralık türleri, toplama işlevleri, yeniden yazma kuralları, başka bir şemaya işaret eden yabancı anahtarlar ve platformun her projeye yüklediği uzantılar dışındaki uzantılar.
Kopyalamadan hemen önce okunduğu için şemadan bir dal oluşturulur. Dal oluşturulurken kaynağın şemasını (aura db push, DDL) değiştirmeyin.
Oluşturma başarısız olduğunda#
Geride hiçbir şey kalmadı. Kopya, şube veritabanında tek bir işlemde çalışır; herhangi bir hata durumunda geri alınır, şube projesi silinir ve aura branch create nedeni yazdırılır (örneğin, kopyalanamayan nesne). Başarısız olan dal, mesajıyla birlikte 24 saat boyunca aura branch list içinde görünür kalır ve adı tekrar serbest kalır. Veritabanı hizmeti bir kopyanın ortasında yeniden başlatılırsa dalın başarısız olduğu bildirilir ve 45 dakika sonra silinir.
Üç entegrasyon hazır#
CLI herhangi bir CI ile çalışır. İşte en yaygın üçünün tarifleri.
name: Deploy to Aurabase
on:
push: { branches: [main] }
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g @aurabase/cli # veya ikili dosyayı sürüm sayfasından indirin
- run: aura login --token ${{ secrets.AURA_PAT }} # Kişisel Erişim Jetonu aura_pat_*
- run: aura link ${{ vars.AURA_PROJECT_ID }}
- run: aura db push
- run: aura deploy functions
Ortam başına bir projeyi (bir hazırlama projesi ve bir üretim projesi) bağlayın ve her birine karşı aynı işlem hattını çalıştırın. --env bayrağı yok: hedef, klasörün bağlı olduğu projedir.
Atomik, aşağı göç yoluyla#
Her 20260415_xxx.sql geçişinin yanında bir 20260415_xxx.down.sql dosyası bulunabilir. aura db migration down [n], uygulanan son n geçişlerin .down.sql dosyasını çalıştırır ve bunları geçmişten kaldırır; komut sunucunun cevabını kontrol eder ve hiçbir şey geri alınmazsa başarısız olur. .down.sql içermeyen bir geçiş yalnızca geçmişten kaldırılır ve CLI bunu belirtir.
# Son uygulanan geçişi geri alın (.down.sql dosyasını çalıştırır)
aura db migration down
# Son üçünü geri al
aura db migration down 3
# Şemaya dokunmadan geçmişi düzeltin (elle uygulanan bir geçiş, başarısız bir geçiş)
aura db migration repair 20260415120000_add_devices_table.sql --applied
# Başarısız bir geçiş, kendi işleminde iptal edilir: geri döndürülecek bir şey yoktur.
# Tüm veritabanının belirli bir zamanda kurtarılması yedeklemelerden geçer (aura db backup restore <id> --yes)
Belirli bir noktaya kurtarma henüz bir self servis komutuna sahip değil. Kendiniz gerçekleştireceğiniz bir geri yükleme için aura db backup create / aura db backup restore <id> --yes anlık görüntülerini kullanın; geri yükleme veritabanının üzerine yazar, bu nedenle önce yeni bir yedek alın.