النشر
عمليات الترحيل بدون توقف، والتراجع الذري، وCI/CD عبر GitHub Actions / GitLab / CLI، وفروع قاعدة البيانات: نسخة من مشروع لاختبار الترحيل أو السياسة قبل الإنتاج.
ثلاثة أسطح النشر#
يعرض مشروع Aurabase ثلاثة أسطح للنشر: Postgres المخطط (إصدارات عمليات ترحيل SQL)، وظائف الحافة (WASM + cron + jobs)، السياسات والأسرار (RLS, env فار، تطبيقات OAuth). كل منها يدفع نفسه بشكل مستقل عبر aura CLI.
واجهة سطر الأوامر (aura) عبارة عن ثنائي واحد، ويمكن تثبيته أيضًا باستخدام npm install -g @aurabase/cli، ويدعم التشغيل الجاف وتأكيد المطالبات ومعاينة الفرق. متوافق مع لينكس / ماك / ويندوز.
التطوير، المعاينة، الإنتاج#
افتراضيًا، يحتوي المشروع على بيئتين: dev (محلية، Kubernetes) وprod (سحابية). لمحاولة تغيير نسخة من بياناتك قبل الإنتاج، قم بإنشاء فرع قاعدة بيانات فروع قاعدة البيانات.
LOCAL DEV
$ ./start.sh → full local stack (k3d)
$ aura dev → watch mode + types gen
BRANCH (copy of a project, deleted by its TTL)
$ aura branch create pr-142 --from my-app --ttl 3d
$ aura db push → on the branch project, to try the migration
$ aura branch delete pr-142
PRODUCTION
merge to main → CI run: aura db push
→ aura deploy functions
إصدار SQL، التراجع الذري#
الهجرات تعيش في aurabase/migrations. ملف واحد لكل تغيير، الطابع الزمني في البادئة. تطبق واجهة سطر الأوامر (CLI) عمليات الترحيل المفقودة على المشروع المرتبط؛ قم بإعادة إنشاء أنواع TypeScript باستخدام npx @aurabase/gen بعد التغيير.
# إنشاء هجرة جديدة
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql
# تعرف على عمليات الترحيل المطبقة أو المعلقة، ثم قم بتطبيقها على المشروع المرتبط
aura db status
aura db push
# إعادة إنشاء أنواع TypeScript
npx @aurabase/gen --out src/aurabase.types.ts
# قائمة عمليات الترحيل المطبقة
aura db migration list
عمليات الترحيل بدون توقف. اتبع القواعد: قم بإضافة عمود لاغٍ أولاً، وإعادة تعبئة منفصلة، والقيد NOT NULL أخيرًا. لا تتحقق واجهة سطر الأوامر من التوافق مع الإصدارات السابقة: قم بمراجعة البيانات المدمرة (drop column, alter column … type) قبل aura db push.
فروع قاعدة البيانات#
الفرع هو مشروع جديد مستنسخ من مشروع PostgreSQL موجود: مخططه، وسياسات الأمان على مستوى الصف، والوظائف، والمشغلات، وطرق العرض، وصفوفه (ما لم تطلب المخطط فقط). يحتوي على عنوان URL الخاص به ومفاتيح واجهة برمجة التطبيقات وقاعدة البيانات الخاصة به، حتى تتمكن من تشغيل الترحيل أو اختبار سياسة أو الإشارة إلى نشر المعاينة دون لمس المصدر. يتم حذف الفروع تلقائيًا عند انتهاء فترة بقائها.
# من المشروع المرتبط (رابط الهالة)، 72 ساعة بشكل افتراضي
aura branch create feat/new-checkout
# من مشروع آخر، أبقى 7 أيام
aura branch create pr-142 --from my-app --ttl 7d
# المخطط فقط: لا يتم نسخ أي صف، وتبدأ التسلسلات من جديد
aura branch create schema-test --no-data
aura branch list # فروع المشروع المرتبط
aura branch list --all # كل فرع من فروع المنظمة
aura branch delete feat/new-checkout
aura branch create ينتظر حتى يصبح الفرع جاهزًا، ثم يطبع عنوان URL الخاص به ومفاتيح API الخاصة به، تظهر مرة واحدة فقط مثل تلك الخاصة بـ aura projects create (--json يطبعها للنصوص البرمجية). استخدم --no-wait للعودة مرة واحدة واتبعه بـ aura branch list. الفرع عبارة عن مشروع: اربط مجلدًا به باستخدام aura link --project-id <id> وقم بتشغيل aura db push هناك لمحاولة الترحيل.
الفرع عبارة عن نسخة تم إنشاؤها في وقت الإنشاء، وليست نسخة طبق الأصل حية وليست نسخة عند الكتابة: لا شيء يتدفق مرة أخرى إلى المصدر أو منه بعد ذلك. يقرأ النظام الأساسي المصدر في لقطة واحدة متسقة وينسخ الصفوف في قاعدة البيانات الفرعية، بحيث يتناسب الوقت مع البيانات. في حزمة الاختبار المحلية، تم استنساخ جدول بحجم 333 ميجابايت يضم 350.000 صف في 14 ثانية. يتم بعد ذلك تطبيق الترحيل الذي يعمل على الفرع على الإنتاج باستخدام aura db push المعتاد.
الحدود، كاملة#
| من يمكنه إنشاء | الأعضاء الذين لديهم دور developer أو أكثر، من مشروع PostgreSQL النشط وغير السباتي. تم رفض مشروع MongoDB. |
| تفرع فرع | مرفوض: قم بإنشاء الفرع من مشروعه الأصلي. |
| الاسم | الحروف والأرقام . و _ و - و /، ما يصل إلى 63 حرفًا، فريدة لكل مشروع بين الفروع المباشرة (غير حساسة لحالة الأحرف). |
| وقت العيش | 72 ساعة بشكل افتراضي، من ساعة واحدة إلى 30 يومًا (--ttl 1h إلى --ttl 30d). يتم حذف الفرع منتهي الصلاحية وقاعدة البيانات الخاصة به تلقائيًا، خلال دقيقة تقريبًا من الموعد النهائي. يمكنك حذفه في وقت سابق. |
| حد الخطة | الفرع لا يحسب ولا مقابل حد المشروع الخاص بك (max_projects); لديها حد خاص بها من الفروع النشطة لكل مؤسسة (max_branches): 1 مجانًا، 10 للمحترفين، 25 للفريق. بعد ذلك، تم رفض الإنشاء باستخدام BRANCH_LIMIT_REACHED. فرع فاشل لا يحتسب. راجع حدود الحدود. |
| حجم البيانات | يتم بث الصفوف، ولا يتم الاحتفاظ بها في الذاكرة، لذلك لا يوجد سقف يصل إلى 32 ميجابايت. يتم رفض الاستنساخ، خلال ثوانٍ قليلة، عندما تحتوي الجداول على أكثر من حد النشر (2 جيجا بايت افتراضيًا، BRANCH_CLONE_MAX_BYTES عندما تستضيف Aurabase): تعطي الرسالة الحجم وتقترح --no-data. يتوقف الاستنساخ أيضًا بعد 30 دقيقة. |
ما لم يتم استنساخه#
- المستنسخة: الجداول وصفوفها، وأنواع الأعمدة، والإعدادات الافتراضية، وأعمدة الهوية، والتسلسلات وقيمتها الحالية، والقيود، والفهارس، وأمان مستوى الصف (ممكّن، مفروض، وسياسات)، ووظائف وإجراءات SQL، والمشغلات، وطرق العرض وطرق العرض المادية، وأنواع التعداد، والامتيازات الخاصة بها جميعًا.
- غير مستنسخ: مصادقة المستخدمين والجلسات وإعدادات المصادقة؛ دلاء وأشياء التخزين؛ وظائف الحافة والأسرار ومتغيرات البيئة ووظائف كرون؛ إعدادات الجدول في الوقت الفعلي (أعد تمكينها على الفرع)؛ تعليقات الجدول والأعمدة، بما في ذلك توجيهات
@graphql؛ امتيازات على مستوى العمود؛ تفعيل pg_graphql (aura projects graphql-enableعلى الفرع). الكائنات مملوكة لدور مسؤول الفرع. - مرفوض (سيكون الفرع غير مكتمل): الجداول المقسمة والموروثة، والجداول الخارجية، والمجالات، والأنواع المركبة والمدى، والوظائف المجمعة، وإعادة كتابة القواعد، والمفاتيح الخارجية التي تشير إلى مخطط آخر، والإضافات غير تلك التي يثبتها النظام الأساسي في كل مشروع.
يتم إنشاء فرع من المخطط كما تتم قراءته قبل النسخة مباشرة. لا تقم بتغيير مخطط المصدر (aura db push, DDL) أثناء إنشاء الفرع.
عندما يفشل الخلق#
لم يبق شيء وراءهم. يتم تشغيل النسخة في معاملة واحدة على قاعدة بيانات الفرع؛ في حالة حدوث أي فشل، يتم التراجع عنه، ويتم حذف المشروع الفرعي، ويطبع aura branch create السبب (على سبيل المثال الكائن الذي لا يمكن استنساخه). يظل الفرع الفاشل مرئيًا في aura branch list لمدة 24 ساعة مع رسالته، ويصبح اسمه مجانيًا مرة أخرى. إذا تمت إعادة تشغيل خدمة قاعدة البيانات في منتصف النسخة، فسيتم الإعلان عن فشل الفرع وحذفه بعد 45 دقيقة.
ثلاث عمليات تكامل جاهزة#
يعمل CLI مع أي CI. فيما يلي وصفات الثلاثة الأكثر شيوعًا.
name: Deploy to Aurabase
on:
push: { branches: [main] }
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g @aurabase/cli # أو قم بتنزيل الملف الثنائي من صفحة الإصدار
- run: aura login --token ${{ secrets.AURA_PAT }} # رمز الوصول الشخصي aura_pat_*
- run: aura link ${{ vars.AURA_PROJECT_ID }}
- run: aura db push
- run: aura deploy functions
قم بربط مشروع واحد لكل بيئة (مشروع مرحلي ومشروع إنتاج) وقم بتشغيل نفس المسار مقابل كل منهما. لا توجد علامة --env: الهدف هو المشروع الذي يرتبط به المجلد.
الذرية، عن طريق الهجرة إلى أسفل#
يمكن أن تحتوي كل عملية ترحيل 20260415_xxx.sql على ملف 20260415_xxx.down.sql بجوارها. يقوم aura db migration down [n] بتشغيل .down.sql لآخر عمليات الترحيل المطبقة n، الأحدث أولاً، وإزالتها من السجل؛ يتحقق الأمر من إجابة الخادم ويفشل إذا لم يتم التراجع عن أي شيء. تتم إزالة الترحيل بدون .down.sql فقط من السجل، وتقول واجهة سطر الأوامر (CLI) ذلك.
# التراجع عن آخر عملية ترحيل تم تطبيقها (يعمل على تشغيل .down.sql)
aura db migration down
# إرجاع الثلاثة الأخيرة
aura db migration down 3
# إصلاح السجل دون لمس المخطط (الترحيل المطبق يدويًا، الترحيل الفاشل)
aura db migration repair 20260415120000_add_devices_table.sql --applied
# يتم إلغاء الترحيل الفاشل في معاملته الخاصة: لا يوجد شيء يمكن الرجوع عنه.
# يتم استرداد قاعدة البيانات بأكملها في الوقت المناسب من خلال النسخ الاحتياطية (استعادة النسخة الاحتياطية لـ aura db <id> --yes)
الاسترداد في الوقت المناسب ليس لديه أمر الخدمة الذاتية حتى الآن. لاستعادة القيادة بنفسك، استخدم لقطات aura db backup create / aura db backup restore <id> --yes; تؤدي عملية الاستعادة إلى استبدال قاعدة البيانات، لذا قم بعمل نسخة احتياطية جديدة أولاً.