Migrar desde Firebase
Guía paso a paso para mover los datos de Firestore, los usuarios de autenticación de Firebase y los depósitos a la infraestructura abierta y de alto rendimiento de Aurabase.
Combinando ladrillos Firebase#
Aurabase reemplaza cada componente propietario Firebase con tecnología estándar, abierta y de autohospedaje sin dependencia del proveedor:
| Firebase | Comparación | Aurabase equivalente |
|---|---|---|
Cloud Firestore | Equivalente superior | PostgreSQL (relacional y SQL) o Aurabase NoSQL (estilo MongoDB) |
Firebase Auth | Igual, enriquecido | Mismo soporte OAuth, más TOTP MFA, enlaces mágicos y contraseñas |
Firebase Storage | Igual, enriquecido | API REST compatible con S3(SeaweedFS) con transformaciones de imágenes sobre la marcha |
Cloud Functions | Lo mismo | Edge Functions en estándar Deno (Deno.serve()) y WASM |
Security Rules | superiores | Postgres RLS (seguridad a nivel de fila), evaluada en la base de datos |
Firebase Realtime DB | Lo mismo | Aurabase Tiempo real (captura, presencia y transmisión de datos de cambios a través de NATS y WebSockets) |
Hoja de ruta de 4 pasos#
- Esquema y datos: elección del modelo (PostgreSQL colecciones relacionales o NoSQL) e importación (15 min)
- Autenticación — Exportar Firebase Autenticar usuarios e importar hashes scrypt/bcrypt sin restablecer (10 min)
- Archivos de almacenamiento: sincronización de depósitos de Cloud Storage con el almacenamiento Aurabase (variable según el volumen)
- Reemplazo de SDK — Reemplazo de
firebase/*con@aurabase/aurabase-js
De Firestore a Aurabase#
Puede normalizar sus datos en PostgreSQL para aprovechar el poder de SQL y la escritura estricta, o importarlos directamente al motor NoSQL Document Store de Aurabase:
Hoja de ruta: no disponible. Los comandos aura que se muestran a continuación están planificados y aún no se han entregado: la CLI no los tiene en la actualidad.
# 1. Exportar Firestore a un archivo JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Importar al motor NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. Generando tipos TypeScript completos
npx @aurabase/gen --out src/aurabase.types.ts
Migración de usuarios sin fricciones#
Hoja de ruta: no disponible. El comando aura auth import y la importación de hash de contraseña Firebase (scrypt) están planificados y aún no se entregan: la CLI y la autenticación Aurabase no los tienen hoy. Hasta entonces, cree los usuarios con la API de administración (aura.authAdmin.createUser) y pídales que establezcan una nueva contraseña o inicien sesión con un enlace mágico.
El plan: mantener los hashes de contraseña de Firebase para que los usuarios conserven sus credenciales sin restablecer la contraseña.
# Exportar usuarios desde Firebase CLI
firebase auth:export users.json --format=JSON --project my-firebase-app
# Importar a Aurabase Auth (conserva hashes y tokens)
aura auth import users.json --provider firebase --env prod
Sincronizando depósitos S3#
Aurabase Storage utiliza una API S3 estándar. Puedes sincronizar tus archivos continuamente desde Google Cloud Storage con la utilidad rclone o aws-cli:
# Transferencia directa desde GCS al almacenamiento 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
Reemplazo del SDK del cliente#
// ANTES (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// DESPUÉS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()