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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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