Миграция с Firebase
Пошаговое руководство по перемещению данных Firestore, пользователей Firebase Auth и сегментов в открытую высокопроизводительную инфраструктуру Aurabase.
Соответствующие кирпичи Firebase#
Aurabase заменяет каждый проприетарный компонент Firebase стандартной открытой технологией автономного размещения без привязки к поставщику:
| Firebase | Сравнение | Aurabase эквивалент |
|---|---|---|
Cloud Firestore | Высший эквивалент | PostgreSQL (реляционный и SQL) или Aurabase NoSQL (стиль MongoDB) |
Firebase Auth | То же, обогащенное | Та же поддержка OAuth, плюс TOTP MFA, магические ссылки и пароли. |
Firebase Storage | То же, обогащенное | S3-совместимый REST API (SeaweedFS) с преобразованием изображений «на лету». |
Cloud Functions | Такой же | Edge Functions на стандартных Deno (Deno.serve()) и WASM |
Security Rules | Начальство | Postgres RLS (безопасность на уровне строк), оценивается в базе данных |
Firebase Realtime DB | Такой же | Aurabase Realtime (сбор данных, присутствие и трансляция изменений через NATS и WebSockets) |
4-шаговая дорожная карта#
- Схема и данные — Выбор модели (реляционная коллекция PostgreSQL или коллекции NoSQL) и импорт (15 минут)
- Аутентификация — экспорт Firebase аутентификации пользователей и импорт хэшей scrypt/bcrypt без сброса (10 минут)
- Файлы хранилища — Синхронизация сегментов облачного хранилища с хранилищем Aurabase (зависит от объема)
- Замена SDK — Замена
firebase/*на@aurabase/aurabase-js
Из Firestore в Aurabase#
Вы можете либо нормализовать свои данные в PostgreSQL, чтобы воспользоваться преимуществами SQL и строгой типизации, либо импортировать их непосредственно в механизм NoSQL Document Store Aurabase:
Дорожная карта — недоступна. Команды aura, показанные ниже, запланированы и еще не доставлены: в CLI их сегодня нет.
# 1. Экспортируйте Firestore в файл JSONL.
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl
# 2. Импортируйте в NoSQL-движок Aurabase.
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>
# 3. Генерация полных типов TypeScript
npx @aurabase/gen --out src/aurabase.types.ts
Миграция пользователей без проблем#
Дорожная карта — недоступна. Команда aura auth import и импорт хешей паролей Firebase (scrypt) запланированы и еще не доставлены: в CLI и Aurabase Auth их сегодня нет. А пока создайте пользователей с помощью API администратора (aura.authAdmin.createUser) и попросите их установить новый пароль или войти в систему с помощью волшебной ссылки.
План: сохранить хэши паролей Firebase, чтобы пользователи сохраняли свои учетные данные без сброса пароля.
# Экспорт пользователей из Firebase CLI
firebase auth:export users.json --format=JSON --project my-firebase-app
# Импортировать в Aurabase Auth (сохраняет хеши и токены)
aura auth import users.json --provider firebase --env prod
Синхронизация сегментов S3#
Aurabase Storage использует стандартный API S3. Вы можете постоянно синхронизировать файлы из Google Cloud Storage с помощью утилиты rclone или aws-cli:
# Прямой перенос из GCS в хранилище 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
Замена клиентского SDK#
// ДО (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()
// ПОСЛЕ (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()