إذا كانت عمليات الطرح التلقائية مفعَّلة، يتم طرح App Hosting تلقائيًا إصدارًا جديدًا من تطبيقك في كل مرة تُرسل فيها مشاركة جديدة إلى الفرع العلني في مستودع GitHub. يمكنك التحقّق من حالة الطرح في وحدة تحكّم Firebase أو في عملية التحقّق من App Hosting على GitHub.
بالإضافة إلى ذلك، تتيح App Hosting عمليات الطرح التي يتم تفعيلها يدويًا لتكامل IDE/CD أو أي حالة أخرى تريد فيها فرض عملية طرح.
عرض عمليات الطرح
تتيح لك وحدة تحكّم Firebase الوصول إلى معلومات تفصيلية عن كل عمليات طرح تطبيقك. في علامة التبويب App Hosting، اختَر عرض لوحة التحكّم للخلفية التي تريد الاطّلاع على عمليات طرحها. تعرِض لوحة البيانات معلومات عن عملية الطرح الحالية، بالإضافة إلى جدول يسرد سجلّ جميع عمليات الطرح لنظام التشغيل هذا.
يحتوي كلّ طرح على عملية إرسال في Git وعمل Cloud Build ومراجعة Cloud Run.
- عملية تسجيل git هي نبذة عن مستودعك في وقت إنشاء الطرح.
- وظيفة Cloud Build هي بيئة الإنشاء التي ينفذ فيها App Hosting أمر إنشاء تطبيقك. يمكنك الوصول إلى سجلات Cloud Build من خلال النقر على رقم تعريف الإصدار في وحدة تحكّم Firebase.
- تمثل المراجعة Cloud Run بيئة التشغيل لتطبيق الويب. يمكنك الاطّلاع على مزيد من المعلومات حول إعدادات وقت التشغيل لطرح التطبيق (مثل حدود وحدة المعالجة المركزية والذاكرة ومتغيّرات البيئة) من خلال النقر على قائمة الخيارات الإضافية واختيار عرض المراجعة Cloud Run.
بدء عملية طرح يدويًا
إذا كنت تريد بدء عملية طرح يدويًا من مصدر 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 علامة التبويب، اختَر عرض ملف قياس الأداء للواجهة الخلفية التي تريد تعديل إعدادات الطرح فيها.
- في لوحة بيانات الخلفية، انقر على الإعدادات. يعرض العرض التلقائي معلومات عن النطاقات والنطاقات المخصّصة.
- اختَر طريقة عرض النشر. في هذه الصفحة، يمكنك تغيير الفرع المعروض على الويب لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها. بالإضافة إلى ذلك، تتوفّر خيارات لضبط الدليل الجذر للتطبيق والبيئة للخلفية (راجِع النشر في بيئات متعددة).