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

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


عرض تفاصيل وإعدادات النسخة الافتراضية للإضافة المثبَّتة

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

  2. في بطاقة النسخة الافتراضية للإضافة المثبَّتة، انقر على إدارة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. في أعلى يسار الصفحة، انقر على تحديث الإضافة.

    إذا لم يكن هناك إصدار جديد متاح للإضافة، ستظهر صفحة التفاصيل زر التحديث.

  3. راجِع الميزات الجديدة في التحديث واضبط الإضافة (إذا لزم الأمر).

  4. انقر على تحديث الإضافة.

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

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

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

  2. في أعلى يسار الصفحة، انقر على إعادة ضبط الإضافة.

  3. اتّبِع التعليمات الظاهرة على الشاشة لإعادة ضبط قيم المَعلمات. للإضافة.

  4. انقر على حفظ.

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

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

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

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

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

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

  2. في أسفل الشاشة، انقر على إلغاء تثبيت الإضافة.

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