إدارة إضافات Firebase المثبَّتة

لتثبيت الإضافات أو إدارتها، يجب أن يكون لديك أحد الدورَين التاليَين: المالك أو المحرِّر أو مشرف Firebase.


إدراج نُسخ الإضافات المثبَّتة في المشروع

يمكنك إدراج كل مثيل من الإضافات التي ثبّتها.

شغِّل الأمر extensions-list:

firebase ext:list --project=projectId-or-alias

عرض تفاصيل مثيل إضافة مثبّت وإعداداته

  1. انتقِل إلى لوحة بيانات Firebase Extensions في وحدة تحكّم Firebase.

  2. في بطاقة مثيل الإضافة المثبّت، انقر على إدارة.

مراقبة مثيل إضافة مثبَّتة

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

ضبط تنبيهات الميزانية

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

تأكَّد من إعداد تنبيهات بشأن الميزانية لمشروعك على Firebase.

عرض الوظائف التي أنشأتها الإضافات

  1. انتقِل إلى لوحة بيانات Functions في وحدة تحكّم Firebase.

  2. في علامة التبويب لوحة البيانات، يمكنك الاطّلاع على الدوالّ من Firebase Extensions (إلى جانب أي دوالّ أخرى تم نشرها لمشروعك).

    تتضمّن الدوال التي أنشأتها الإضافات أسماءً بالتنسيق: ext-extension-instance-id-functionName

    على سبيل المثال: ext-awesome-task-simplifier-onUserCreate

عرض Cloud Scheduler وظيفة تم إنشاؤها بواسطة الإضافات

  1. افتح صفحة Cloud Scheduler لمشروعك في وحدة تحكّم Google Cloud.

  2. في قائمة "المهام"، يمكنك الاطّلاع على مهام Cloud Scheduler من Firebase Extensions (إلى جانب أي مهام أخرى أنشأتها لمشروعك ).

    تتسم المهام التي تم إنشاؤها بواسطة الإضافات بأسماء بالتنسيق التالي: firebase-ext-extension-instance-id-functionName

    مثلاً: firebase-ext-awesome-task-simplifier-doTask

عرض وإدارة مهام Cloud Tasks التي تم إدراجها في قائمة الانتظار بواسطة الإضافات

تستخدم بعض الإضافات خدمة Cloud Tasks لتنفيذ المهام الأطول مدة: في معظم الأحيان، معالجة المهام التي يتم تنفيذها في نقاط مختلفة في دورة حياة الإضافة، مثل التثبيت وإعادة الضبط وبعد عمليات الترقية.

وعادةً ما يتم تنفيذ هذه المهام وإكمالها تلقائيًا بدون تدخل منك. ومع ذلك، إذا كنت بحاجة إلى إدارة المهام المُدرَجة في "قائمة الانتظار" لإحدى الإضافات يدويًا، على سبيل المثال، لإيقاف قائمة الانتظار مؤقتًا أو إزالة مهمة لم تبدأ بعد من قائمة الانتظار، اتّبِع الخطوات التالية:

  1. في قسم الإضافات في وحدة تحكُّم Firebase، افتح صفحة تفاصيل النسخة الافتراضية للإضافة.

  2. في صفحة التفاصيل، افتح قسم واجهات برمجة التطبيقات والموارد. إذا كانت الإضافة تستخدم "مهام Google" في السحابة الإلكترونية، سيكون هناك قسم قوائم انتظار المهام في السحابة الإلكترونية يتضمن إدخالاً واحدًا أو أكثر.

  3. انقر على عرض "القائمة المتوفّرة" للقائمة التي تريد إدارتها. سيؤدي ذلك إلى فتح صفحة تفاصيل "القائمة الانتظار" في وحدة تحكّم Google Cloud، والتي يمكنك من خلالها الاطّلاع على المهام المُدرَجة في "القائمة الانتظار" وإيقاف "القائمة الانتظار" مؤقتًا وإزالة المهام من "القائمة الانتظار" وما إلى ذلك. اطّلِع على إدارة قوائم الانتظار والمهام في مستندات Cloud Tasks.

عرض أسرار Cloud Secret Manager التي أنشأتها الإضافات

  1. افتح صفحة مدير الأسرار في مشروعك في وحدة تحكّم Google Cloud.

  2. في قائمة "السرّيات"، يمكنك الاطّلاع على الأسرار التي تم إنشاؤها لتطبيق Firebase Extensions (بالإضافة إلى أيّ أسرار أخرى أنشأتها لمشروعك ).

    تكون أسماء الأسرار التي أنشأتها الإضافات بالتنسيق التالي: ext-extension-instance-id-paramnName

    على سبيل المثال: ext-awesome-task-simplifier-API_KEY

    يتم تصنيف الأسرار باستخدام المفتاح firebase-extensions-managed. لا تزِل هذا التصنيف إلا إذا كنت تريد منع Firebase من إدارة السر.

