Aurabase에서는 설계 단계부터 강력한 제약을 두었습니다. SDK 표면과 RLS 규칙은 Supabase와 드롭인 호환되어야 했습니다. 동일한 createClient(), 동일한 .from().select().eq(), 동일한 SQL Postgres 정책. 아이디어: 떠나고 싶으면 떠나세요. 우리는 그것을 사소한 일로 만듭니다. 전체 플레이북은 다음과 같습니다.
움직이는 것, 남는 것
시작하기 전에 무엇이 바뀌고 무엇이 남을지 나열해 보세요. 스포일러: 대다수가 남아있습니다.
| Postgres 스키마 | 동일 | pg_dump → pg_restore. 확장, 트리거, 함수, 인덱스 등 모든 것이 가능합니다. |
|---|---|---|
| RLS 정책 | 동일 | 동일한 구문. auth.uid(), auth.role(), auth.jwt()는 그대로 작동합니다. |
| 자바스크립트 SDK | 95% 동일 | @supabase/supabase-js를 @aurabase/aurabase-js로 바꿉니다. 동일한 체인 가능 API. |
| 인증 흐름 | 동일 | signUp, signInWithPassword, signInWithOAuth, mfa — 동일한 이름, 동일한 서명. |
| 스토리지 API | 동일 | aura.storage.from(bucket).upload(...) · S3 호환 · 전송 가능한 RLS 정책. |
| 실시간 | 동일 | 채널().on("postgres_changes", ...)은 변경되지 않았습니다. 존재 + 방송 동일합니다. |
| Edge Functions | 동일 | Deno.serve()를 그대로 Studio 편집기에 붙여넣었습니다. CLI에는 별도의 경로(Rust 로 컴파일된 WASM)를 겨냥한 함수 배포가 있습니다. |
| 대시보드 | 다른 | Studio Aurabase · 귀하의 방향을 찾는 데 도움을 드립니다. |
대상 Aurabase 프로젝트 생성
공식 CLI를 사용하여 새 Aurabase 프로젝트를 생성한 후 이 폴더를 프로젝트에 연결하면 다음 명령이 자동으로 적용됩니다.
# Aurabase 계정 + CLI
npm i -g @aurabase/cli
aura login
# 프로젝트 생성(Postgres 엔진)
aura projects create my-app --engine postgres
# 이 폴더를 생성된 프로젝트에 연결
aura link --project-id <uuid-du-projet>
# 연결된 프로젝트의 API 키를 검색하세요.
aura projects api-keys
Supabase덤프, Aurabase 복원
표준 pg_dump / pg_restore: Aurabase는 각 프로젝트(Studio → 설정 → 연결)에 대해 직접 Postgres 연결 문자열을 노출하므로 중간 변환이 필요하지 않습니다.
# 대시보드에서 Supabase 연결 문자열을 검색합니다.
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# 공개 스키마 덤프(Supabase 시스템 스키마 없음)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Aurabase 연결 문자열 검색(Studio → 설정 → 연결)
# ?search_path= 매개변수는 필수입니다. 프로젝트의 스키마로 라우팅됩니다.
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# 표준 pg_restore를 사용하여 복원
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# TypeScript 유형 재생성
aura db generate > src/aurabase.types.ts
사용자 마이그레이션
이전에 여기에 언급한 내용과 비교하여 수정해야 할 점: Aurabase는 Argon2id로 비밀번호를 해시하지만 Supabase(GoTrue)는 기본적으로 bcrypt를 사용하여 자체적으로 해시합니다. 두 형식은 서로 바꿔 사용할 수 없습니다. 따라서 사용자는 대부분의 마이그레이션과 마찬가지로 비밀번호를 한 번 재설정해야 합니다.
Aurabase는 현재 Supabase에서 대량 가져오기 도구를 제공하지 않습니다. 두 가지 옵션: 사용자가 스스로 재등록하도록 하거나(동일한 이메일 주소로signUp), 비밀번호 재설정을 실행하기 전에 관리자 측에서 aura auth users create --email <email>를 사용하여 사용자를 하나씩 다시 생성하세요.
Supabase 측의 활성 세션은 포팅되지 않습니다(기술적으로 불가능합니다. 각 플랫폼은 자체 키로 JWT에 서명합니다). 사용자는 새 비밀번호를 사용하여 다시 로그인해야 합니다.
클라이언트 코드 조정
검색/바꾸기는 95%의 경우에 충분합니다.
// 이전(Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// 이후(Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// 나머지 코드는 변경되지 않습니다.
await aura.from('posts').select('*').eq('author_id', userId)
Edge Functions 배포
Aurabase는 Edge Functions에 대한 두 가지 경로를 제공합니다. Studio 코드 편집기(Deno 런타임, Supabase와 동일 — 함수를 있는 그대로 붙여넣기)와 Rust에서 작성되고 WASM에서 컴파일된 함수에 대한 별도의 경로를 목표로 하는 aura functions deployCLI입니다. 다시 작성하지 않고 기존 Deno 코드를 마이그레이션하려면 Studio를 사용하세요.
// 동일하게 작동하며 Studio 편집기에 그대로 붙여넣습니다.
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNS 전환 및 생산 개시
두 가지 가능한 전략. 첫 번째 방법은 99%의 경우에 권장됩니다.
- 직접 컷오버 — 환경 변수에서
NEXT_PUBLIC_AURABASE_URL및NEXT_PUBLIC_AURABASE_ANON_KEY를 변경하고 재배포합니다. 사용자가 다시 연결하면 모든 것이 작동합니다. 대부분의 프로젝트에 권장됩니다. - 임시 이중 쓰기 — 48시간 동안 Supabase + Aurabase에 동시에 쓰고 중요한 테이블의 일관성을 수동으로 확인한 다음(행 계산, 체크섬) Supabase을 종료합니다. 중요한 앱에 선호됩니다.
일이 막히면 우리가 여기 있어요
대규모 프로젝트 또는 엄격한 규정 준수 제약이 있는 경우 당사 팀이 마이그레이션을 지원할 수 있습니다. 귀하의 프로젝트에 맞는 제안을 원하시면 당사에 문의하십시오.