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

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

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

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

شغِّل الأمرextensions-list (قائمة الإضافات):

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

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

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

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

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

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

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

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

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

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

    مثلاً: ext-awesome-task-simplifier-onUserCreate

عرض مهام Cloud Scheduler التي تم إنشاؤها باستخدام الإضافات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    مثلاً: ext-awesome-task-simplifier-API_KEY

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

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

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

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

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

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

  1. في علامة التبويب لوحة البيانات ضمن لوحة بيانات الدوال، حدِّد موقع الوظيفة المحددة لإضافة Firebase التي تريد التحقق منها.

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

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

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

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

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

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

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

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

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

  1. لتحديث مثيل إضافة في بيان الإضافات إلى أحدث إصدار، شغِّل أمر تحديث الإضافة:

    firebase ext:update extensionInstanceId

    للتحديث إلى إصدار معيَّن، قدِّم الإصدار الذي تريد التحديث إليه:

    firebase ext:update extensionInstanceId versionNumber

  2. بعد ذلك، لنشر الإضافات في ملف البيان في مشروع Firebase، شغِّل: 

    firebase deploy --only extensions --project=projectId-or-alias

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

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

  1. لإعادة ضبط إضافة بشكل تفاعلي في بيان الإضافات، يمكنك تشغيل الأمر Configuration (ضبط الإضافة):

    firebase ext:configure extensionInstanceId

  2. بعد ذلك، لنشر الإضافات في ملف البيان في مشروع Firebase، شغِّل: 

    firebase deploy --only extensions --project=projectId-or-alias

إلغاء تثبيت مثيل إحدى الإضافات

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

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

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

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

  1. لإزالة مثيل إضافة من بيان الإضافات، شغِّل الأمر "إلغاء تثبيت الإضافة":

    firebase ext:uninstall extensionInstanceId

  2. بعد ذلك، لنشر التغييرات في ملف البيان في مشروع Firebase، شغِّل: 

    firebase deploy --only extensions --project=projectId-or-alias