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

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

عرض تفاصيل وتكوين مثيل ملحق مثبت

1. انتقل إلى لوحة معلومات Firebase Extensions في وحدة تحكم Firebase.

2. على بطاقة مثيل الملحق المثبت ، انقر فوق إدارة .

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

في وحدة تحكم 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 Extensions ، ثم على بطاقة مثيل الملحق المثبت ، انقر فوق إدارة .

2. في الزاوية العلوية اليمنى ، انقر فوق تحديث الامتداد .

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

3. راجع الجديد في التحديث وقم بتكوين الامتداد (إذا لزم الأمر).

4. انقر فوق تحديث الامتداد .

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

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

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

2. في الزاوية العلوية اليمنى ، انقر فوق إعادة تكوين الامتداد .

3. اتبع التعليمات التي تظهر على الشاشة لإعادة تكوين قيم المعلمات لإضافتك.

4. انقر فوق حفظ .

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

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

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

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

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

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

2. في الجزء السفلي من الشاشة ، انقر فوق إلغاء التثبيت .

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