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

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

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

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

دستور 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 مراجعه کنید.

مشاهده اسرار 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
  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