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

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

وحدة تحكُّم Firebase Firebase CLI حزمة تطوير البرامج (SDK) التي تم إنشاؤها تلقائيًا

عرض قائمة بنسخ الإضافات المثبَّتة في مشروع

يمكنك عرض كل نسخة من الإضافات التي ثبَّتها.

نفِّذ الأمر extensions-list:

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

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

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

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

مراقبة نسخة إضافة مثبَّتة

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

ضبط التنبيهات بشأن الميزانية والحدود القصوى للإنفاق

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

بما أنّ Firebase Extensions تتطلّب أن يكون مشروعك ضمن خطة Blaze، ننصحك بشدة بإعداد تنبيهات بشأن الميزانية و حدود قصوى للإنفاق على دوال Cloud Run. Firebase Extensions تعتمد على دوال Cloud Run، لذا فإنّ الحد الأقصى للإنفاق على دوال Cloud Run هو في الأساس حد أقصى للإنفاق على Firebase Extensions أيضًا.

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

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 Tasks التي أضافتها الإضافات إلى قائمة الانتظار وإدارتها

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

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

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

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

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

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

   1. ثبِّت نسخة جديدة من الإضافة.
   2. بعد تثبيت النسخة الجديدة فقط، ألغِ تثبيت النسخة القديمة.

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

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

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، من المفيد عرض سجلّات الدوال التي يتم تشغيلها في مشروعك.

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

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

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

ملاحظة: إذا ثبَّت إضافة باستخدام حزمة تطوير برامج (SDK) تم إنشاؤها تلقائيًا، استخدِم الطريقة نفسها لترقيتها، وليس وحدة التحكّم أو واجهة سطر الأوامر (CLI).

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

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

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

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

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

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

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

إعادة ضبط نسخة إضافة مثبَّتة

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

**ملاحظة:** إذا ثبَّت إضافة باستخدام حزمة تطوير برامج (SDK) تم إنشاؤها تلقائيًا، استخدِم الطريقة نفسها لإعادة ضبطها، وليس وحدة التحكّم أو واجهة سطر الأوامر (CLI).

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

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

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

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

ملاحظة: قد يستغرق النظام من 3 إلى 5 دقائق لحفظ التغييرات في إحدى الإضافات.

إلغاء تثبيت نسخة إضافة

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

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

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

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

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

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

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

ملاحظة: إذا ثبَّت الإضافة باستخدام حزمة تطوير البرامج (SDK) التي تم إنشاؤها تلقائيًا، احرص أيضًا على إزالة إعدادات النسخة من رمز Cloud Functions البرمجي.