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