توفّر Firebase Hosting أدوات من خلال وحدة تحكّم Firebase وFirebase واجهة سطر الأوامر لإدارة القنوات والإصدارات لموقعك الإلكتروني على Hosting.
نظرة عامة على بنية Hosting التحتية
يساعدك فهم بنية Hosting في فهم خيارات الإدارة الموضّحة في هذه الصفحة.
يحتوي كل مشروع على Firebase على Hosting موقع تلقائي يمكنه الوصول إلى جميع موارد المشروع (قواعد البيانات والمصادقة والدوالّ وغيرها). يحتوي الموقع الإلكتروني على قناة واحدة أو أكثر، تكون كلّ قناة مرتبطة بعنوان URL يعرض محتوى معيّنًا وإعدادات Hosting.
التسلسل الهرمي لاستضافة 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 من علامة التبويب مساحة التخزين في وحدة التحكّم.ماذا يحدث عند الحد من الإصدارات التي تريد الاحتفاظ بها؟
عند ضبط حدّ أقصى للإصدارات التي تريد الاحتفاظ بها، يتم تحديد موعد لحذف محتوى أي إصدارات تتجاوز الحدّ الأقصى الذي حدّدته، بدءًا من الإصدارات الأقدم أولاً.
في ما يلي كيفية ضبط الحد الأقصى لمساحة التخزين المتوفّرة لإصدارات القناة:
في وحدة تحكّم Firebase، انتقِل إلى مربّع حوار إعدادات مساحة التخزين للإصدار:
بالنسبة إلى قناتك المباشرة
في جدول سجلّ الإصدارات لموقعك الإلكتروني، انقر على ، ثم اختَر إعدادات مساحة تخزين الإصدارات.في أي قناة معاينة
في صفّ قناة المعاينة، انقر على ، ثم اختَر إعدادات القناة.
أدخِل عدد الإصدارات التي تريد الاحتفاظ بها، ثم انقر على حفظ.
ضبط مدة انتهاء صلاحية قناة معاينة
تنتهي صلاحية قناة المعاينة تلقائيًا بعد 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
كمعرّف القناة. - إذا لم تكن القناة "المستهدفة" المحدّدة متوفّرة بعد، ينشئ هذا الأمر القناة قبل نشر الإصدار إليها.
- بالنسبة إلى القناة المباشرة، استخدِم
العودة إلى إصدار سابق من موقعك الإلكتروني
يمكنك الرجوع إلى عرض نسخة سابقة من قناة البث المباشر لموقعك الإلكتروني. يكون هذا الإجراء مفيداً إذا كان الإصدار الحالي يتضمّن مشكلة وأردت الرجوع إلى إصدار سابق لعرض إصدار معروف وصالح من موقعك الإلكتروني. أو ربما كان موقعك الإلكتروني يعرض محتوًى مؤقتًا بمناسبة عطلة أو حدث خاص، ولكنّك تريد الآن التراجع عن ذلك لعرض المحتوى "العادي".
من خلال التراجع، يمكنك إنشاء إصدار جديد يعرض الإصدار نفسه من المحتوى مثل الإصدار السابق. في جدول سجلّ الإصدارات، سيدرج كلا الإصدارين معرّف الإصدار نفسه.
إليك كيفية التراجع عن التغييرات:
في وحدة تحكّم Firebase، في جدول سجلّ الإصدارات لموقعك الإلكتروني، مرِّر مؤشّر الماوس فوق إدخال الإصدار السابق الذي تريد الرجوع إليه.
انقر على
، ثم اختَر الرجوع.
حذف إصدار يدويًا
قد تحتاج إلى حذف إصدار يدويًا من قناتك المباشرة لإخلاء مساحة تخزين بسعة Hosting لمشروعك. يمكنك حذف الإصدارات السابقة فقط، وليس الإصدار الذي يتم عرضه حاليًا على موقعك الإلكتروني المنشور.
عند حذف إصدار، يتم حذف محتواه الذي يتم تحديد موعد لحذفه في غضون 24 ساعة. يتم الاحتفاظ بعنصر الإصدار نفسه كي يظل بإمكانك الاطّلاع على بياناته الوصفية (المُشغِّل ووقت التشغيل).
في ما يلي كيفية حذف إصدار:
في Firebase وحدة التحكّم، في جدول سجلّ الإصدارات لموقعك الإلكتروني، مرِّر مؤشر الماوس فوق إدخال الإصدار السابق الذي تريد حذفه.
انقر على
، ثم اختَر حذف.
حذف الملفات يدويًا
في Firebase Hosting، الطريقة الأساسية لحذف الملفات المحددة من موقع إلكتروني تم نشره هي حذف الملفات محليًا ثم إعادة نشرها.
حذف قناة معاينة يدويًا
يمكنك معاينة قنواتك من خلال النقر على القناة التي تريد معاينتها. من طريقة العرض هذه، يمكنك الاطّلاع على أحدث عمليات النشر والإصدارات المرتبطة بالقناة المحدّدة وحذفها والعودة إليها. يمكنك حذف قناة معاينة، ولكن لا يمكنك حذف قناة موقعك الإلكتروني المنشورة.
عند حذف قناة معاينة، يتم تحديد موعد لحذف القناة وإصداراتها وإصداراتها المرتبطة في غضون 24 ساعة. ويتم أيضًا إيقاف عنوان URL المرتبط بالمعاينة. هناك استثناء من عملية حذف الإصدار، وهو إذا كان الإصدار مرتبطًا بإصدار آخر (يحدث ذلك مثلاً إذا نسخت إصدارًا من قناة إلى أخرى ضمن الموقع الإلكتروني نفسه).
تتيح منصة Hosting طريقتَين مختلفتَين لحذف قناة معاينة:
وحدة تحكّم Firebase
في صفّ قناة المعاينة، انقر على ، ثم اختَر حذف القناة. أكد الحذف.Firebase سطر الأوامر
نفِّذ الأمر التالي من أي دليل:firebase hosting:channel:delete CHANNEL_ID
أوامر واجهة سطر الأوامر لمعاينة القنوات ونسقها
الأوامر لقنوات المعاينة
تتيح جميع أوامر قنوات المعاينة استهدافات النشر إذا كان لديك مواقع Hosting متعددة.
الطلب | الوصف |
---|---|
firebase hosting:channel:create CHANNEL_ID
|
إنشاء قناة معاينة جديدة في
الموقع الإلكتروني Hosting التلقائي باستخدام
لا يؤدي هذا الأمر إلى نشر التطبيق على القناة. |
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 \
|
يستنسخ أحدث إصدار تم نشره على قناة "المصدر" المحددة إلى القناة "المستهدفة" المحددة يتم أيضًا نشر هذا الأمر على القناة "المستهدفة" المحدّدة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" Hosting قبل نشرها في القناة. |
firebase hosting:clone \
|
نسخ الإصدار المحدّد إلى القناة "المستهدفة" المحدّدة يتم أيضًا نشر هذا الأمر إلى قناة "الهدف" المحددة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" Hosting قبل نشرها في القناة. يمكنك العثور على |