要安裝或管理擴展程序,您必須被分配以下角色之一: Owner 或 Editor或Firebase Admin 。
列出項目已安裝的擴展實例
您可以列出已安裝的擴展的每個實例。
運行擴展列表命令:
firebase ext:list --project=projectId-or-alias
監控已安裝的擴展實例
在 Firebase 控制台中,您可以監控已安裝擴展程序的活動,包括檢查其運行狀況、使用情況和日誌。
設置預算提醒
一般來說,設置預算警報是一種很好的做法,但當您信任另一方的代碼在您的項目中運行時,警報可能尤其重要。
確保為您的 Firebase 項目設置預算提醒。
查看擴展創建的函數
轉到 Firebase 控制台的功能儀表板。
在“儀表板”選項卡中,您可以查看 Firebase Extensions 中的函數(以及您為項目部署的任何其他函數)。
由擴展創建的函數具有名稱,格式為:
ext- extension-instance-id - functionName
例如:
ext-awesome-task-simplifier-onUserCreate
查看擴展程序創建的 Cloud Scheduler 作業
在 Google Cloud Console 中打開項目的Cloud Scheduler頁面。
在作業列表中,您可以查看 Firebase Extensions 中的 Cloud Scheduler 作業(以及您為項目創建的任何其他作業)。
由擴展創建的作業的名稱格式如下:
firebase-ext- extension-instance-id - functionName
例如:
firebase-ext-awesome-task-simplifier-doTask
查看和管理擴展排隊的雲任務
某些擴展程序使用雲任務來運行運行時間較長的任務:最常見的是,處理在擴展程序生命週期中的各個點(安裝、重新配置和升級後)運行的任務。
通常,這些任務會自動運行並完成,無需您的干預。但是,如果您需要手動管理擴展程序的排隊任務(例如,暫停隊列或從隊列中刪除尚未開始的任務),請按照以下步驟操作:
在 Firebase 控制台擴展部分中,打開擴展實例的詳細信息頁面。
在詳細信息頁面上,打開API 和資源部分。如果擴展程序使用雲任務,則會有一個包含一個或多個條目的雲任務隊列部分。
單擊要管理的隊列的查看隊列。這將打開 Google Cloud Console 中的“隊列詳細信息”頁面,您可以在其中查看排隊的任務、暫停隊列、從隊列中刪除任務等。請參閱 Cloud Tasks 文檔中的管理隊列和任務。
- 安裝擴展的新實例。
- 僅在安裝新實例後,卸載舊實例。
查看擴展程序創建的 Cloud Secret Manager 密鑰
在 Google Cloud Console 中打開項目的Secret Manager頁面。
在 Secrets 列表中,您可以查看為 Firebase Extensions 創建的 Secrets(以及您為項目創建的任何其他 Secrets)。
擴展創建的密鑰的名稱格式如下:
ext- extension-instance-id - paramnName
例如:
ext-awesome-task-simplifier-API_KEY
秘密標有關鍵
firebase-extensions-managed
。除非您想阻止 Firebase 管理密鑰,否則請勿刪除此標籤。
檢查已安裝的擴展是否正常
您可以在控制台中查看函數(包括 Firebase 擴展創建的錯誤)中的所有錯誤。
在函數儀表板的運行狀況選項卡中,您可以查看項目中所有函數的錯誤和性能信息的概述。
要查看特定擴展程序的信息,請使用頁面頂部的過濾器選擇特定功能。
檢查已安裝擴展的運行頻率
在“函數”儀表板的“儀表板”選項卡中,找到要檢查的 Firebase 擴展的特定函數。
單擊條目最右側的
(溢出菜單),然後選擇詳細使用情況統計信息。在顯示的 Google Cloud Console 中,您可以深入了解函數的各種調用,甚至檢查其源代碼。
查看擴展的日誌
如果您嘗試調試項目或向 Firebase 提交錯誤報告,那麼查看項目中運行的函數的日誌會很有用。
在函數儀表板的日誌選項卡中,使用頁面頂部的過濾器選擇由您的擴展創建的函數。
將已安裝的擴展實例更新到最新版本
您可以將已安裝的擴展實例更新到最新發布的版本。您可能想要更新已安裝的實例,因為該實例已在您的測試、項目或應用程序工作流程中主動運行或設置。
當您更新實例時,所有實例的特定於擴展的資源和邏輯都將被覆蓋,以使用新版本的源代碼和文件。擴展程序的實例 ID 和服務帳戶不會更改。
在更新過程中,您將收到有關新版本的任何更改的通知,並且您將能夠指定任何新參數的值。
要將擴展清單中的擴展實例更新到最新版本,請運行擴展更新命令:
firebase ext:update extensionInstanceId
要更新到特定版本,請提供您要更新到的版本:
firebase ext:update extensionInstanceId versionNumber
然後,要將清單中的擴展部署到 Firebase 項目中,請運行:
firebase deploy --only extensions --project=projectId-or-alias
重新配置已安裝的擴展實例
您可以更改已安裝的擴展實例的用戶配置參數的值。這些新值將在實例的任何未來觸發器中使用,但擴展創建的所有先前工件或結構元素(例如存儲的圖像或現有的存儲桶)將不會更改。
要以交互方式在擴展清單中重新配置擴展,請運行擴展配置命令:
firebase ext:configure extensionInstanceId
然後,要將清單中的擴展部署到 Firebase 項目中,請運行:
firebase deploy --only extensions --project=projectId-or-alias
卸載擴展實例
您可以從 Firebase 項目中卸載擴展程序的實例。此操作將刪除 Firebase 專門為該擴展程序實例創建的服務帳戶和所有資源(例如一組函數)。但以下內容不會被刪除:
擴展創建的任何工件(例如存儲的圖像)。
項目中的任何其他資源,例如數據庫實例或 Cloud Storage 存儲分區。即使擴展程序與這些其他資源進行交互,它們也不是特定於擴展程序的,因此如果卸載擴展程序,它們也不會被刪除。
以下是卸載擴展的方法:
要從擴展清單中刪除擴展實例,請運行擴展卸載命令:
firebase ext:uninstall extensionInstanceId
然後,要將清單更改部署到 Firebase 項目,請運行:
firebase deploy --only extensions --project=projectId-or-alias