W Aurabase narzuciliśmy sobie silne ograniczenia już na etapie projektowania: powierzchnia SDK i konwencje RLS musiały być kompatybilne z z Supabase. Te same zasady createClient(), te same .from().select().eq(), te same zasady SQL Postgres. Pomysł: jeśli chcesz odejść, odejdź – my sprawiamy, że jest to trywialne. Oto pełna instrukcja gry.
Co się rusza, co zostaje
Zanim zaczniesz, wypisz, co się zmieni, a co pozostanie. Spoiler: większość pozostaje.
| Postgres Schemat | TO SAMO | pg_dump → pg_restore. Rozszerzenia, wyzwalacze, funkcje, indeksy — wszystko jest dozwolone. |
|---|---|---|
| RLS Zasady | TO SAMO | Ta sama składnia. auth.uid(), auth.role(), auth.jwt() działają bez zmian. |
| SDK JavaScriptu | 95% IDENTYCZNE | Zamień @supabase/supabase-js na @aurabase/aurabase-js. Ten sam łańcuchowy interfejs API. |
| Przepływy uwierzytelniania | TO SAMO | signUp,signInWithPassword,signInWithOAuth,mfa — te same nazwy, te same podpisy. |
| Interfejs API pamięci masowej | TO SAMO | aura.storage.from(bucket).upload(...) · kompatybilność S3 · zasady zbywalne RLS. |
| W czasie rzeczywistym | TO SAMO | kanał().on("postgres_changes", ...) bez zmian. Obecność + transmisja tak samo. |
| Edge Functions | TO SAMO | Deno.serve() wklejono w niezmienionej postaci do edytora Studio. W interfejsie CLI funkcje zostaną wdrożone w osobnej ścieżce (Rust skompilowany do WASM). |
| Panel | RÓŻNY | Studio Aurabase · pomagamy Ci odnaleźć orientację. |
Utwórz docelowy projekt Aurabase
Utwórz nowy projekt Aurabase za pomocą oficjalnego interfejsu CLI, a następnie połącz ten folder z projektem, aby automatycznie zastosować się do niego następujące polecenia.
# Konto Aurabase + CLI
npm i -g @aurabase/cli
aura login
# Utwórz projekt (silnik Postgres)
aura projects create my-app --engine postgres
# Połącz ten folder z utworzonym projektem
aura link --project-id <uuid-du-projet>
# Pobierz klucze API połączonego projektu
aura projects api-keys
Zrzuć Supabase, przywróć Aurabase
Standardowy pg_dump / pg_restore: Aurabase udostępnia bezpośredni ciąg połączenia Postgres dla każdego projektu (Studio → Ustawienia → Połączenie), bez potrzeby pośredniej transformacji.
# Pobierz parametry połączenia Supabase z ich pulpitu nawigacyjnego
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Zrzut schematu publicznego (bez schematów systemowych Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Pobierz parametry połączenia Aurabase (Studio → Ustawienia → Połączenie)
# Parametr ?search_path= jest OBOWIĄZKOWY: kieruje do schematu Twojego projektu
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Przywróć za pomocą standardowego pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Wygeneruj ponownie typy TypeScript
aura db generate > src/aurabase.types.ts
Przeprowadź migrację użytkowników
Należy poprawić w porównaniu z tym, co powiedzieliśmy wcześniej: Aurabase miesza hasła za pomocą Argon2id, ale Supabase (GoTrue) domyślnie miesza hasła za pomocą bcrypt — te dwa formaty nie są zamienne. Dlatego Twoi użytkownicy będą musieli jednorazowo zresetować hasło, jak w przypadku większości migracji.
Aurabase nie oferuje obecnie narzędzia do masowego importu z Supabase. Dwie opcje: pozwól użytkownikom ponownie się zarejestrować (signUp z tym samym adresem e-mail) lub utwórz ich jeden po drugim po stronie administratora za pomocą aura auth users create --email <email> przed uruchomieniem resetowania hasła.
Aktywne sesje po stronie Supabase nie są przenoszone (technicznie niemożliwe — każda platforma podpisuje swoje JWT własnym kluczem). Użytkownicy będą musieli zalogować się ponownie, podając nowe hasło.
Dostosuj kod klienta
W 95% przypadków wystarczy wyszukiwanie/zamiana.
// PRZED (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// PO (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// Pozostała część kodu nie ulega zmianie:
await aura.from('posts').select('*').eq('author_id', userId)
Wdróż Edge Functions
Aurabase oferuje dwie ścieżki dla Edge Functions: edytor kodu Studio ( środowisko wykonawcze Deno, takie samo jak Supabase — wklej swoją funkcję w niezmienionej postaci) i interfejs CLI aura functions deploy, którego celem jest osobna ścieżka dla funkcji napisanych w Rust i skompilowanych w WASM. Aby przeprowadzić migrację istniejącego kodu Deno bez przepisywania, użyj pliku Studio.
// Działa tak samo, wklejony do edytora Studio
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
Przełączenie DNS i uruchomienie produkcji
Dwie możliwe strategie. Pierwszy jest zalecany w 99% przypadków.
- Bezpośrednie przejście — zmień
NEXT_PUBLIC_AURABASE_URLiNEXT_PUBLIC_AURABASE_ANON_KEYw zmiennych środowiskowych, wdróż ponownie. Użytkownicy łączą się ponownie, wszystko działa. Zalecany do większości projektów. - Tymczasowy podwójny zapis — zapisz Supabase + Aurabase jednocześnie przez 48 godzin, ręcznie sprawdź spójność krytycznych tabel (liczenie wierszy, sumy kontrolne), a następnie zamknij Supabase. Preferowany w przypadku krytycznych aplikacji.
Jesteśmy tu, jeśli coś utknie
W przypadku dużych projektów lub przy rygorystycznych ograniczeniach związanych ze zgodnością nasz zespół może pomóc Ci w migracji. Skontaktuj się z nami, aby uzyskać ofertę dostosowaną do Twojego projektu.