본문으로 건너뛰기
아우라베이스 로고
아우라베이스

Firebase에서 마이그레이션

Firestore 데이터, Firebase 인증 사용자 및 버킷을 Aurabase의 개방형 고성능 인프라로 이동하는 방법에 대한 단계별 가이드입니다.

방법 가이드11분 읽기레벨 중급2026. 8. 19.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

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단계 로드맵#

  1. 스키마 및 데이터 — 모델 선택(PostgreSQL 관계형 또는 NoSQL 컬렉션) 및 가져오기(15분)
  2. 인증 — Firebase 인증 사용자 내보내기 및 재설정 없이 scrypt/bcrypt 해시 가져오기(10분)
  3. 스토리지 파일 — Cloud Storage 버킷을 Aurabase 스토리지에 동기화(볼륨에 따라 다름)
  4. SDK 교체 — firebase/*를 @aurabase/aurabase-js로 교체

Firestore에서 Aurabase까지#

PostgreSQL에서 데이터를 정규화하여 SQL 및 엄격한 유형 지정의 기능을 활용하거나 Aurabase의 NoSQL 문서 저장소 엔진으로 직접 가져올 수 있습니다.

주의

로드맵 — 사용할 수 없습니다. 아래에 표시된 aura 명령은 계획되었지만 아직 제공되지 않았습니다. 현재 CLI에는 해당 명령이 없습니다.

import-firestore.shbash
# 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의 비밀번호 해시를 유지합니다.

migrate-auth.shbash
# 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에서 파일을 지속적으로 동기화할 수 있습니다.

sync-buckets.shbash
# 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 교체#

comparison.tstypescript
// 이전(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()

더 나아가려면#