아우라베이스 로고
아우라베이스문서
문서›가이드›Firebase 마이그레이션

Firebase에서 마이그레이션

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

11분 읽기·레벨 중급·2026. 8. 19.에 개정됨
이 영어 텍스트는 프랑스어 원본에서 자동으로 생성되었으며 아직 검토되지 않았습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
비교

Firebase 브릭 일치

Aurabase는 각 독점 Firebase 구성 요소를 공급업체 종속 없이 표준, 개방형, 자체 호스팅 기술로 대체합니다.

FirebaseAurabaseAurabase의 장점

Cloud Firestore더 높은 수준의 PostgreSQL(관계형 + SQL) 또는 Aurabase NoSQL(MongoDB 스타일)

Firebase Auth동일하고 강화됨 동일 OAuth 지원, MFA TOTP, 매직 링크, 비밀번호

Firebase Storage즉석 이미지 변환을 통해 동일하고 강화된 S3 MinIO REST API

Cloud FunctionsSameEdge 함수 Deno 표준(Deno.serve()) + WASM

Security RulesSuperiorPostgres RLS(행 수준 보안)는 기본에서 직접 평가됩니다.

Firebase Realtime DBSameAurabase 실시간(CDC, 존재, NATS/WebSocket을 통한 브로드캐스트)

#
지도

4단계 로드맵

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

Firestore에서 Aurabase로

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

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 유형 생성
aura db generate > src/aurabase.types.ts
#
인증

원활한 사용자 마이그레이션

Firebase의 비밀번호 해싱 알고리즘(scrypt, bcrypt, Argon2id) 지원 덕분에 사용자는 비밀번호를 재설정하지 않고도 사용자 인증 정보를 유지할 수 있습니다.

migrate-auth.shbash
# Firebase CLI에서 사용자 내보내기
firebase auth:export users.json --format=JSON --project my-firebase-app

# Aurabase Auth로 가져오기(해시 및 토큰 보존)
aura auth import users.json --provider firebase --env prod
#
저장

S3 버킷 동기화

Aurabase Storage는 표준 S3 API를 사용합니다. rclone 또는 aws-cli 유틸리티를 사용하여 Google Cloud Storage에서 파일을 지속적으로 동기화할 수 있습니다.

sync-buckets.shbash
# GCS에서 Aurabase Storage로 직접 전송
rclone sync gcs:my-firebase-bucket s3:aurabase-storage-bucket \
  --s3-endpoint https://api.aurabase.cloud/v1/storage/$PROJECT_ID \
  --s3-access-key-id $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()

// AFTER (아우라베이스)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()
마지막 업데이트 · 2026. 8. 19.