Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

管理已安裝的 Firebase 擴展

安裝或管理的擴展,你必須分配這些角色之一:擁有者或編輯火力地堡管理員

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

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

運行擴展列表命令:

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

監控已安裝的擴展實例

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

設置預算提醒

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

請確保您設置的預算提醒你的火力地堡項目。

查看由擴展創建的函數

  1. 轉到您的功能儀表盤的火力地堡控制台。

  2. 儀表盤選項卡,可以查看功能從火力地堡擴展(旁邊,您已經部署項目中的任何其他功能)。

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

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

查看由擴展程序創建的 Cloud Scheduler 作業

  1. 打開你的項目的雲計劃在谷歌雲端控制台頁面。

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

    通過擴展創造就業崗位的格式名: firebase-ext- extension-instance-id - functionName

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

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

  1. 打開項目的秘密經理在谷歌雲端控制台頁面。

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

    通過擴展創造秘密的格式為名稱: ext- extension-instance-id - paramnName

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

    秘密被標記為關鍵firebase-extensions-managed 。除非您想阻止 Firebase 管理密鑰,否則不要移除此標籤。

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

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

  1. 在您的健康標籤功能的儀表板,您可以查看錯誤的對項目中的所有功能的概述和性能信息。

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

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

  1. 在你的儀表板選項卡功能的儀表板,找到特定功能的火力地堡擴展,你要檢查。

  2. 點擊 (溢出菜單)在入口的最右側,然後選擇詳細的使用統計數據

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

查看擴展的日誌

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

在你的日誌選項卡功能的儀表板,使用過濾器在頁面頂部選擇你的擴展創建的功能。

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

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

當您更新實例時,所有實例的特定於擴展的資源和邏輯都將被覆蓋以使用新版本的源代碼和文件。擴展程序的實例 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是一個可選的標誌來提供限定的用戶可配置的參數的值,並允許您旁路這些值的交互式終端提示的文件。在定義你的價值觀.env下面的文件dotenv語法。

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

卸載擴展實例

您可以從 Firebase 項目中卸載擴展程序的實例。此操作刪除服務帳戶和所有的資源(比如一組函數)火力地堡為擴展名的該實例創建的。但是,以下不會被刪除:

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

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

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

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

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

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