Check out what’s new from Firebase at Google I/O 2022. Learn more

管理已安裝的 Firebase 擴展程序

要安裝或管理擴展程序,您必須被分配以下角色之一: Owner 或 EditorFirebase Admin

列出項目已安裝的擴展實例

您可以列出您安裝的擴展的每個實例。

運行擴展列表命令:

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

監控已安裝的擴展實例

在 Firebase 控制台中,您可以監控已安裝擴展程序的活動,包括檢查其運行狀況、使用情況和日誌。

設置預算提醒

設置預算警報通常是一種很好的做法,但是當您信任另一方的代碼在您的項目中運行時,警報可能尤其重要。

請務必為您的 Firebase 項目設置預算提醒

查看擴展創建的函數

  1. 轉到 Firebase 控制台的Functions 儀表板

  2. 儀表板選項卡中,您可以查看 Firebase 擴展中的函數(以及您為項目部署的任何其他函數)。

    擴展創建的函數有名字,格式為: ext- extension-instance-id - functionName

    例如: ext-awesome-task-simplifier-onUserCreate

查看擴展創建的 Cloud Scheduler 作業

  1. 在 Google Cloud Console 中打開項目的Cloud Scheduler頁面。

  2. 在作業列表中,您可以查看 Firebase Extensions 中的 Cloud Scheduler 作業(以及您為項目創建的任何其他作業)。

    由擴展創建的作業具有以下格式的名稱: firebase-ext- extension-instance-id - functionName

    例如: firebase-ext-awesome-task-simplifier-doTask

查看擴展創建的 Cloud Secret Manager 機密

  1. 在 Google Cloud Console 中打開項目的Secret Manager頁面。

  2. 在 Secrets 列表中,您可以查看為 Firebase Extensions 創建的 Secrets(以及您為項目創建的任何其他 Secrets)。

    由擴展創建的秘密具有以下格式的名稱: ext- extension-instance-id - paramnName

    例如: ext-awesome-task-simplifier-API_KEY

    秘密使用密鑰firebase-extensions-managed標記。除非您想阻止 Firebase 管理密鑰,否則請勿移除此標籤。

檢查已安裝的擴展程序是否健康

您可以在控制台中查看來自函數(包括由 Firebase 擴展創建的錯誤)的所有錯誤。

  1. 函數儀表板的運行狀況選項卡中,您可以查看項目中所有函數的錯誤和性能信息概覽。

  2. 要查看特定擴展的信息,請使用頁面頂部的過濾器來選擇特定功能。

檢查已安裝擴展的運行頻率

  1. 函數儀表板儀表板選項卡中,找到您要檢查的 Firebase 擴展的特定函數。

  2. 單擊條目最右側的 (溢出菜單),然後選擇Detailed usage stats

  3. 在顯示的 Google Cloud Console 中,您可以深入了解函數的各種調用,甚至檢查其源代碼。

查看擴展的日誌

如果您嘗試調試項目,或向 Firebase 提交錯誤報告,查看項目中運行的函數的日誌會很有用。

Functions DashboardLogs選項卡中,使用頁面頂部的過濾器來選擇由您的擴展程序創建的函數。

將已安裝的擴展實例更新到最新版本

您可以將已安裝的擴展實例更新為其最新發布的版本。您可能想要更新已安裝的實例,因為該實例已在您的測試、項目或應用程序工作流中主動運行或設置。

當您更新一個實例時,該實例的所有特定於擴展的資源和邏輯都將被覆蓋以使用新版本的源代碼和文件。擴展的實例 ID 和服務帳戶不會改變。

在更新過程中,您將收到有關新版本的任何更改的通知,並且您將能夠為任何新參數指定值。

  1. 運行 extensions-list 命令獲取擴展的實例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 運行擴展更新命令:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

重新配置已安裝的擴展實例

您可以更改已安裝擴展實例的用戶配置參數的值。這些新值將用於實例的任何未來觸發器,但擴展創建的所有先前工件或結構元素(如存儲的圖像或現有的存儲桶)都不會更改。

  1. 運行 extensions-list 命令獲取擴展的實例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 運行擴展配置命令:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    其中--params是一個可選標誌,用於提供一個文件,該文件定義用戶可配置參數的值,並允許您繞過這些值的交互式終端提示。在遵循dotenv語法的.env文件中定義您的值。

  3. 如果系統提示您(或者您沒有提供.env文件),請輸入配置值以自定義項目的擴展名。

卸載擴展實例

您可以從 Firebase 項目中卸載擴展程序的實例。此操作會刪除 Firebase 專門為該擴展程序實例創建的服務帳號和所有資源(如一組函數)。但是,不會刪除以下內容:

  • 擴展創建的任何工件(如存儲的圖像)。

  • 項目中的任何其他資源,例如數據庫實例或 Cloud Storage 存儲分區。即使擴展與這些其他資源交互,它們也不是擴展特定的,因此如果卸載擴展,它們也不會被刪除。

以下是卸載擴展程序的方法:

  1. 運行 extensions-list 命令獲取擴展的實例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 運行擴展卸載命令:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias