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

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


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

يمكنك عرض قائمة بكل نسخة من الإضافات التي ثبَّتها.

نفِّذ الأمر extensions-list:

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

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

  1. انتقِل إلى لوحة بيانات Firebase Extensions في Firebase console.

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

مراقبة نسخة من الإضافات المثبَّتة

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

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

يُنصح بشكل عام بضبط تنبيهات الميزانية، ولكن قد تكون التنبيهات مهمة بشكل خاص عندما تثق في رمز برمجية تابعة لجهة أخرى لتشغيلها في مشروعك.

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

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

  1. انتقِل إلى لوحة بيانات الدوال في Firebase console.

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

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

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

عرض مهام Cloud Scheduler التي أنشأتها الإضافات

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

  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. في صفحة التفاصيل، افتح قسم واجهات برمجة التطبيقات والموارد. إذا كانت الإضافة تستخدِم Cloud Tasks، سيظهر قسم قوائم انتظار مهام Cloud Tasks يتضمّن إدخالاً واحدًا أو أكثر.

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

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

  1. افتح صفحة Secret Manager لمشروعك في الـ Google Cloud console.

  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 console المعروضة، يمكنك الاطّلاع على تفاصيل عمليات استدعاء مختلفة لدالة معيّنة، ويمكنك حتى فحص رمز المصدر الخاص بها.

عرض سجلّات إحدى الإضافات

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

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

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

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

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

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

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

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

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

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

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

إعادة ضبط نسخة من الإضافات المثبَّتة

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

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

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

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

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

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

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

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

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

إليك كيفية إلغاء تثبيت إحدى الإضافات:

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

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

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