إدارة ملحقات Firebase المثبتة

لتثبيت الإضافات أو إدارتها ، يجب أن يتم تعيين أحد هذه الأدوار لك: المالك أو المحرر أو مسؤول Firebase .

سرد مثيلات ملحق المشروع المثبتة

يمكنك سرد كل مثيل من الامتدادات التي قمت بتثبيتها.

قم بتشغيل أمر قائمة الملحقات:

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

مراقبة مثيل ملحق مثبت

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

تعيين تنبيهات الميزانية

يعد إعداد تنبيهات الميزانية ممارسة جيدة بشكل عام ، ولكن قد تكون التنبيهات مهمة بشكل خاص عندما تثق في رمز طرف آخر ليتم تشغيله في مشروعك.

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

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

1. انتقل إلى لوحة معلومات الوظائف الخاصة بوحدة تحكم Firebase.

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

   الوظائف المُنشأة بواسطة الامتدادات لها أسماء ، بالتنسيق: ext- extension-instance-id - functionName

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

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

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

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

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

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

عرض وإدارة مهام السحابة المدرجة في قائمة الامتدادات

تستخدم بعض الإضافات مهام السحابة لتشغيل مهام أطول: في أغلب الأحيان ، معالجة المهام التي تعمل في نقاط مختلفة في دورة حياة الإضافة — التثبيت وإعادة التكوين وبعد الترقيات.

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

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

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

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

عرض أسرار Cloud Secret Manager التي تم إنشاؤها بواسطة الامتدادات

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

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

   الأسرار التي تم إنشاؤها بواسطة الامتدادات لها أسماء بالتنسيق: ext- extension-instance-id - paramnName

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

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

تحقق مما إذا كانت الامتداد المثبت سليمًا

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

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

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

تحقق من عدد مرات تشغيل ملحق مثبت

1. في علامة التبويب Dashboard في لوحة معلومات الوظائف ، حدد الوظيفة المحددة لـ Firebase Extension التي تريد التحقق منها.

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

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

عرض السجلات للحصول على ملحق

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

في علامة التبويب "السجلات" في لوحة معلومات الوظائف ، استخدم عامل التصفية الموجود أعلى الصفحة لتحديد الوظائف التي تم إنشاؤها بواسطة الامتداد الخاص بك.

قم بتحديث مثيل ملحق مثبت إلى أحدث إصدار

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

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

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

1. لتحديث مثيل ملحق في بيان امتداداتك إلى أحدث إصدار ، قم بتشغيل أمر تحديث الملحق:

   firebase ext:update extensionInstanceId

   للتحديث إلى إصدار معين ، قم بتوفير الإصدار الذي تريد التحديث إليه:

   firebase ext:update extensionInstanceId versionNumber

2. بعد ذلك ، لنشر الامتدادات في البيان الخاص بك على مشروع Firebase ، قم بتشغيل:

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

أعد تكوين مثيل ملحق مثبت

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

1. لإعادة تكوين ملحق بشكل تفاعلي في بيان الإضافات ، قم بتشغيل أمر تكوين الملحق:

   firebase ext:configure extensionInstanceId

2. بعد ذلك ، لنشر الامتدادات في البيان الخاص بك على مشروع Firebase ، قم بتشغيل:

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

إلغاء تثبيت مثيل ملحق

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

• أي قطع أثرية تم إنشاؤها بواسطة الامتداد (مثل الصور المخزنة).

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

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

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

   firebase ext:uninstall extensionInstanceId

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

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