Aurabase'de kendimize tasarım aşamasından itibaren güçlü bir kısıtlama verdik: SDK yüzeyi ve RLS sözleşmelerinin ile ile Supabase ile uyumlu olması gerekiyordu. Aynı createClient(), aynı .from().select().eq(), aynı SQL Postgres politikaları. Fikir: Eğer ayrılmak istiyorsan git; biz bunu önemsiz hale getiriyoruz. İşte tam taktik kitabı.
Ne hareket eder, ne kalır
Başlamadan önce nelerin değişeceğini, nelerin kalacağını listeleyin. Spoiler: çoğunluk kalıyor.
| Postgres Şeması | AYNI | pg_dump → pg_restore. Uzantılar, tetikleyiciler, işlevler, dizinler; her şey yolunda. |
|---|---|---|
| RLS Politikalar | AYNI | Aynı sözdizimi. auth.uid(), auth.role(), auth.jwt() olduğu gibi çalışır. |
| JavaScript SDK'sı | %95 AYNI | @supabase/supabase-js'yi @aurabase/aurabase-js ile değiştirin. Aynı zincirlenebilir API. |
| Kimlik doğrulama akışları | AYNI | SignUp, SignInWithPassword, SignInWithOAuth, MFA — aynı adlar, aynı imzalar. |
| Depolama API'si | AYNI | aura.storage.from(bucket).upload(...) · uyumlu S3 · aktarılabilir RLS politikaları. |
| Gerçek zamanlı | AYNI | channel().on("postgres_changes", ...) değişmedi. Varlık + yayın aynı. |
| Edge Functions | AYNI | Deno.serve() Studio düzenleyicisine olduğu gibi yapıştırıldı. CLI, ayrı bir yolu hedefleyen işlevlere sahip olacaktır (Rust WASM olarak derlenmiştir). |
| Kontrol Paneli | FARKLI | Studio Aurabase · yönünüzü bulmanıza yardımcı oluyoruz. |
Hedef Aurabase projesini oluşturun
Resmi CLI ile yeni bir Aurabase projesi oluşturun ve ardından aşağıdaki komutların otomatik olarak uygulanabilmesi için bu klasörü projeye bağlayın.
# Aurabase hesap + CLI
npm i -g @aurabase/cli
aura login
# Projeyi oluşturun (Postgres motoru)
aura projects create my-app --engine postgres
# Bu klasörü oluşturulan projeye bağlayın
aura link --project-id <uuid-du-projet>
# Bağlantılı projenin API anahtarlarını alın
aura projects api-keys
Supabase dosyasını boşaltın, Aurabase dosyasını geri yükleyin
Standart bir pg_dump / pg_restore: Aurabase her proje için doğrudan bir Postgres bağlantı dizesi sunar (Stüdyo → Ayarlar → Bağlantı), ara dönüşüme gerek yoktur.
# Supabase bağlantı dizesini kontrol panelinden alın
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Genel şema dökümü (Supabase sistem şemaları olmadan)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Aurabase bağlantı dizesini alın (Studio → Ayarlar → Bağlantı)
# ?search_path= parametresi ZORUNLUDUR: projenizin şemasına yönlendirir
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Standart pg_restore ile geri yükleyin
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# TypeScript türlerini yeniden oluştur
aura db generate > src/aurabase.types.ts
Kullanıcıları taşı
Daha önce burada belirttiğimiz ile karşılaştırıldığında düzeltilmesi gereken bir nokta: Aurabase, şifreleri Argon2id ile hashler, ancak Supabase (GoTrue), varsayılan olarak bcrypt ile kendi hashingini yapar — iki format birbirinin yerine kullanılamaz. Bu nedenle kullanıcılarınızın çoğu geçişte olduğu gibi şifrelerini bir kez sıfırlamaları gerekecektir.
Aurabase şu anda Supabase'den toplu içe aktarma aracı sunmamaktadır. İki seçenek: kullanıcılarınızın kendilerini yeniden kaydetmelerine izin verin (aynı e-posta adresiyle signUp) veya parola sıfırlamayı tetiklemeden önce onları yönetici tarafında aura auth users create --email <email> ile birer birer yeniden oluşturun.
Supabase tarafındaki aktif oturumlar taşınmaz (teknik olarak imkansızdır; her platform JWT'lerini kendi anahtarıyla imzalar). Kullanıcıların yeni şifreleriyle tekrar giriş yapmaları gerekecektir.
İstemci kodunu uyarlayın
Vakaların %95'i için arama/değiştirme yeterlidir.
// ÖNCE (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// SONRA (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// Kodun geri kalanı değişmez:
await aura.from('posts').select('*').eq('author_id', userId)
Edge Functions'yi dağıtın
Aurabase, Edge Functions için iki yol sunar: Studio kod düzenleyicisi (Deno çalışma zamanı, Supabase ile aynı — işlevinizi olduğu gibi yapıştırın) ve Rust ile yazılan ve WASM ile derlenen işlevler için ayrı bir yol hedefleyen aura functions deployCLI. Mevcut Deno kodunu yeniden yazmadan taşımak için Studio'yu kullanın.
// Aynı şekilde çalışır, Studio düzenleyicisine olduğu gibi yapıştırılır
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNS geçişi ve üretimin başlatılması
İki olası strateji. İlki vakaların %99'u için önerilir.
- Doğrudan geçiş — ortamınızdaki
NEXT_PUBLIC_AURABASE_URLveNEXT_PUBLIC_AURABASE_ANON_KEYöğelerini değiştirin, yeniden konuşlandırın. Kullanıcılar yeniden bağlanıyor, her şey çalışıyor. Çoğu proje için önerilir. - Geçici çift yazma — 48 saat boyunca aynı anda Supabase + Aurabase içine yazın, kritik tabloların tutarlılığını manuel olarak kontrol edin (satır sayımı, sağlama toplamları), ardından Supabase kapatın. Kritik uygulamalar için tercih edilir.
İşler sıkışırsa buradayız
Büyük projelerde veya katı uyumluluk kısıtlamalarına sahip projelerde ekibimiz geçiş konusunda size destek olabilir. Projenize özel teklif için bizimle iletişime geçin.