Migrer depuis Firebase
Guide pas-à-pas pour transférer vos données Firestore, vos utilisateurs Firebase Auth et vos buckets vers l'infrastructure ouverte et performante d'Aurabase.
Correspondance des briques Firebase#
Aurabase remplace chaque composant propriétaire de Firebase par une technologie standard, ouverte et auto-hébergeable sans vendor lock-in :
FirebaseAurabaseAvantage Aurabase
Cloud FirestoreÉquivalent supérieurPostgreSQL (relationnel + SQL) OU Aurabase NoSQL (MongoDB-style)
Firebase AuthIdentique & enrichiMême support OAuth, MFA TOTP, magic links, mot de passe
Firebase StorageIdentique & enrichiAPI REST S3 SeaweedFS avec transformations d’image à la volée
Cloud FunctionsIdentiqueEdge Functions Deno standard (Deno.serve()) + WASM
Security RulesSupérieurPostgres RLS (Row-Level Security) évalué directement en base
Firebase Realtime DBIdentiqueAurabase Realtime (CDC, Presence, Broadcast via NATS/WebSockets)
Feuille de route en 4 étapes#
- Schéma & Données — Choix du modèle (relationnel PostgreSQL ou collections NoSQL) et import (15 min)
- Authentification — Export des utilisateurs Firebase Auth et import des hashes scrypt/bcrypt sans réinitialisation (10 min)
- Fichiers Storage — Synchronisation des buckets Cloud Storage vers Aurabase Storage (variable selon volume)
- Remplacement du SDK — Remplacement de
firebase/*par@aurabase/aurabase-js
De Firestore vers Aurabase#
Vous pouvez soit normaliser vos données dans PostgreSQL pour profiter de la puissance de SQL et du typage strict, soit les importer directement dans le moteur NoSQL Document Store d'Aurabase :
Feuille de route — non disponible. Les commandes aura ci-dessous sont prévues et pas encore livrées : le CLI ne les a pas aujourd'hui.
# 1. Export Firestore to JSONL file
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Import into the Aurabase NoSQL engine
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. Generating complete TypeScript types
npx @aurabase/gen --out src/aurabase.types.ts
Migration des utilisateurs sans friction#
Feuille de route — non disponible. La commande aura auth import et l'import des hachages de mot de passe Firebase (scrypt) sont prévues et pas encore livrées : la CLI et Aurabase Auth ne les ont pas aujourd'hui. D'ici là, créez les utilisateurs avec l'API d'administration (aura.authAdmin.createUser) et demandez-leur de définir un nouveau mot de passe ou de se connecter avec un lien magique.
Le plan : conserver les hachages de mot de passe de Firebase afin que les utilisateurs conservent leurs informations d'identification sans réinitialisation de mot de passe.
# Export des utilisateurs depuis Firebase CLI
firebase auth:export users.json --format=JSON --project my-firebase-app
# Import dans Aurabase Auth (préserve les hashes & tokens)
aura auth import users.json --provider firebase --env prod
Synchronisation des buckets S3#
Aurabase Storage utilise une API S3 standard. Vous pouvez synchroniser vos fichiers en continu depuis Google Cloud Storage avec l'utilitaire rclone ou aws-cli :
# Transfert direct de GCS vers 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 $AURABASE_SERVICE_ROLE_KEY \
--progress
Remplacement du SDK Client#
// AVANT (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// APRÈS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()