نسخ Nibleaf احتياطيًا واستعادته وترقيته

تتضمن مجموعة الاستعادة القابلة للاستخدام Postgres وتخزين الكائنات من النافذة التشغيلية نفسها. وتُعد نسخة قاعدة البيانات من دون الأصول المرفوعة غير مكتملة. احتفظ بنسخ خارج المضيف والحساب المستخدمين للخدمة الحية، وأثبت نجاح الاستعادة قبل الاعتماد عليها.

إنشاء نسخة احتياطية

عند التنفيذ من نسخة محلية للمستودع، يستخدم السكربت المضمّن افتراضيًا docker-compose.prod.yml و./backups ومدة احتفاظ محلية تبلغ 14 يومًا ووحدة تخزين maxio المضمّنة:

./scripts/backup.sh

في مجلد أنشأه المثبّت الإرشادي حيث يحمل ملف Compose الاسم docker-compose.yml، وجّه السكربت إلى ذلك الملف:

COMPOSE_FILE=docker-compose.yml ./scripts/backup.sh

ينشئ السكربت ملف pg_dump بتنسيق مخصّص، وينشئ أرشيف تخزين مضغوطًا عندما تكون وحدة تخزين Docker المهيّأة موجودة. لا تلتقط خطوة وحدة تخزين Docker حاويات R2 أو S3 الخارجية؛ استخدم إمكانات المزوّد لإدارة الإصدارات أو النسخ المتماثل، أو أنشئ نسخة احتياطية مستقلة للحاوية.

انقل الملفين إلى خارج المضيف باستخدام بيانات اعتماد منفصلة، وسجّل المعرّفات والأحجام والطوابع الزمنية وسياسة الاحتفاظ وإصدار التطبيق.

اختبار الاستعادة

لا تستبدل بيئة الإنتاج مطلقًا عند إجراء تمرين. أنشئ قاعدة بيانات ووجهة تخزين ومصدر تطبيق معزولة. اتبع أوامر الاستعادة الموثّقة في أعلى scripts/backup.sh، ثم تحقق من المشاريع والعضويات وأشجار الصفحات والمسودات الحالية وعمليات النشر ذات الحالة READY والأصول المرفوعة وعزل المصادقة والبحث العام.

سجّل الزمن المنقضي وكل خطوة يدوية. لا يُعد رمز خروج ناجح لمهمة النسخ الاحتياطي دليلًا على قابلية الاستعادة من دون نجاح استعادة معزولة.

ترقية إصدار مثبّت

اقرأ ملاحظات كل إصدار وسيط، وتحقق من أي تغييرات خاصة بالإصدار في الترحيل أو التهيئة. أنشئ نسخة احتياطية واختبر استعادتها، ثم غيّر NIBLEAF_VERSION في .env إلى وسم إصدار موجود:

إمكانات أغسطس 2026 الست مدمجة حاليًا في المصدر، بينما يبقى بيان الاستضافة الذاتية المنشور على v0.1.2. لا تخترع وسمًا أحدث ولا تستبدل الملخصات الرقمية المثبتة لبرنامج التثبيت وCompose. عند توفر ناتج مستقبلي مطابق، استخدم دليل ترحيل الإصدار المجمع لترتيب اعتماد البحث والاستخدام والإضافات والتكاملات وMCP.

NIBLEAF_VERSION=vX.Y.Z

اسحب الخدمات وأعد إنشاءها:

docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

تحقق من ملخّص الصورة الرقمي، وسجل الترحيل، وسلامة الخدمات، وتسجيل الدخول، وعملية رفع واحدة، وعملية نشر واحدة، وعملية بحث واحدة، وصفحة عامة واحدة.

التراجع الآمن إلى الإصدار السابق

إذا لم يُنفّذ أي ترحيل للمخطط، فثبّت الصورة السابقة وأعد إنشاء الخدمات. وإذا غيّر ترحيل أحادي الاتجاه قاعدة البيانات، فأوقف عمليات الكتابة واستعد مجموعة الاستعادة السابقة للترقية قبل تشغيل التطبيق الأقدم.

بالنسبة إلى مخطط الإمكانات المجمع، فضّل التراجع في وقت التشغيل واعكس MCP ثم التكاملات ثم الإضافات ثم الاستخدام وأخيرًا البحث، ولا تفعل ذلك إلا بعد نشر شيفرة لا تقرأ الحالة المحذوفة. يملك ترحيل التكاملات الحقل الاختياري المشترك ApiKey.expiresAt؛ فلا تحذفه ما دام MCP أو مستهلك آخر يعتمد عليه.

لا تجمع ترقية التطبيق مع تغيير الإصدار الرئيسي لـPostgreSQL. تعامل مع ترقية قاعدة البيانات على أنها مشروع مستقل للتفريغ والاستعادة.