Migra da Firebase
Guida passo passo per spostare i dati Firestore, gli utenti di autenticazione Firebase e i bucket nell'infrastruttura aperta e ad alte prestazioni di Aurabase.
Mattoncini Firebase corrispondenti#
Aurabase sostituisce ciascun componente proprietario Firebase con una tecnologia standard, aperta e di self-hosting senza vincoli di fornitore:
| Firebase | Confronto | Aurabase equivalente |
|---|---|---|
Cloud Firestore | Equivalente più alto | PostgreSQL (relazionale e SQL) o Aurabase NoSQL (stile MongoDB) |
Firebase Auth | Uguale, arricchito | Stesso supporto OAuth, oltre a TOTP MFA, collegamenti magici e password |
Firebase Storage | Uguale, arricchito | S3-API REST compatibile (SeaweedFS) con trasformazioni di immagini al volo |
Cloud Functions | Lo stesso | Edge Functions su standard Deno (Deno.serve()) e WASM |
Security Rules | Superiore | Postgres RLS (sicurezza a livello di riga), valutato nel database |
Firebase Realtime DB | Lo stesso | Aurabase Realtime (modifica acquisizione dati, presenza e trasmissione su NATS e WebSocket) |
Tabella di marcia in 4 fasi#
- Schema e dati — Scelta del modello (raccolte PostgreSQL relazionali o NoSQL) e importazione (15 min)
- Autenticazione — Esporta Firebase Autentica gli utenti e importa hash scrypt/bcrypt senza reimpostazione (10 min)
- File di archiviazione — Sincronizzazione dei bucket Cloud Storage con Aurabase Storage (variabile in base al volume)
- Sostituzione SDK — Sostituzione di
firebase/*con@aurabase/aurabase-js
Da Firestore a Aurabase#
Puoi normalizzare i tuoi dati in PostgreSQL per sfruttare la potenza di SQL e la digitazione rigorosa oppure importarli direttamente nel motore NoSQL Document Store di Aurabase:
Roadmap: non disponibile. I comandi aura mostrati di seguito sono pianificati e non ancora consegnati: la CLI ad oggi non li dispone.
# 1. Esporta Firestore nel file JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Importa nel motore NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. Generazione di tipi TypeScript completi
npx @aurabase/gen --out src/aurabase.types.ts
Migrazione degli utenti senza intoppi#
Roadmap: non disponibile. Il comando aura auth import e l'importazione degli hash delle password Firebase (scrypt) sono pianificati e non ancora consegnati: la CLI e Aurabase Auth non li hanno ad oggi. Fino ad allora, crea gli utenti con l'API di amministrazione (aura.authAdmin.createUser) e chiedi loro di impostare una nuova password o di accedere con un collegamento magico.
Il piano: mantenere gli hash della password di Firebase in modo che gli utenti mantengano le proprie credenziali senza reimpostare la password.
# Esportazione degli utenti dalla CLI Firebase
firebase auth:export users.json --format=JSON --project my-firebase-app
# Importa in Aurabase Auth (conserva hash e token)
aura auth import users.json --provider firebase --env prod
Sincronizzazione dei bucket S3 in corso#
Aurabase Lo spazio di archiviazione utilizza un'API S3 standard. Puoi sincronizzare i tuoi file in modo continuo da Google Cloud Storage con l'utilità rclone o aws-cli:
# Trasferimento diretto da GCS a 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
Sostituzione dell'SDK client#
// PRIMA (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// DOPO (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()