Migrar de Firebase
Guia passo a passo para mover dados do Firestore, usuários do Firebase Auth e buckets para a infraestrutura aberta e de alto desempenho do Aurabase.
Tijolos Firebase correspondentes#
Aurabase substitui cada componente proprietário Firebase por tecnologia padrão, aberta e de auto-hospedagem, sem dependência de fornecedor:
| Firebase | Comparação | Aurabase equivalente |
|---|---|---|
Cloud Firestore | Equivalente superior | PostgreSQL (relacional e SQL) ou Aurabase NoSQL (estilo MongoDB) |
Firebase Auth | Igual, enriquecido | Mesmo suporte OAuth, mais TOTP MFA, links mágicos e senhas |
Firebase Storage | Igual, enriquecido | API REST compatível com S3(SeaweedFS) com transformações de imagem dinâmicas |
Cloud Functions | Igual | Edge Functions no padrão Deno (Deno.serve()) e WASM |
Security Rules | Superior | Postgres RLS (segurança em nível de linha), avaliada no banco de dados |
Firebase Realtime DB | Igual | Aurabase Tempo real (alterar captura de dados, presença e transmissão por NATS e WebSockets) |
Roteiro de 4 etapas#
- Esquema e Dados — Escolha do modelo (coleções PostgreSQL relacionais ou NoSQL) e importação (15 min)
- Autenticação — Exporte usuários Firebase Auth e importe hashes scrypt/bcrypt sem redefinir (10 min)
- Arquivos de armazenamento — Sincronização de buckets do Cloud Storage com o armazenamento Aurabase (variável dependendo do volume)
- Substituição do SDK — Substituindo
firebase/*por@aurabase/aurabase-js
Do Firestore para Aurabase#
Você pode normalizar seus dados em PostgreSQL para aproveitar o poder do SQL e a digitação estrita ou importá-los diretamente para o mecanismo NoSQL Document Store de Aurabase:
Roteiro — não disponível. Os comandos aura mostrados abaixo estão planejados e ainda não foram entregues: a CLI não os possui hoje.
# 1. Exporte o Firestore para arquivo JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Importe para o mecanismo NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. Gerando tipos TypeScript completos
npx @aurabase/gen --out src/aurabase.types.ts
Migração de usuários sem complicações#
Roteiro — não disponível. O comando aura auth import e a importação de hashes de senha Firebase (scrypt) estão planejados e ainda não foram entregues: a CLI e o Aurabase Auth não os possuem hoje. Até então, crie os usuários com a API admin (aura.authAdmin.createUser) e faça com que definam uma nova senha ou façam login com um link mágico.
O plano: manter os hashes de senha de Firebase para que os usuários mantenham suas credenciais sem redefinir a senha.
# Exportando usuários da CLI Firebase
firebase auth:export users.json --format=JSON --project my-firebase-app
# Importe para Aurabase Auth (preserva hashes e tokens)
aura auth import users.json --provider firebase --env prod
Sincronizando intervalos S3#
Aurabase O armazenamento usa uma API S3 padrão. Você pode sincronizar seus arquivos continuamente do Google Cloud Storage com o utilitário rclone ou aws-cli:
# Transferência direta do GCS para o armazenamento 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
Substituindo o SDK do cliente#
// ANTES (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// DEPOIS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()