برنامه های افزودنی Firebase نصب شده را مدیریت کنید

برای نصب یا مدیریت برنامه‌های افزودنی، باید یکی از این نقش‌ها به شما اختصاص داده شود: مالک یا ویرایشگر یا مدیر Firebase .

کنسول Firebase Firebase CLI

نمونه های برنامه افزودنی نصب شده یک پروژه را فهرست کنید

می‌توانید هر نمونه از افزونه‌هایی را که نصب کرده‌اید فهرست کنید.

دستور extensions-list را اجرا کنید:

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

یک نمونه برنامه افزودنی نصب شده را نظارت کنید

در کنسول Firebase، می‌توانید فعالیت یک برنامه افزودنی نصب شده، از جمله بررسی سلامت، استفاده و گزارش‌های آن را کنترل کنید.

هشدارهای بودجه را تنظیم کنید

تنظیم هشدارهای بودجه به طور کلی روش خوبی است، اما هشدارها زمانی که به کد شخص دیگری برای اجرا در پروژه خود اعتماد دارید، ممکن است بسیار مهم باشد.

مطمئن شوید که هشدارهای بودجه را برای پروژه Firebase خود تنظیم کرده اید.

مشاهده توابع ایجاد شده توسط برنامه های افزودنی

1. به داشبورد Functions کنسول 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 که توسط برنامه‌های افزودنی در صف قرار گرفته‌اند

برخی از برنامه‌های افزودنی از Cloud Tasks برای اجرای کارهای طولانی‌تر استفاده می‌کنند: معمولاً پردازش وظایفی که در نقاط مختلف چرخه عمر برنامه‌های افزودنی اجرا می‌شوند - نصب، پیکربندی مجدد و پس از ارتقا.

به طور معمول، این وظایف بدون دخالت شما به طور خودکار اجرا و تکمیل می شوند. با این حال، اگر زمانی نیاز به مدیریت دستی وظایف در صف یک برنامه افزودنی داشتید - برای مثال، برای توقف صف یا حذف کاری که هنوز شروع نشده است از صف، مراحل زیر را دنبال کنید:

1. در بخش افزونه‌های کنسول Firebase، صفحه جزئیات نمونه برنامه افزودنی را باز کنید.

2. در صفحه جزئیات، بخش API ها و منابع را باز کنید. اگر برنامه افزودنی از Cloud Tasks استفاده کند، یک بخش Cloud Task queues با یک یا چند ورودی وجود خواهد داشت.

3. برای صفی که می‌خواهید مدیریت کنید، روی View queue کلیک کنید. با این کار صفحه Queue Details در کنسول Google Cloud باز می شود که می توانید وظایف در صف را مشاهده کنید، صف را متوقف کنید، وظایف را از صف حذف کنید و غیره. به مدیریت صف‌ها و وظایف در اسناد Cloud Tasks مراجعه کنید.

   توجه: می‌توانید یک صف را مکث کنید، اما اگر آن را برای مدت طولانی متوقف کنید، ممکن است هنگام از سرگیری صف، کارها با خطاهای احراز هویت با شکست مواجه شوند. (احراز هویت یک ساعت پس از پیوستن آن به صف منقضی می شود.)
   هشدار: صف را حذف نکنید. افزونه برای کار کردن به آن نیاز دارد. اگر به طور تصادفی صف را حذف کردید، باید موارد زیر را انجام دهید:

   1. یک نمونه جدید از برنامه افزودنی نصب کنید.
   2. فقط پس از نصب نمونه جدید، نمونه قدیمی را حذف نصب کنید.

مشاهده اسرار Cloud Secret Manager ایجاد شده توسط برنامه های افزودنی

1. صفحه مدیر مخفی پروژه خود را در کنسول Google Cloud باز کنید.

2. در لیست Secrets، می‌توانید اسرار ایجاد شده برای برنامه‌های افزودنی 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 نمایش داده شده، می توانید فراخوانی های مختلف یک تابع را بررسی کنید و حتی کد منبع آن را بررسی کنید.

گزارش‌های یک برنامه افزودنی را مشاهده کنید

اگر می‌خواهید پروژه خود را اشکال‌زدایی کنید، یا یک گزارش اشکال را به 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

   توجه: همه درخواست‌ها به‌جای مقادیر پیش‌فرض موجود در طول نصب اولیه (آنهایی که به عنوان پیش‌فرض در فایل extension.yaml فهرست شده‌اند) به‌طور پیش‌فرض به مقادیر فعلی برای افزونه نصب‌شده می‌پردازند.

2. سپس، برای استقرار برنامه‌های افزودنی در مانیفست خود در پروژه Firebase، اجرا کنید:

   firebase deploy --only extensions --project=projectId-or-alias

توجه: ذخیره تغییرات برای یک برنامه افزودنی ممکن است سیستم 3-5 دقیقه طول بکشد.

یک نمونه برنامه افزودنی را حذف نصب کنید

می توانید نمونه ای از یک برنامه افزودنی را از پروژه Firebase خود حذف نصب کنید. این اقدام حساب سرویس و تمام منابع (مانند مجموعه ای از توابع) را که Firebase به طور خاص برای آن نمونه از برنامه افزودنی ایجاد کرده است، حذف می کند. اما موارد زیر حذف نمی شوند:

• هر مصنوع ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده).

• هر منبع دیگری در پروژه شما، مانند نمونه پایگاه داده یا سطل ذخیره سازی ابری. حتی اگر برنامه افزودنی با این منابع دیگر تعامل داشته باشد، آنها خاص برنامه افزودنی نیستند، بنابراین اگر برنامه افزودنی حذف نصب شود، حذف نمی شوند.

در اینجا نحوه حذف برنامه افزودنی آمده است:

1. برای حذف یک نمونه برنامه افزودنی از مانیفست برنامه‌های افزودنی ، دستور حذف برنامه افزودنی را اجرا کنید:

   firebase ext:uninstall extensionInstanceId

2. سپس، برای استقرار تغییرات در مانیفست خود در یک پروژه Firebase، اجرا کنید:

   firebase deploy --only extensions --project=projectId-or-alias