Catch up on everything we announced at this year's Firebase Summit. Learn more

إدارة ملحقات 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

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

  1. فتح مشروعك الغيمة جدولة الصفحة في وحدة التحكم سحابة جوجل.

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

    فرص العمل التي تخلقها ملحقات لها أسماء في شكل: firebase-ext- extension-instance-id - functionName

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

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

  1. فتح مشروعك مدير سر الصفحة في وحدة التحكم سحابة جوجل.

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

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

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

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

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

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

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

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

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

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

  2. انقر (القائمة الفائض) على الجانب اليمين المتطرف من الدخول، ثم حدد حالة لاستخدام مفصلة.

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

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

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

في علامة التبويب سجلات الخاص وظائف لوحة القيادة ، استخدام فلتر في الجزء العلوي من الصفحة لتحديد الوظائف التي تم إنشاؤها من قبل الملحق الخاص بك.

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

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

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

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

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل أمر تحديث الملحق:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

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

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

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل أمر تكوين الامتداد:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    حيث --params هو العلم اختياري لتقديم ملف الذي يحدد قيم المعلمات المستخدم للتكوين ويسمح لك لتجاوز المطالبات محطة تفاعلية لهذه القيم. تحديد القيم الخاصة بك في .env الملف الذي يتبع dotenv بناء الجملة.

  3. إذا طلب منك (أو أنك لم تقدم على .env الملف)، أدخل قيم التكوين لتخصيص تمديد للمشروع الخاص بك.

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

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

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

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

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

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل الأمر extension-uninstall:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias