Aller au contenu
Logo Aurabase
aurabase

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.

Guide pratique11 min de lectureNiveau intermédiaireRévisé le 19 août 2026

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#

  1. Schéma & Données — Choix du modèle (relationnel PostgreSQL ou collections NoSQL) et import (15 min)
  2. Authentification — Export des utilisateurs Firebase Auth et import des hashes scrypt/bcrypt sans réinitialisation (10 min)
  3. Fichiers Storage — Synchronisation des buckets Cloud Storage vers Aurabase Storage (variable selon volume)
  4. 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 :

Attention

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.

import-firestore.shbash
# 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#

Attention

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.

migrate-auth.shbash
# 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 :

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

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

Pour aller plus loin#