إدارة إضافات 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 console، افتح صفحة تفاصيل مثيل الإضافة.

  2. في صفحة التفاصيل، افتح قسم واجهات برمجة التطبيقات والموارد. إذا كانت الإضافة تستخدم "مهام Google"، سيظهر قسم قوائم انتظار "مهام 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. في علامة التبويب الأداء ضمن لوحة بيانات الدوالّ، يمكنك الاطّلاع على نظرة عامة حول الأخطاء ومعلومات الأداء لجميع الدوالّ في مشروعك.

  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. راجِع المحتوى الذي سيتم حذفه، ثم انقر على إلغاء تثبيت الإضافة لتأكيد الحذف.