التحقّق مما إذا كانت الإضافة المثبّتة سليمة

يمكنك مراجعة جميع الأخطاء من الدوال (بما في ذلك تلك التي تم إنشاؤها من خلال "Firebase Extensions") في وحدة التحكّم.

  1. في علامة التبويب Health ضِمن لوحة بيانات الدوال، يمكنك الاطّلاع على نظرة عامة على الأخطاء ومعلومات الأداء لجميع الوظائف في مشروعك.

  2. للاطّلاع على معلومات عن إضافة معيّنة، استخدِم الفلتر في أعلى الصفحة لاختيار دالة معيّنة.

التحقّق من عدد مرات تشغيل إضافة مثبَّتة

  1. في علامة التبويب لوحة البيانات ضمن لوحة بيانات الدوالّ، ابحث عن الدالة المحدّدة للعنصرFirebase Extension الذي تريد التحقّق منه.

  2. انقر على (القائمة الكاملة) في أقصى الجانب الأيسر من الإدخال، ثم اختَر إحصاءات الاستخدام التفصيلية.

  3. في وحدة تحكّم Google Cloud المعروضة، يمكنك التوغّل في عدة أنواع من الاستدعاءات لدالة ما، وفحص رمز المصدر الخاص بها.

عرض سجلّات إضافة

إذا كنت تحاول تصحيح الأخطاء لمشروعك أو إرسال تقرير خطأ إلى Firebase، من المفيد الاطّلاع على سجلات الوظائف التي تعمل في مشروعك.

في علامة التبويب السجلات ضمن لوحة بيانات الدوال، استخدِم الفلتر في أعلى الصفحة لاختيار الدوال التي أنشأتها الإضافة.

تحديث نسخة مُثبَّتة من إضافة إلى أحدث إصدار

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

عند تحديث مثيل، يتم استبدال جميع الموارد والمنطق الخاصة بإضافة المثيل لاستخدام رمز المصدر وملفات الإصدار الجديد. لن يتغيّر رقم تعريف النسخة الافتراضية لإضافة Chrome Extension وحساب الخدمة.

أثناء عملية التحديث، سيتم إعلامك بأي تغييرات في الإصدار الجديد، وسيكون بإمكانك تحديد قيم لأي معلمات جديدة.

  1. انتقِل إلى لوحة بيانات Firebase Extensions، ثم انقر على إدارة في بطاقة النسخة الافتراضية للإضافة المثبَّتة.

  2. في أعلى يسار الصفحة، انقر على تعديل فترة التمديد.

    إذا لم يكن هناك إصدار جديد متاح من الإضافة، لن يظهر زر تحديث في صفحة التفاصيل.

  3. راجِع الميزات الجديدة في التحديث واضبط الإضافة (إذا لزم الأمر).

  4. انقر على تعديل الإضافة.

إعادة ضبط مثيل الإضافة المثبّتة

ويمكنك تغيير قيم المَعلمات التي ضبطها المستخدِم لمثيل الإضافة المثبَّتة. سيتم استخدام هذه القيم الجديدة في أي مشغِّلات مستقبلية للمثيل، ولكن لن يتم تغيير كل العناصر أو العناصر الهيكلية السابقة التي تم إنشاؤها من خلال الإضافة (مثل الصور المخزّنة أو حِزم التخزين الحالية).

  1. انتقِل إلى لوحة بيانات Firebase Extensions، ثم انقر على إدارة في بطاقة مثيل الإضافة المُثبَّتة.

  2. في أعلى يسار الصفحة، انقر على إعادة ضبط الإضافة.

  3. اتّبِع التعليمات الظاهرة على الشاشة لإعادة ضبط قيم المَعلمات لإضافة البيانات.

  4. انقر على حفظ.

إلغاء تثبيت مثيل إضافة

يمكنك إلغاء تثبيت مثيل إضافة من مشروع Firebase. يؤدي هذا الإجراء إلى حذف حساب الخدمة وجميع الموارد (مثل مجموعة الوظائف) التي أنشأها Firebase خصيصًا لذلك المثيل من الإضافة. في المقابل، لا يتم حذف ما يلي:

  • أي عناصر تم إنشاؤها من خلال الإضافة (مثل الصور المخزّنة).

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

في ما يلي كيفية إلغاء تثبيت إضافة:

  1. انتقِل إلى لوحة بيانات Firebase Extensions، ثم انقر على إدارة في بطاقة مثيل الإضافة المثبّتة.

  2. في أسفل الشاشة، انقر على إلغاء تثبيت الإضافة.

  3. راجِع المحتوى الذي سيتم حذفه، ثم انقر على إلغاء تثبيت الإضافة لتأكيد الحذف.