النشر في البث المباشر معاينة القنوات عبر طلبات السحب في GitHub

يمكنك دمج عمليات النشر في Firebase Hosting من خلال GitHub Action. إليك ما يمكن أن يقدّمه لك هذا الإجراء في GitHub:

  • ينشئ قناة معاينة جديدة (وعنوان URL المرتبط بها) لكل طلب سحب في مستودع GitHub.

  • يضيف تعليقًا إلى طلب السحب يتضمّن عنوان URL للمعاينة ليتمكّن كل من المراجعين من عرض التغييرات في طلب السحب واختبارها في إصدار "معاينة" من تطبيقك.

    صورة لتعليق على طلب سحب في GitHub Action يتضمّن عنوان URL للمعاينة

  • تعدّل عنوان URL الخاص بالمعاينة وفقًا للتغييرات الواردة في كل عملية إيداع من خلال النشر تلقائيًا في قناة المعاينة المرتبطة. لا يتغيّر عنوان URL مع كل عملية إيداع جديدة.

  • (اختياري) ينشر هذا الخيار الحالة الحالية لمستودع GitHub على قناتك المباشرة عند دمج طلب السحب.

تذكير: عند استخدام عناوين URL للمعاينة، يتفاعل تطبيقك مع موارد الخلفية الحقيقية لمشروعك على Firebase.

إعداد GitHub Action للنشر على Firebase Hosting

  1. أنشئ مستودع GitHub (عامًا أو خاصًا) أو استخدِم مستودعًا حاليًا. يجب أن يكون لديك أذونات المشرف للمستودع.

  2. في نسخة محلية من مستودعك، يمكنك إعداد Firebase Hosting باستخدام الأمر firebase init.

    • إذا لم تكن قد أعددت Hosting، شغِّل هذا الإصدار من الأمر من جذر الدليل المحلي:

      firebase init hosting

    • إذا سبق لك إعداد Hosting، ما عليك سوى إعداد جزء GitHub Action من Hosting. نفِّذ هذه النسخة من الأمر من جذر الدليل المحلي:

      firebase init hosting:github

  3. اتّبِع طلبات واجهة سطر الأوامر، وسيتولّى الأمر تلقائيًا إعداد GitHub Action:

    • ينشئ هذا الأمر حساب خدمة في مشروعك على Firebase لديه إذن بالتوزيع على Firebase Hosting.

    • يشفّر مفتاح JSON لحساب الخدمة هذا ويحمّله إلى مستودع GitHub المحدّد كـ سر GitHub.

    • يكتب ملفات إعداد yaml لسير عمل GitHub تشير إلى السر الذي تم إنشاؤه حديثًا. تضبط هذه الملفات GitHub Action على النشر إلى Firebase Hosting.

  4. في GitHub، أنشئ فرعًا جديدًا وأضِف ملفات سير العمل yaml التي أنشأتها واجهة سطر الأوامر.

  5. انشر الفرع في مستودع GitHub.

  6. دمج الفرع

وهذا كل ما في الأمر! سيحصل تلقائيًا أي طلب سحب لاحق في مستودع GitHub هذا على "عنوان URL للمعاينة" خاص به.

مزيد من المعلومات حول GitHub Action

  • يحتفظ Firebase بإجراء GitHub‏ "Deploy to Firebase Hosting" كمشروع مفتوح المصدر. عرض رمز المصدر

  • يتيح إجراء GitHub "النشر إلى Firebase Hosting" المزيد من خيارات الإعداد، مثل تخصيص تاريخ انتهاء صلاحية قناة المعاينة أو ضبط قناة غير مباشرة ليتم النشر إليها عند دمج طلب سحب. مزيد من المعلومات عن خيارات الإعداد المتاحة

  • يمكنك الاطّلاع على مزيد من المعلومات عن GitHub Actions بشكل عام.