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