إدارة البث المباشر وقنوات المعاينة والإصدارات والإصدارات الخاصة بموقعك الإلكتروني

توفّر Firebase Hosting أدوات من خلال وحدة تحكّم Firebase وFirebase واجهة سطر الأوامر لإدارة القنوات والإصدارات لموقعك الإلكتروني على Hosting.

نظرة عامة على بنية Hosting الأساسية

يساعدك فهم بنية Hosting في فهم خيارات الإدارة الموضّحة في هذه الصفحة.

يحتوي كل مشروع على Firebase على Hosting موقع تلقائي يمكنه الوصول إلى جميع موارد المشروع (قواعد البيانات والمصادقة والدوالّ وغيرها). يحتوي الموقع الإلكتروني على قناة واحدة أو أكثر، تكون كلّ قناة مرتبطة بعنوان URL يعرض محتوى معيّنًا وإعدادات Hosting.

صورة <span class=تدرّج استضافة Firebase" />

يحتوي كل موقع على Hosting على قناة "بث مباشر" تعرض المحتوى وملف تكوين Hosting في (1) النطاقات الفرعية التي تم توفيرها من خلال Firebase في الموقع (SITE_ID.web.app و SITE_ID.firebaseapp.com) و (2) أي نطاقات مخصّصة متصلة. يمكنك أيضًا إنشاء قنوات "تجريبية" اختيارية تعرض محتوًى وإعدادات خاصة بها على "عناوين URL للتجربة" المؤقتة والتي يمكن مشاركتها (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

يتم تجميع المحتوى والإعدادات التي تعرضها كل قناة في عنصر version الذي يحتوي على معرّف فريد. عند نشر التطبيق على موقعك الإلكتروني، تنشئ Firebase عنصر إصدار يشير إلى إصدار معيّن. يحتوي الإصدار على بيانات وصفية عن عملية النشر، مثل المستخدم الذي نفّذ عملية النشر ووقت تنفيذها.

من Hosting لوحة بيانات project في Firebase، يمكنك الاطّلاع على سجلّ كامل لإصدارات قناتك المباشرة في جدول سجلّ الإصدارات. إذا كان لديك مواقع Hosting إلكترونية متعددة، انقر على عرض للموقع الإلكتروني المطلوب للاطّلاع على سجلّ إصداراته. إذا كانت لديك أي قنوات تجريبية، ستظهر أيضًا في لوحة بيانات Hosting.

إدارة إعدادات القناة

يمكنك التحكّم في إعدادات كل قناة من قنوات موقعك الإلكتروني. لا تنطبق بعض الإعدادات، مثل انتهاء صلاحية القناة، إلا على القنوات التجريبية.

الحد من عدد الإصدارات التي تريد الاحتفاظ بها

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

  • لماذا تحتفظ Hosting بالإصدارات السابقة؟
    بالنسبة إلى قناتك المباشرة، يتيح لك الاحتفاظ بالإصدارات السابقة إمكانية الرجوع إلى إصدار سابق من موقعك الإلكتروني، إذا لزم الأمر. بالنسبة إلى قنوات المعاينة، لا تتوفّر ميزة التراجع بعد.

  • لماذا يتم وضع حدّ أقصى لعدد الإصدارات التي يمكن الاحتفاظ بها؟
    يمكن أن تساعدك هذه الميزة في التحكّم في مستوى استخدام مساحة التخزين Hosting في مشروعك، لأنّه يتم الاحتفاظ بمحتوى الإصدارات السابقة في مساحة التخزين هذه. يمكنك مراقبة مساحة التخزين في Hosting من علامة التبويب مساحة التخزين في وحدة التحكّم.

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

في ما يلي كيفية ضبط الحد الأقصى لمساحة التخزين المتوفّرة لإصدارات القناة:

  1. في وحدة تحكّم Firebase، انتقِل إلى مربّع حوار إعدادات مساحة التخزين للإصدار:

    • بالنسبة إلى قناتك المباشرة
      في جدول سجلّ الإصدارات لموقعك الإلكتروني، انقر على ، ثم اختَر إعدادات مساحة التخزين للإصدار.

    • في أي قناة معاينة
      في صفّ قناة المعاينة، انقر على ، ثم اختَر إعدادات القناة.

  2. أدخِل عدد الإصدارات التي تريد الاحتفاظ بها، ثم انقر على حفظ.

ضبط مدة انتهاء صلاحية قناة معاينة

تنتهي صلاحية قناة المعاينة تلقائيًا بعد 7 أيام من تاريخ إنشائها، ولكن لن تنتهي صلاحية قناة موقعك الإلكتروني العلنية أبدًا.

عند انتهاء صلاحية قناة معاينة، يتم تحديد موعد لحذف القناة وإصداراتها والإصدارات المرتبطة بها في غضون 24 ساعة. ويتم أيضًا إيقاف عنوان URL المرتبط بالمعاينة. يُستثنى من عملية حذف الإصدارات ما إذا كان الإصدار مرتبطًا بإصدار آخر (يحدث ذلك مثلاً إذا نسخت إصدارًا من قناة إلى أخرىضمن الموقع الإلكتروني نفسه).

يتيح Hosting طريقتَين مختلفتَين للتحكّم في تاريخ انتهاء صلاحية القناة:

  • Firebase وحدة التحكّم
    في صفّ قناة المعاينة، انقر على ، ثم اختَر إعدادات القناة. أدخِل تاريخ ووقت انتهاء الصلاحية.

  • Firebase سطر الأوامر
    عند نشر التطبيق على قناة المعاينة، عليك ضبط الخيار --expires DURATION، على سبيل المثال:

    firebase hosting:channel:deploy new-awesome-feature --expires 7d

    يمكن أن تصل مدة انتهاء الصلاحية إلى 30 يومًا من تاريخ النشر. استخدِم h لتحديد الساعات وd للأيام وw للأسابيع (على سبيل المثال، 12h و7d و2w على التوالي).

استنساخ إصدار من قناة إلى أخرى

يمكنك استنساخ إصدار تم نشره من قناة إلى قناة أخرى. يمكنك النسخ على مستوى القنوات المنشورة أو القنوات المتوفّرة في وضع المعاينة، أو على مستوى Hosting موقعًا إلكترونيًا، أو حتى على مستوى مشاريع Firebase.

يؤدي أمر النسخ أيضًا إلى نشر المحتوى وHostingالإعدادات المُستنسخَين في القناة "الهدف" لكي يتم عرضهما تلقائيًا على عنوان URL المرتبط بالقناة "الهدف".

تكون هذه الميزة مفيدة لتتبُّع الإصدارات أو إذا كنت تريد التأكّد من أنّك تنشئ المحتوى نفسه الذي شاهدته و/أو اختبرتَه على قناة أخرى. وإليك بعض الأمثلة:

  • استنساخ المحتوى من قناة معاينة "الأسئلة والأجوبة" إلى القناة المنشورة على موقعك الإلكتروني (سيتم نشر المحتوى قريبًا)

  • استنساخ المحتوى من قناة موقعك الإلكتروني المنشورة إلى قناة معاينة "لتصحيح الأخطاء" (مثل قبل التراجع)

  • استنساخ من قناة في مشروع Firebase "الإصدار التجريبي" إلى قناة معاينة في مشروع Firebase "الإنتاج"

لنسخ إصدار، نفِّذ الأمر التالي من أي دليل:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

استبدِل كل عنصر نائب بما يلي:

  • SOURCE_SITE_ID وTARGET_SITE_ID: هما معرّفَا Hosting الموقعَين الإلكترونيَين اللذين يتضمّنان القنوات.

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

  • SOURCE_CHANNEL_ID وTARGET_CHANNEL_ID: هما معرّفات القنوات.

    • بالنسبة إلى القناة المباشرة، استخدِم live كمعرّف القناة.
    • إذا لم تكن القناة "المستهدفة" المحدّدة متوفّرة بعد، ينشئ هذا الأمر القناة قبل نشر الإصدار إليها.

الرجوع إلى إصدار سابق من موقعك الإلكتروني

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

من خلال التراجع، يمكنك إنشاء إصدار جديد يعرض الإصدار نفسه من المحتوى مثل الإصدار السابق. في جدول سجلّ الإصدارات، سيُدرج كلا الإصدارين معرّف الإصدار نفسه.

إليك كيفية التراجع عن التغييرات:

  1. في وحدة تحكّم Firebase، في جدول سجلّ الإصدارات لموقعك الإلكتروني، مرِّر مؤشّر الماوس فوق إدخال الإصدار السابق الذي تريد الرجوع إليه.

  2. انقر على ، ثم اختَر الرجوع.

حذف إصدار يدويًا

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

عند حذف إصدار، يتم حذف محتواه الذي يتم تحديد موعد لحذفه في غضون 24 ساعة. يتم الاحتفاظ بعنصر الإصدار نفسه كي يظل بإمكانك الاطّلاع على بياناته الوصفية (المُشغِّل ووقت التشغيل).

في ما يلي كيفية حذف إصدار:

  1. في Firebase وحدة التحكّم، في جدول سجلّ الإصدارات لموقعك الإلكتروني، مرِّر مؤشر الماوس فوق إدخال الإصدار السابق الذي تريد حذفه.

  2. انقر على ، ثم اختَر حذف.

حذف الملفات يدويًا

في Firebase Hosting، الطريقة الأساسية لحذف ملفات محدّدة من موقع إلكتروني تم نشره هي حذف الملفات محليًا، ثم إعادة نشرها.

حذف قناة معاينة يدويًا

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

عند حذف قناة معاينة، يتم تحديد موعد لحذف القناة وإصداراتها وإصداراتها المرتبطة بها في غضون 24 ساعة. ويتم أيضًا إيقاف عنوان URL المرتبط بالمعاينة. هناك استثناء من عملية حذف الإصدارات، وهو إذا كان الإصدار مرتبطًا بإصدار آخر (يحدث ذلك مثلاً إذا نسخت إصدارًا من قناة إلى أخرى ضمن الموقع الإلكتروني نفسه).

تتيح منصة Hosting طريقتَين مختلفتَين لحذف قناة معاينة:

  • وحدة تحكّم Firebase
    في صفّ قناة المعاينة، انقر على ، ثم اختَر حذف القناة. أكد الحذف.

  • Firebase سطر الأوامر
    نفِّذ الأمر التالي من أي دليل:

    firebase hosting:channel:delete CHANNEL_ID

أوامر واجهة سطر الأوامر لمعاينة القنوات ونسقها

أوامر قنوات المعاينة

تتيح جميع أوامر قنوات المعاينة استهدافات النشر إذا كان لديك مواقع Hosting متعددة.

الطلب الوصف
firebase hosting:channel:create CHANNEL_ID

إنشاء قناة معاينة جديدة في الموقع الإلكتروني Hosting التلقائي باستخدام CHANNEL_ID

لا يؤدي هذا الأمر إلى نشر التطبيق على القناة.
firebase hosting:channel:delete CHANNEL_ID

لحذف قناة المعاينة المحدّدة

لا يمكنك حذف قناة مباشرة لموقع إلكتروني.
firebase hosting:channel:deploy CHANNEL_ID

نشر محتوى Hosting وإعداداته في قناة المعاينة المحدّدة

إذا لم تكن قناة المعاينة متوفّرة بعد، ينشئ هذا الأمر القناة في الموقع الإلكتروني التلقائي Hosting قبل نشرها على القناة.

firebase hosting:channel:list عرض جميع القنوات (بما في ذلك القناة "البث المباشر") في الموقع الإلكتروني Hosting التلقائي
firebase hosting:channel:open CHANNEL_ID فتح متصفّح لعنوان URL المحدّد للقناة أو عرض عنوان URL إذا لم يكن من الممكن فتحه في متصفّح

أوامر لاستنساخ الإصدار

الطلب الوصف
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

نسخ أحدث إصدار تم نشره على قناة "المصدر" المحدّدة إلى القناة "المستهدفة" المحدّدة

يتم أيضًا نشر هذا الأمر على القناة "المستهدفة" المحدّدة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" Hosting قبل نشرها في القناة.

firebase hosting:clone \
SOURCE_SITE_ID:@VERSION_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

نسخ الإصدار المحدّد إلى القناة "المستهدفة" المحدّدة

يتم أيضًا نشر هذا الأمر على القناة "المستهدفة" المحدّدة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" Hosting قبل نشرها في القناة.

يمكنك العثور على VERSION_ID في لوحة بيانات Hosting في وحدة تحكّم Firebase.