بدء استخدام استضافة التطبيقات

باستخدام تطبيق Next.js أو Angular حالي (إصدار Next.js بالإصدار 13 أو إصدار أحدث أو إصدار Angular 17.2 أو إصدار أحدث) في مستودع جيت هب، فإن بدء استخدام App Hosting يمكن أن يكون عملية بسيطة مثل إنشاء واجهة App Hosting خلفية ثم بدء وطرحه بدعوة إلى فرعك المباشر. إذا لم يكن لديك تطبيق، استخدِم أحد لنماذج التطبيقات التي نقدّمها، اتّبِع الخطوات الموضّحة في هذا الدليل.

قبل البدء

عليك إنشاء منصّة Firebase لتتمكّن من إعداد Firebase App Hosting. (إذا لم يكن لديك مشروع بالفعل) والترقية إلى خطة Blaze.

لإنشاء مشروع، اتّبِع الخطوات التالية:

  1. في وحدة تحكُّم Firebase، انقر على إضافة مشروع.

    • لإضافة موارد Firebase إلى مشروع Google Cloud حالي، أدخِل اسم المشروع أو حدده من القائمة المنسدلة.

    • لإنشاء مشروع جديد، أدخِل اسم المشروع المطلوب. يمكنك أيضًا اختيار تعديل رقم تعريف المشروع المعروض أسفل اسم المشروع.

  2. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك.

  3. انقر على متابعة.

  4. (اختياري) يمكنك إعداد Google Analytics لمشروعك، والتي تمكّنك من للحصول على أفضل تجربة باستخدام أيٍّ من منتجات Firebase التالية:

    يمكنك تحديد إما حساب Google Analytics أو إنشاء حساب جديد.

    إذا أنشأت حسابًا جديدًا، اختَر الإبلاغ عن موقع جغرافي واحد (Analytics)، ثم قبول إعدادات مشاركة البيانات وبنود Google Analytics لمشروعك.

  5. انقر على إنشاء مشروع (أو إضافة Firebase إذا كنت تستخدم مشروع Google Cloud الحالي).

يوفّر Firebase تلقائيًا الموارد لمشروعك على Firebase. فعندما اكتمال العملية، سيتم توجيهك إلى صفحة النظرة العامة الخاصة بمنصة Firebase مشروع في وحدة تحكُّم "Firebase".

الخطوة 0 (اختيارية): إنشاء تطبيق ويب ومستودع GitHub

إذا لم يكن لديك تطبيق ويب في مستودع جيت هب، أو إذا كنت بدلاً من ذلك جرب التدفق باستخدام نموذج تطبيق، وابدأ بتهيئة إحدى العينات، إما لـ Next.js أو Angular:

npm init @apphosting

يمكنك تشغيل نموذج التطبيق محليًا باستخدام next dev أو ng start. للمتابعة، إنشاء مستودع GitHub جديد ودفع نموذج التعليمات البرمجية الذي تم إعداده حديثًا إليه.

الخطوة 1: إنشاء واجهة App Hosting في الخلفية

الواجهة الخلفية App Hosting هي مجموعة من الموارد المُدارة التي ينشئ App Hosting لإنشاء تطبيق الويب وتشغيله. يمكنك إنشاء قائمة خلفيات App Hosting التي تستخدم وحدة تحكُّم Firebase Firebase واجهة سطر الأوامر

وحدة تحكم Firebase: من قائمة إنشاء، اختر استضافة التطبيق ثم البدء

CLI: (الإصدار 3.9 أو إصدار أحدث) لإنشاء واجهة خلفية، شغِّل الأمر التالي من جذر دليل المشروع المحلي، وتوفير رقم تعريف المشروع كوسيطة (للمعاينة، يتم اعتماد منطقة us-central1 فقط):

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

لكل من وحدة التحكم أو واجهة سطر الأوامر، اتبع التعليمات لتعيين اسم للواجهة الخلفية إعداد اتصال GitHub وضبط إعدادات النشر الأساسية التالية:

  • ضبط الدليل الجذر لتطبيقك (القيمة التلقائية على /)

    وعادةً ما يكون هذا هو المكان الذي يتم وضع ملف package.json فيه.

  • ضبط الفرع المباشر

    وهذا هو فرع مستودع جيت هب الذي يتم نشره في عنوان URL منشور. غالبًا ما يكون الفرع الذي يميز الفروع أو النمو دمج فروعها.

  • قبول عمليات الطرح التلقائي أو رفضها

    تكون عمليات الطرح التلقائية مفعَّلة تلقائيًا. عند الانتهاء من إنشاء الخلفية يمكنك اختيار نشر تطبيقك على "App Hosting" على الفور.

الخطوة 2: عرض التطبيق الذي تم نشره

عند إنشاء خلفية، يمنحك Firebase نطاقًا فرعيًا بدون تكلفة حيث ينتهي بإمكان المستخدمين زيارة تطبيق الويب. الشكل backend-id--project-id.us-central1.hosted.app.

لعرض عنوان URL لتطبيق الويب، تحقَّق من وحدة تحكُّم Firebase أو شغِّل واجهة سطر الأوامر التالية :

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

الخطوة 3: بدء عملية طرح من خلال إجراء تغيير

بعد إنشاء الواجهة الخلفية والحصول على عنوان URL منشور، يمكنك إلى طرح إصدار جديد من تطبيق الويب كلما دفعت التغييرات في الفرع المباشر لمستودع جيت هب. لإجراء اختبار إعداد App Hosting:

  1. في GitHub، ادفع التغيير إلى الفرع المباشر لتطبيق الويب.
  2. افتح علامة تبويب واحدة (App Hosting) في وحدة تحكم Firebase واختَر عرض لوحة البيانات لخلفيتك. تعرض قائمة الجدول مدة الالتزام المحدّدة المرتبطة بالطرح. بسبب التغيير الذي أجريته.

الخطوات التالية