برای نصب یا مدیریت افزونه‌ها، باید یکی از این نقش‌ها را به شما اختصاص دهند: مالک یا ویرایشگر یا مدیر فایربیس .
فهرست کردن نمونه‌های افزونه نصب‌شده‌ی یک پروژه
می‌توانید هر نمونه از افزونه‌هایی که نصب کرده‌اید را فهرست کنید.
دستور 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 Tasks برای اجرای وظایف طولانی‌تر استفاده می‌کنند: رایج‌ترین آنها، پردازش وظایفی است که در نقاط مختلف چرخه عمر یک افزونه اجرا می‌شوند - نصب، پیکربندی مجدد و پس از ارتقا.
معمولاً این وظایف بدون دخالت شما و به طور خودکار اجرا و تکمیل می‌شوند. با این حال، اگر نیاز داشتید که وظایف صف‌بندی‌شده‌ی یک افزونه را به صورت دستی مدیریت کنید - مثلاً صف را متوقف کنید یا وظیفه‌ای را که هنوز شروع نشده است از صف حذف کنید - این مراحل را دنبال کنید:
در بخش افزونه‌های کنسول Firebase ، صفحه جزئیات نمونه افزونه را باز کنید.
در صفحه جزئیات، بخش APIها و منابع را باز کنید. اگر افزونه از Cloud Tasks استفاده کند، بخشی با نام Cloud Task queues با یک یا چند ورودی وجود خواهد داشت.
برای صفی که می‌خواهید مدیریت کنید، روی «مشاهده صف» کلیک کنید. این کار صفحه «جزئیات صف» را در کنسول Google Cloud باز می‌کند که از آن می‌توانید وظایف صف‌بندی‌شده را مشاهده کنید، صف را متوقف کنید، وظایف را از صف حذف کنید و غیره. به «مدیریت صف‌ها و وظایف» در مستندات Cloud Tasks مراجعه کنید.
- یک نمونه جدید از افزونه را نصب کنید.
- فقط پس از نصب نمونه جدید، نمونه قدیمی را حذف نصب کنید.
مشاهده‌ی رمزهای Cloud Secret Manager که توسط افزونه‌ها ایجاد شده‌اند
صفحه مدیریت مخفی پروژه خود را در کنسول Google Cloud باز کنید.
در لیست اسرار، می‌توانید اسرار ایجاد شده برای Firebase Extensions (در کنار هر راز دیگری که برای پروژه خود ایجاد کرده‌اید) را مشاهده کنید.
اسرار ایجاد شده توسط افزونه‌ها نام‌هایی با این قالب دارند:
ext- extension-instance-id - paramnNameبرای مثال:
ext-awesome-task-simplifier-API_KEYرازها با کلید
firebase-extensions-managedبرچسب‌گذاری شده‌اند. این برچسب را حذف نکنید، مگر اینکه بخواهید Firebase را از مدیریت راز بازدارید.
بررسی کنید که آیا افزونه نصب شده سالم است یا خیر
شما می‌توانید تمام خطاهای توابع (از جمله خطاهای ایجاد شده توسط Firebase Extensions ) را در کنسول بررسی کنید.
در برگه سلامت (Health) در داشبورد توابع (Functions )، می‌توانید نمای کلی از خطاها و اطلاعات عملکرد (performance information) را برای همه توابع پروژه خود مشاهده کنید.
برای مشاهده اطلاعات مربوط به یک افزونه خاص، از فیلتر بالای صفحه برای انتخاب یک عملکرد خاص استفاده کنید.
بررسی کنید که یک افزونه نصب شده چند وقت یکبار اجرا می‌شود
در برگه داشبورد (Dashboard) از داشبورد توابع (Functions) ، تابع خاصی را برای Firebase Extension که می‌خواهید بررسی کنید، پیدا کنید.
روی (منوی سرریز) در سمت راست ورودی کلیک کنید، سپس گزینه Detailed usage stats را انتخاب کنید.
در کنسول نمایش داده شده Google Cloud ، می‌توانید به بررسی دقیق‌تر فراخوانی‌های مختلف یک تابع بپردازید و حتی کد منبع آن را بررسی کنید.
مشاهده گزارش‌های مربوط به یک افزونه
اگر می‌خواهید پروژه خود را اشکال‌زدایی کنید یا گزارش اشکالی را به Firebase ارسال کنید، مشاهده گزارش‌های توابع در حال اجرا در پروژه شما مفید خواهد بود.
در برگه «گزارش‌ها» در داشبورد توابع خود، از فیلتر بالای صفحه برای انتخاب توابع ایجاد شده توسط افزونه خود استفاده کنید.
به‌روزرسانی یک نمونه افزونه نصب‌شده به آخرین نسخه
شما می‌توانید یک نمونه نصب‌شده از یک افزونه را به آخرین نسخه منتشرشده آن به‌روزرسانی کنید. ممکن است بخواهید یک نمونه نصب‌شده را به‌روزرسانی کنید زیرا این نمونه از قبل به‌طور فعال در حال اجرا است یا در گردش کار آزمایش، پروژه یا برنامه شما راه‌اندازی شده است.
وقتی یک نمونه را به‌روزرسانی می‌کنید، تمام منابع و منطق مختص افزونه‌ی آن نمونه برای استفاده از کد منبع و فایل‌های نسخه جدید بازنویسی می‌شود. شناسه‌ی نمونه و حساب سرویس افزونه تغییر نخواهد کرد.
در طول فرآیند به‌روزرسانی، از هرگونه تغییر در نسخه جدید مطلع خواهید شد و می‌توانید مقادیر پارامترهای جدید را تعیین کنید.
به داشبورد Firebase Extensions خود بروید، سپس در کارت افزونه نصب‌شده، روی مدیریت (Manage) کلیک کنید.
در گوشه بالا سمت راست، روی «به‌روزرسانی افزونه» کلیک کنید.
اگر نسخه جدید افزونه موجود نباشد، صفحه جزئیات دکمه به‌روزرسانی نخواهد داشت.
موارد جدید در به‌روزرسانی را بررسی کنید و افزونه را (در صورت نیاز) پیکربندی کنید.
روی به‌روزرسانی افزونه کلیک کنید.
پیکربندی مجدد یک نمونه افزونه نصب شده
شما می‌توانید مقادیر پارامترهای پیکربندی‌شده توسط کاربر را برای یک نمونه افزونه نصب‌شده تغییر دهید. این مقادیر جدید در هرگونه راه‌اندازی بعدی نمونه استفاده خواهند شد، اما تمام مصنوعات یا عناصر ساختاری قبلی ایجاد شده توسط افزونه (مانند تصاویر ذخیره‌شده یا سطل‌های ذخیره‌سازی موجود) تغییر نخواهند کرد.
به داشبورد Firebase Extensions خود بروید، سپس در کارت افزونه نصب‌شده، روی مدیریت (Manage) کلیک کنید.
در گوشه بالا سمت راست، روی «پیکربندی مجدد افزونه» کلیک کنید.
برای پیکربندی مجدد مقادیر پارامترها برای افزونه خود، دستورالعمل‌های روی صفحه را دنبال کنید.
روی ذخیره کلیک کنید.
یک نمونه افزونه را حذف نصب کنید
شما می‌توانید یک نمونه از یک افزونه را از پروژه Firebase خود حذف نصب کنید. این عمل، حساب کاربری سرویس و تمام منابعی (مانند مجموعه‌ای از توابع) که Firebase به‌طور خاص برای آن نمونه از افزونه ایجاد کرده است را حذف می‌کند. با این حال، موارد زیر حذف نمی‌شوند :
هرگونه اثر مصنوعی ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده).
هر منبع دیگری در پروژه شما، مانند یک نمونه پایگاه داده یا مخزن Cloud Storage . حتی اگر افزونه با این منابع دیگر تعامل داشته باشد، آنها مختص افزونه نیستند، بنابراین اگر افزونه حذف نصب شود، حذف نمی‌شوند.
در اینجا نحوه حذف نصب افزونه آورده شده است:
به داشبورد Firebase Extensions خود بروید، سپس در کارت افزونه نصب‌شده، روی مدیریت (Manage) کلیک کنید.
در پایین صفحه، روی «حذف نصب افزونه» کلیک کنید.
بررسی کنید که چه چیزی حذف خواهد شد، سپس برای تأیید حذف، روی «حذف افزونه» کلیک کنید.