إدارة عمليات الطرح والإصدارات

إذا كانت ميزة "عمليات الطرح التلقائية" مفعّلة، يطرح App Hosting تلقائيًا إصدارًا جديدًا من تطبيقك في كل مرة تنقل فيها عملية تثبيت جديدة إلى الفرع المباشر في مستودع GitHub. ويمكنك الاطّلاع على حالة عملية الطرح في Firebase console أو في عملية التحقّق من GitHub الخاصة بـ App Hosting.

بالإضافة إلى ذلك، تتيح App Hosting عمليات طرح يتم تفعيلها يدويًا من أجل دمج التكامل المستمر/النشر المستمر (CI/CD) أو أي حالة أخرى تريد فيها فرض عملية طرح.

عرض عمليات الطرح

يتيح لك Firebase console الوصول إلى معلومات مفصّلة عن جميع عمليات طرح تطبيقك.

انتقِل إلى الاستضافة والخدمات بلا خادم> استضافة التطبيقات، ثم انقر على عرض للخادم الخلفي الذي تريد الاطّلاع على عمليات الطرح الخاصة به. تعرِض علامة التبويب عمليات الطرح للخادم الخلفي جدولاً يتضمّن سجلّاً بجميع عمليات الطرح لهذا الخادم الخلفي.

يحتوي كل إدخال لعملية طرح على روابط تؤدي إلى مهمة Cloud Build و التغيير أو عملية التثبيت التي أدّت إلى تفعيل عملية الطرح، بالإضافة إلى معلومات أساسية عن المؤلّف وتاريخ الإنشاء وحالة عملية الطرح.

  • مهمة Cloud Build هي بيئة الإنشاء التي تنفّذ فيها App Hosting أمر إنشاء تطبيقك. يمكنك الوصول إلى سجلّات Cloud Build من خلال النقر على رقم تعريف عملية الإنشاء.
  • التغيير هو عملية التثبيت على GitHub أو أي إجراء آخر أدّى إلى تفعيل عملية الطرح.

تفعيل عملية طرح يدويًا

إذا أردت تفعيل عملية طرح يدويًا من مصدر GitHub بدون نقل عملية تثبيت جديدة، يمكنك إنشاء عملية طرح من Firebase console أو the Firebase CLI. ويكون ذلك مفيدًا في حالات مثل:

  • فرض إعادة إنشاء المحتوى الثابت
  • السماح لنظام التكامل المستمر/النشر المستمر (CI/CD) بتفعيل عمليات الطرح
  • حصر عمليات طرح الإنتاج في تواريخ أو أوقات معيّنة

لتفعيل عملية طرح في Firebase console:

  1. في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
  2. انقر على عرض للخادم الخلفي الذي تريد إنشاء عملية طرح له.
  3. في لوحة بيانات الخادم الخلفي، انقر على إنشاء عملية طرح.
  4. اختَر الفرع الذي تريد نشره.
  5. اختَر عملية التثبيت التي تريد نشرها، سواء كانت أحدث عملية تثبيت أو عملية تثبيت سابقة محدّدة برقم تعريف عملية التثبيت.
  6. انقر على إنشاء. تظهر الحالة ورقم إصدار عملية الطرح في جدول سجلّ عمليات الطرح. عند اكتمال عملية الطرح، تظهر هذه العملية كعملية الطرح الحالية.

لتفعيل عملية طرح في Firebase CLI، نفِّذ الأمر التالي و اختر الفرع لعملية الطرح عند المطالبة بذلك:

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 تمنحك خيارَين لاستعادة عملية طرح سابقة:

  • التراجع فورًا بدون إعادة الإنشاء
  • إعادة الإنشاء والتراجع إلى إصدار سابق

إنشاء عملية تراجع فورية

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

لإنشاء عملية تراجع فورية:

  1. في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
  2. انقر على عرض للخلفية التي تريد إنشاء عملية تراجع لها.
  3. انقر على علامة التبويب عمليات الطرح.
  4. في جدول السجلّ للخادم الخلفي، انقر على رمز قائمة الخيارات الإضافية لعملية إنشاء سابقة.
  5. انقر على التراجع إلى عملية الإنشاء هذه وأكِّد ذلك.

إعادة الإنشاء والتراجع

إذا أردت العودة إلى إصدار أقدم من تطبيقك مع الاحتفاظ بالإعدادات الحالية، يمكنك إعادة إنشاء التطبيق كجزء من عملية العودة إلى الحالة السابقة. على سبيل المثال، إذا عدّل أحدث إصدار من تطبيقك قيمة مفتاح واجهة برمجة التطبيقات في Secret Manager، يمكن أن تضمن عملية إعادة الإنشاء استخدام المفتاح الجديد في تطبيقك بعد التراجع.

لإعادة الإنشاء والتراجع:

  1. في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
  2. انقر على عرض لوحة البيانات للخادم الخلفي الذي تريد إنشاء عملية تراجع له.
  3. انقر على علامة التبويب عمليات الطرح.
  4. انقر على إنشاء عملية طرح.
  5. في مربّع الحوار إنشاء عملية طرح ، انقر على عملية تثبيت سابقة ، ثم أدخِل رقم تعريف عملية التثبيت للإصدار الذي تريد إعادة إنشائه والتراجع إليه. إنّ رقم تعريف عملية التثبيت هو جزء من "تفاصيل التغيير" لكل عملية طرح مدرَجة في سجلّ عمليات الطرح ، وهو مضمّن بين أقواس في التصنيف.
  6. انقر على إنشاء لبدء عملية العودة إلى الحالة السابقة.

تغيير إعدادات عمليات الطرح

يمكنك تغيير الفرع المباشر لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها باستخدام عناصر التحكّم في طريقة العرض الإعدادات > النشر في لوحة بيانات الخادم الخلفي.

  1. في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
  2. انقر على عرض للخادم الخلفي الذي تريد تعديل إعدادات عمليات الطرح فيه.
  3. في لوحة بيانات الخادم الخلفي، انقر على الإعدادات. تعرِض طريقة العرض التلقائية معلومات عن النطاقات والنطاقات المخصّصة.
  4. انقر على طريقة العرض النشر. في طريقة العرض هذه، يمكنك تغيير الفرع المباشر لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها. بالإضافة إلى ذلك، تتوفّر خيارات لضبط دليل جذر التطبيق والبيئة لـ الخادم الخلفي (راجِع النشر في بيئات متعددة).