Firebase에서 마이그레이션
Firestore 데이터, Firebase 인증 사용자 및 버킷을 Aurabase의 개방형 고성능 인프라로 이동하는 방법에 대한 단계별 가이드입니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
Firebase 벽돌 일치#
Aurabase는 각 독점 Firebase 구성 요소를 공급업체 종속 없이 표준, 개방형, 자체 호스팅 기술로 대체합니다.
| Firebase | 비교 | Aurabase 상당 |
|---|---|---|
Cloud Firestore | 더 높은 수준 | PostgreSQL(관계형 및 SQL) 또는 Aurabase NoSQL(MongoDB 스타일) |
Firebase Auth | 동일, 풍부함 | 동일한 OAuth 지원, TOTP MFA, 매직 링크 및 비밀번호 |
Firebase Storage | 동일, 풍부함 | S3-즉시 이미지 변환이 가능한 호환 REST API(SeaweedFS) |
Cloud Functions | 동일 | 표준 Deno(Deno.serve()) 및 WASM의 Edge Functions |
Security Rules | 슈페리어 | Postgres RLS(행 수준 보안), 데이터베이스에서 평가됨 |
Firebase Realtime DB | 동일 | Aurabase 실시간(NATS 및 WebSocket을 통한 변경 데이터 캡처, 존재 및 브로드캐스트) |
4단계 로드맵#
- 스키마 및 데이터 — 모델 선택(PostgreSQL 관계형 또는 NoSQL 컬렉션) 및 가져오기(15분)
- 인증 — Firebase 인증 사용자 내보내기 및 재설정 없이 scrypt/bcrypt 해시 가져오기(10분)
- 스토리지 파일 — Cloud Storage 버킷을 Aurabase 스토리지에 동기화(볼륨에 따라 다름)
- SDK 교체 —
firebase/*를@aurabase/aurabase-js로 교체
Firestore에서 Aurabase까지#
PostgreSQL에서 데이터를 정규화하여 SQL 및 엄격한 유형 지정의 기능을 활용하거나 Aurabase의 NoSQL 문서 저장소 엔진으로 직접 가져올 수 있습니다.
주의
로드맵 — 사용할 수 없습니다. 아래에 표시된 aura 명령은 계획되었지만 아직 제공되지 않았습니다. 현재 CLI에는 해당 명령이 없습니다.
bash
# 1. Firestore를 JSONL 파일로 내보내기
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Aurabase NoSQL 엔진으로 가져오기
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. 완전한 TypeScript 유형 생성
npx @aurabase/gen --out src/aurabase.types.ts
원활한 사용자 마이그레이션#
주의
로드맵 — 사용할 수 없습니다. aura auth import 명령과 Firebase 비밀번호 해시(scrypt) 가져오기가 계획되어 있지만 아직 제공되지 않습니다. CLI 및 Aurabase 인증에는 현재 이러한 기능이 없습니다. 그때까지는 관리 API(aura.authAdmin.createUser)를 사용하여 사용자를 생성하고 새 비밀번호를 설정하거나 매직 링크로 로그인하도록 하세요.
계획: 사용자가 비밀번호를 재설정하지 않고도 자격 증명을 유지할 수 있도록 Firebase의 비밀번호 해시를 유지합니다.
bash
# Firebase CLI에서 사용자 내보내기
firebase auth:export users.json --format=JSON --project my-firebase-app
# Aurabase 인증으로 가져오기(해시 및 토큰 보존)
aura auth import users.json --provider firebase --env prod
S3 버킷 동기화#
Aurabase 스토리지는 표준 S3 API를 사용합니다. rclone 또는 aws-cli 유틸리티를 사용하여 Google Cloud Storage에서 파일을 지속적으로 동기화할 수 있습니다.
bash
# GCS에서 Aurabase 저장소로 직접 전송
rclone sync gcs:my-firebase-bucket s3:aurabase-storage-bucket \
--s3-endpoint https://api.aurabase.cloud/v1/storage/$PROJECT_ID \
--s3-access-key-id $AURABASE_SERVICE_ROLE_KEY \
--progress
클라이언트 SDK 교체#
typescript
// 이전(Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// 이후(Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()