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

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

قم بإدراج مثيلات الامتداد المثبتة للمشروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. في علامة التبويب Dashboard بلوحة التحكم الخاصة بالوظائف ، حدد الوظيفة المحددة لملحق Firebase الذي تريد التحقق منه.

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

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. لإعادة تكوين ملحق بشكل تفاعلي في بيان الملحقات ، قم بتشغيل أمر تكوين الملحق:

   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