إذا كانت ميزة "عمليات الطرح التلقائية" مفعّلة، في كل مرة تنقل فيها التزامًا جديدًا إلى الفرع المباشر في مستودع GitHub، تنشر خدمة "استضافة التطبيقات" تلقائيًا إصدارًا جديدًا من تطبيقك. ويمكنك الاطّلاع على حالة عملية الطرح في Firebase console أو في عملية التحقّق من GitHub الخاصة بخدمة "استضافة التطبيقات".App HostingApp HostingFirebase
بالإضافة إلى ذلك، تتيح 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:
- في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
- انقر على عرض للخادم الخلفي الذي تريد إنشاء عملية طرح له.
- في لوحة بيانات الخادم الخلفي، انقر على إنشاء عملية طرح.
- اختَر الفرع الذي تريد نشره.
- اختَر الالتزام الذي تريد نشره، سواء كان أحدث التزام أو التزامًا سابقًا محدّدًا برقم تعريف الالتزام.
- انقر على إنشاء. تظهر الحالة ورقم الإنشاء لعملية الطرح في جدول سجلّ عمليات الطرح. عند اكتمال عملية الطرح، تظهر هذه العملية كعملية الطرح الحالية.
لتفعيل عملية طرح في 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 تمنحك خيارَين لاستعادة عملية طرح سابقة:
- التراجع عن التغييرات فورًا بدون إعادة الإنشاء
- إعادة الإنشاء والتراجع عن التغييرات إلى إصدار سابق
إنشاء عملية تراجع فورية
قد تحتاج في بعض الأحيان إلى الرجوع سريعًا إلى إصدار أقدم من تطبيقك، مثلاً إذا اكتشفت خطأً فادحًا في عملية طرح تم نشرها حديثًا أو إذا كنت تواجه عملية إنشاء غير مستقرة تمنع عمليات الطرح الجديدة. في مثل هذه الحالات، يمكنك استعادة صورة حاوية حالية من اختيارك من عملية طرح سابقة. لا تتم إعادة إنشاء هذه الصورة، ولكن يتم استخدام رمز البرمجة وإعدادات البيئة من وقت إنشائها لأول مرة.
لإنشاء عملية تراجع فورية:
- في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
- انقر على عرض للخادم الخلفي الذي تريد إنشاء عملية تراجع له.
- انقر على علامة التبويب عمليات الطرح.
- في جدول السجلّ للخادم الخلفي، انقر على قائمة النقاط الثلاث لإنشاء سابق.
- انقر على التراجع عن التغييرات إلى هذا الإنشاء وأكِّد ذلك.
إعادة الإنشاء والتراجع عن التغييرات
إذا أردت الرجوع إلى إصدار أقدم من تطبيقك مع الاحتفاظ بالإعدادات الحالية، يمكنك إعادة إنشاء التطبيق كجزء من عملية العودة إلى الحالة السابقة. على سبيل المثال، إذا عدّل أحدث إصدار قيمة مفتاح واجهة برمجة التطبيقات في Secret Manager، يمكن أن تضمن عملية إعادة الإنشاء استخدام المفتاح الجديد في تطبيقك بعد التراجع عن التغييرات.
لإعادة الإنشاء والتراجع عن التغييرات:
- في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
- انقر على عرض لوحة البيانات للخادم الخلفي الذي تريد إنشاء عملية تراجع له.
- انقر على علامة التبويب عمليات الطرح.
- انقر على إنشاء عملية طرح.
- في مربّع الحوار إنشاء عملية طرح ، انقر على التزام سابق ، ثم أدخِل رقم تعريف الالتزام للإصدار الذي تريد إعادة إنشائه والتراجع عن التغييرات إليه. رقم تعريف الالتزام هو جزء من "تفاصيل التغيير" لكل عملية طرح مدرَجة في سجلّ عمليات الطرح ، وهو مضمّن بين أقواس في التصنيف.
- انقر على إنشاء لبدء عملية العودة إلى الحالة السابقة.
تغيير إعدادات عمليات الطرح
يمكنك تغيير الفرع المباشر لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها باستخدام عناصر التحكّم في طريقة العرض الإعدادات > النشر في لوحة بيانات الخادم الخلفي.
- في Firebase console، انتقِل إلى الاستضافة والخدمات بلا خادم > استضافة التطبيقات.
- انقر على عرض للخادم الخلفي الذي تريد تعديل إعدادات عمليات الطرح فيه.
- في لوحة بيانات الخادم الخلفي، انقر على الإعدادات. تعرض طريقة العرض التلقائية معلومات عن النطاقات والنطاقات المخصّصة.
- انقر على طريقة العرض النشر. في طريقة العرض هذه، يمكنك تغيير الفرع المباشر لعمليات الطرح وإيقاف عمليات الطرح التلقائية أو تفعيلها. بالإضافة إلى ذلك، تتوفّر خيارات لضبط دليل جذر التطبيق والبيئة لـ الخادم الخلفي (راجِع النشر في بيئات متعددة).
إدارة عمليات الطرح التلقائية
تفترض خدمة App Hosting تلقائيًا قائمة "مطلوبة" بـ جميع الملفات، ما يعني أنّ كل التزام جديد في مستودعك يؤدي إلى إنشاء عملية إنشاء وعملية طرح جديدتَين. ومع ذلك، لتوفير الوقت ومنع عمليات النشر غير الضرورية، يمكنك ضبط App Hosting لتخطّي عمليات الإنشاء استنادًا إلى مسارات الملفات المحدّدة التي تم تعديلها في التزام.
يمكنك ضبط ذلك ضمن الإعدادات > عمليات الطرح > مشغّلات عمليات الطرح. هنا، يمكنك ترك حقل المسارات المطلوبة فارغًا إذا كنت تريد أن يؤدي كل التزام جديد في مستودعك إلى تفعيل عملية إنشاء وعملية طرح جديدتَين، أو يمكنك تحديد الأدلة أو الملفات التي يجب أن تؤدي دائمًا إلى عملية طرح. إذا حدّدت الأدلة، احرص على إضافة جميع المسارات التي يجب أن تؤدي التغييرات فيها إلى عملية طرح.
لن تؤدي الأدلة أو الملفات التي تضيفها إلى المسارات التي تم تجاهلها إلى عملية طرح تلقائية مطلقًا. في الحالات التي يندرج فيها دليل فرعي ضمن كل من القائمتَين المطلوبة والمتجاهَلة، لن يتم تفعيل عملية طرح تلقائية. إذا ملأت قائمة المسارات التي تم تجاهلها فقط، سيملأ App Hosting تلقائيًا الحقل "*" للمسارات المطلوبة.
إذا نقلت التزامًا لا يتطابق فيه أي من الملفات التي تم تغييرها مع المسارات المطلوبة
(أو إذا تم استبعاد جميع التغييرات بشكلٍ صريح من خلال المسارات التي تم تجاهلها)،
App Hosting ستظل تقرّ باستلام حدث GitHub، ولكنها ستضع
علامة على حالتَي الإنشاء وعملية الطرح على أنها SKIPPED، ولن يتم
تفعيل أي عملية طرح تلقائية.