الترحيل من 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 الوقت الفعلي (تغيير التقاط البيانات والتواجد والبث عبر 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. قم بالاستيراد إلى محرك Aurabase NoSQL
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 ليس لديهما اليوم. حتى ذلك الحين، أنشئ المستخدمين باستخدام واجهة برمجة تطبيقات المشرف (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 واجهة برمجة التطبيقات القياسية 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()