في حال تفعيل عمليات الطرح التلقائي، سيتم طرح إصدار جديد من تطبيقك تلقائيًا في كل مرة تدفع فيها عملية تثبيت جديدة إلى الفرع المباشر في مستودع GitHub App Hosting. ويمكنك الاطّلاع على حالة الطرح في وحدة تحكّم Firebase أو في عملية التحقّق من App Hosting GitHub.
بالإضافة إلى ذلك، تتيح App Hosting عمليات طرح يتم تشغيلها يدويًا من أجل دمج CI/CD أو أي حالة أخرى تريد فيها فرض عملية طرح.
عرض عمليات الطرح
توفّر وحدة تحكّم Firebase إمكانية الوصول إلى معلومات تفصيلية حول جميع عمليات طرح تطبيقك. في App Hosting، انقر على عرض للخادم الخلفي الذي تريد الاطّلاع على عمليات طرحه. تعرض علامة التبويب عمليات الطرح للواجهة الخلفية جدولاً يتضمّن سجلّاً بجميع عمليات الطرح لهذه الواجهة الخلفية.
يحتوي كل إدخال في عملية الطرح على روابط تؤدي إلى مهمة Cloud Build والتغيير أو عملية الإيداع التي أدّت إلى بدء عملية الطرح، بالإضافة إلى معلومات أساسية حول المؤلّف وتاريخ الإنشاء وحالة عملية الطرح.
- Cloud Build هي بيئة الإنشاء التي ينفّذ فيها App Hosting أمر إنشاء تطبيقك. يمكنك الوصول إلى سجلات Cloud Build من خلال النقر على رقم التعريف الخاص بالإصدار.
- التغيير هو عملية الإرسال إلى GitHub أو أي إجراء آخر أدّى إلى بدء عملية الطرح.
تفعيل عملية طرح يدويًا
إذا أردت بدء طرح يدويًا من مصدر GitHub بدون إرسال عملية دمج جديدة، يمكنك إنشاء عملية طرح من وحدة تحكّم Firebase أو واجهة سطر الأوامر Firebase. ويُعدّ ذلك مفيدًا في حالات مثل:
- فرض إعادة إنشاء المحتوى الثابت
- السماح لنظام CI/CD بتفعيل عمليات الطرح
- قصر عمليات طرح الإصدارات على تواريخ أو أوقات معيّنة
لبدء طرح إصدار في وحدة تحكّم Firebase، اتّبِع الخطوات التالية:
- في App Hosting، انقر على عرض للخدمة الخلفية التي تريد إنشاء طرح لها.
- في ملخّص لوحة بيانات الخلفية، انقر على إنشاء طرح.
- اختَر الفرع الذي تريد نشره.
- اختَر عملية الإيداع التي تريد نشرها، إما أحدث عملية إيداع أو عملية إيداع سابقة محدّدة برقم تعريف عملية الإيداع.
- انقر على إنشاء. يتم عرض الحالة ورقم الإصدار لعملية الطرح في جدول سجلّ عمليات الطرح. عند اكتمال عملية الطرح، سيظهر هذا الطرح على أنّه الطرح الحالي.
لتفعيل عملية طرح في واجهة سطر الأوامر Firebase، نفِّذ الأمر التالي وحدِّد الفرع الذي تريد طرحه عند مطالبتك بذلك:
firebase apphosting:rollouts:create BACKEND_ID
بدلاً من ذلك، يمكنك بدء طرح آخر إصدار من الرمز البرمجي في فرع معيّن باستخدام الخيار --git-branch:
firebase apphosting:rollouts:create BACKEND_ID
--git_branch BRANCH_NAME
يمكنك أيضًا إنشاء طرح باستخدام عملية تثبيت محدّدة باستخدام الخيار --git-commit:
firebase apphosting:rollouts:create BACKEND_ID
--git_commit COMMIT_ID
استعادة طرح سابق
يوفّر لك App Hosting خيارَين لاستعادة إصدار سابق:
- الرجوع فورًا إلى الإصدار السابق بدون إعادة الإنشاء
- إعادة الإنشاء والعودة إلى إصدار سابق
إنشاء عملية تراجع فورية
في بعض الأحيان، قد تحتاج إلى الرجوع سريعًا إلى إصدار أقدم من تطبيقك، مثلاً إذا اكتشفت خطأً فادحًا في عملية طرح تم نشرها حديثًا أو إذا واجهت إصدارًا غير مستقر يعيق عمليات الطرح الجديدة. في مثل هذه الحالات، يمكنك استعادة صورة حاوية حالية من اختيارك من عملية طرح سابقة. لا تتم إعادة إنشاء هذه الصورة، ولكن يتم استخدام الرمز وإعدادات البيئة من وقت إنشائها لأول مرة.
لإنشاء عملية رجوع فوري إلى الإصدار السابق، اتّبِع الخطوات التالية:
- في App Hosting، انقر على عرض للخادم الخلفي الذي تريد إنشاء عملية استرجاع له.
- انقر على علامة التبويب عمليات الطرح.
- في جدول السجلّ للخادم الخلفي، انقر على رمز قائمة الخيارات الإضافية لإصدار سابق.
- اختَر الرجوع إلى هذا الإصدار وأكِّد ذلك.
إعادة الإنشاء والعودة إلى الإصدار السابق
إذا أردت العودة إلى إصدار أقدم من تطبيقك مع الاحتفاظ بالإعدادات الحالية، يمكنك إعادة إنشاء التطبيق كجزء من عملية الرجوع إلى الإصدار السابق. على سبيل المثال، إذا عدّل أحدث إصدار من تطبيقك قيمة مفتاح واجهة برمجة التطبيقات في Secret Manager، يمكن أن تضمن إعادة الإنشاء استخدام المفتاح الجديد في تطبيقك بعد التراجع.
لإعادة الإنشاء والتراجع:
- في App Hosting، اختَر عرض لوحة البيانات للخادم الخلفي الذي تريد إنشاء عملية استرجاع له.\
- انقر على علامة التبويب عمليات الطرح.
- اختَر إنشاء طرح.
- في مربّع الحوار إنشاء طرح، ضَع علامة في مربّع إصدار أقدم، ثم أدخِل رقم تعريف الإصدار الذي تريد إعادة إنشائه والرجوع إليه. يشكّل معرّف عملية النقل جزءًا من "تفاصيل التغيير" لكل طرح مُدرَج في سجلّ عمليات الطرح، وهو مضمّن بين قوسين في التصنيف.
- انقر على إنشاء لبدء عملية التراجع.
تغيير إعدادات الطرح
يمكنك تغيير الإصدار العلني لعمليات الطرح وإيقاف عمليات الطرح التلقائي أو تفعيلها باستخدام عناصر التحكّم في صفحة الإعدادات > النشر في لوحة البيانات الخاصة بالخادم الخلفي.
- في App Hosting، انقر على عرض للواجهة الخلفية التي تريد تعديل إعدادات الطرح فيها.
- في لوحة بيانات الخلفية، انقر على الإعدادات. يعرض العرض التلقائي معلومات حول النطاقات والنطاقات المخصّصة.
- اختَر طريقة عرض النشر. في هذا العرض، يمكنك تغيير الفرع المباشر لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها. بالإضافة إلى ذلك، تتوفّر خيارات لضبط دليل جذر التطبيق والبيئة الخاصة بالخادم الخلفي (راجِع النشر في بيئات متعددة).