برای نصب یا مدیریت برنامه‌های افزودنی، باید یکی از این نقش‌ها به شما اختصاص داده شود: مالک یا ویرایشگر یا مدیر Firebase .
نمونه های برنامه افزودنی نصب شده یک پروژه را فهرست کنید
می‌توانید هر نمونه از افزونه‌هایی را که نصب کرده‌اید فهرست کنید.
دستور extensions-list را اجرا کنید:
firebase ext:list --project=projectId-or-alias
جزئیات و پیکربندی یک نمونه برنامه افزودنی نصب شده را مشاهده کنید
به داشبورد Firebase Extensions در کنسول Firebase بروید.
در کارت نمونه برنامه افزودنی نصب شده، روی مدیریت کلیک کنید.
یک نمونه برنامه افزودنی نصب شده را نظارت کنید
در کنسول Firebase ، می‌توانید فعالیت یک برنامه افزودنی نصب شده، از جمله بررسی سلامت، استفاده و گزارش‌های آن را کنترل کنید.
هشدارهای بودجه را تنظیم کنید
تنظیم هشدارهای بودجه به طور کلی روش خوبی است، اما هشدارها زمانی که به کد شخص دیگری برای اجرا در پروژه خود اعتماد دارید، ممکن است بسیار مهم باشد.
مطمئن شوید که هشدارهای بودجه را برای پروژه Firebase خود تنظیم کرده اید.
مشاهده توابع ایجاد شده توسط برنامه های افزودنی
به داشبورد Functions کنسول Firebase بروید.
در تب داشبورد ، می‌توانید توابع Firebase Extensions را مشاهده کنید (در کنار سایر عملکردهایی که برای پروژه خود به کار گرفته‌اید).
توابع ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند:
ext- extension-instance-id - functionNameبه عنوان مثال:
ext-awesome-task-simplifier-onUserCreate
مشاهده مشاغل Cloud Scheduler ایجاد شده توسط برنامه های افزودنی
صفحه Cloud Scheduler پروژه خود را در کنسول Google Cloud باز کنید.
در لیست مشاغل، می توانید کارهای Cloud Scheduler را از Firebase Extensions (در کنار هر شغل دیگری که برای پروژه خود ایجاد کرده اید) مشاهده کنید.
مشاغل ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند:
firebase-ext- extension-instance-id - functionNameبه عنوان مثال:
firebase-ext-awesome-task-simplifier-doTask
مشاهده و مدیریت وظایف Cloud که توسط برنامه‌های افزودنی در صف قرار گرفته‌اند
برخی از برنامه‌های افزودنی از Cloud Tasks برای اجرای کارهای طولانی‌تر استفاده می‌کنند: معمولاً پردازش وظایفی که در نقاط مختلف چرخه عمر برنامه‌های افزودنی اجرا می‌شوند - نصب، پیکربندی مجدد و پس از ارتقا.
به طور معمول، این وظایف بدون دخالت شما به طور خودکار اجرا و تکمیل می شوند. با این حال، اگر زمانی نیاز به مدیریت دستی وظایف در صف یک برنامه افزودنی داشتید - برای مثال، برای توقف صف یا حذف کاری که هنوز شروع نشده است از صف، مراحل زیر را دنبال کنید:
در بخش افزونه‌های کنسول Firebase ، صفحه جزئیات نمونه برنامه افزودنی را باز کنید.
در صفحه جزئیات، بخش API ها و منابع را باز کنید. اگر برنامه افزودنی از Cloud Tasks استفاده کند، یک بخش Cloud Task queues با یک یا چند ورودی وجود خواهد داشت.
برای صفی که می‌خواهید مدیریت کنید، روی View queue کلیک کنید. با این کار صفحه Queue Details در کنسول Google Cloud باز می شود که می توانید وظایف در صف را مشاهده کنید، صف را متوقف کنید، وظایف را از صف حذف کنید و غیره. به مدیریت صف‌ها و وظایف در اسناد Cloud Tasks مراجعه کنید.
- یک نمونه جدید از برنامه افزودنی نصب کنید.
- فقط پس از نصب نمونه جدید، نمونه قدیمی را حذف نصب کنید.
مشاهده اسرار Cloud Secret Manager ایجاد شده توسط برنامه های افزودنی
صفحه مدیر مخفی پروژه خود را در کنسول Google Cloud باز کنید.
در لیست Secrets، می توانید اسرار ایجاد شده برای Firebase Extensions را مشاهده کنید (در کنار هر اسرار دیگری که برای پروژه خود ایجاد کرده اید).
اسرار ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند:
ext- extension-instance-id - paramnNameبه عنوان مثال:
ext-awesome-task-simplifier-API_KEYاسرار با کلید
firebase-extensions-managedبرچسب گذاری می شوند. این برچسب را حذف نکنید مگر اینکه بخواهید Firebase را از مدیریت راز منع کنید.
بررسی کنید که آیا افزونه نصب شده سالم است یا خیر
می‌توانید تمام خطاهای توابع (از جمله موارد ایجاد شده توسط Firebase Extensions ) را در کنسول بررسی کنید.
در برگه سلامت داشبورد توابع خود، می‌توانید یک نمای کلی از خطاها و اطلاعات عملکرد برای همه عملکردهای پروژه خود را مشاهده کنید.
برای مشاهده اطلاعات یک برنامه افزودنی خاص، از فیلتر بالای صفحه برای انتخاب یک عملکرد خاص استفاده کنید.
بررسی کنید که یک برنامه افزودنی نصب شده چند بار در حال اجرا است
در برگه داشبورد داشبورد توابع ، تابع خاصی را برای Firebase Extension که می‌خواهید بررسی کنید، پیدا کنید.
روی (منوی سرریز) در سمت راست انتهای ورودی کلیک کنید، سپس آمار استفاده دقیق را انتخاب کنید.
در کنسول Google Cloud نمایش داده شده، می توانید فراخوانی های مختلف یک تابع را بررسی کنید و حتی کد منبع آن را بررسی کنید.
گزارش‌های یک برنامه افزودنی را مشاهده کنید
اگر می‌خواهید پروژه خود را اشکال‌زدایی کنید، یا یک گزارش اشکال را به Firebase ارسال کنید، مشاهده گزارش‌های عملکردهای در حال اجرا در پروژه شما مفید است.
در برگه گزارش‌های داشبورد توابع ، از فیلتر بالای صفحه برای انتخاب عملکردهای ایجاد شده توسط برنامه افزودنی خود استفاده کنید.
یک نمونه برنامه افزودنی نصب شده را به آخرین نسخه به روز کنید
می توانید یک نمونه نصب شده از یک برنامه افزودنی را به آخرین نسخه منتشر شده آن به روز کنید. ممکن است بخواهید یک نمونه نصب شده را به روز کنید زیرا نمونه قبلاً به طور فعال در جریان آزمایش، پروژه یا برنامه شما در حال اجرا یا تنظیم است.
هنگامی که یک نمونه را به روز می کنید، تمام منابع و منطق برنامه افزودنی خاص برای استفاده از کد منبع و فایل های نسخه جدید بازنویسی می شود. شناسه نمونه برنامه افزودنی و حساب سرویس تغییر نخواهد کرد.
در طول فرآیند به‌روزرسانی، هر گونه تغییر در نسخه جدید به شما اطلاع داده می‌شود و می‌توانید مقادیری را برای هر پارامتر جدید مشخص کنید.
به داشبورد Firebase Extensions خود بروید، سپس در کارت نمونه برنامه افزودنی نصب شده، روی مدیریت کلیک کنید.
در گوشه بالا سمت راست، روی به‌روزرسانی افزونه کلیک کنید.
اگر برنامه افزودنی نسخه جدید موجود نداشته باشد، صفحه جزئیات دکمه به‌روزرسانی نخواهد داشت.
موارد جدید در به روز رسانی را مرور کنید و برنامه افزودنی را (در صورت نیاز) پیکربندی کنید.
روی Update extension کلیک کنید.
یک نمونه برنامه افزودنی نصب شده را دوباره پیکربندی کنید
می توانید مقادیر پارامترهای پیکربندی شده توسط کاربر را برای یک نمونه برنامه افزودنی نصب شده تغییر دهید. این مقادیر جدید در هر محرک بعدی نمونه استفاده خواهد شد، اما تمام مصنوعات قبلی یا عناصر ساختاری ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده یا سطل های ذخیره سازی موجود) تغییر نخواهند کرد.
به داشبورد Firebase Extensions خود بروید، سپس در کارت نمونه برنامه افزودنی نصب شده، روی مدیریت کلیک کنید.
در گوشه بالا سمت راست، روی پیکربندی مجدد افزونه کلیک کنید.
دستورالعمل های روی صفحه را برای پیکربندی مجدد مقادیر پارامتر برای برنامه افزودنی خود دنبال کنید.
روی ذخیره کلیک کنید.
یک نمونه برنامه افزودنی را حذف نصب کنید
می توانید نمونه ای از یک برنامه افزودنی را از پروژه Firebase خود حذف نصب کنید. این اقدام حساب سرویس و همه منابع (مانند مجموعه ای از توابع) را که Firebase به طور خاص برای آن نمونه از برنامه افزودنی ایجاد کرده است، حذف می کند. اما موارد زیر حذف نمی شوند:
هر مصنوع ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده).
هر منبع دیگری در پروژه شما، مانند نمونه پایگاه داده یا سطل Cloud Storage . حتی اگر برنامه افزودنی با این منابع دیگر تعامل داشته باشد، آنها خاص برنامه افزودنی نیستند، بنابراین اگر برنامه افزودنی حذف نصب شود، حذف نمی شوند.
در اینجا نحوه حذف برنامه افزودنی آمده است:
به داشبورد Firebase Extensions خود بروید، سپس در کارت نمونه برنامه افزودنی نصب شده، روی مدیریت کلیک کنید.
در پایین صفحه، روی Uninstall extension کلیک کنید.
موارد حذف شده را مرور کنید، سپس بر روی Uninstall افزونه کلیک کنید تا حذف را تأیید کنید.