管理已安裝的 Firebase 擴展程序

要安裝或管理擴展程序，您必須被分配以下角色之一： Owner 或 Editor或Firebase Admin 。

Firebase 控制台Firebase CLI

查看已安裝擴展實例的詳細信息和配置

1. 轉到 Firebase 控制台中的Firebase Extensions 儀表板。

2. 在已安裝的擴展實例的卡片上，單擊Manage 。

監控已安裝的擴展實例

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

設置預算提醒

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

確保為您的 Firebase 項目設置預算提醒。

查看擴展創建的函數

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

2. 在Dashboard選項卡中，您可以查看來自 Firebase Extensions 的函數（以及您為項目部署的任何其他函數）。

   擴展創建的函數有名稱，格式為： 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 Tasks

一些擴展使用Cloud Tasks來運行運行時間更長的任務：最常見的是，處理在擴展生命週期的不同時間點運行的任務——安裝、重新配置和升級後。

通常，這些任務會自動運行並完成，無需您的干預。但是，如果您需要手動管理擴展程序的排隊任務——例如，暫停隊列或從隊列中刪除尚未開始的任務——請執行以下步驟：

1. 在 Firebase 控制台擴展部分，打開擴展實例的詳細信息頁面。

2. 在詳細信息頁面上，打開API 和資源部分。如果擴展使用 Cloud Tasks，則會有一個Cloud Task 隊列部分，其中包含一個或多個條目。

3. 針對您要管理的隊列單擊查看隊列。這將打開 Google Cloud Console 中的“隊列詳細信息”頁面，您可以從中查看排隊的任務、暫停隊列、從隊列中刪除任務等。請參閱 Cloud Tasks 文檔中的管理隊列和任務。

   注意：您可以暫停隊列，但如果暫停隊列的時間過長，則在恢復隊列時任務可能會失敗並出現身份驗證錯誤。 （任務認證在加入隊列後一小時過期。）
   警告：不要刪除隊列；擴展需要它來運行。如果您不小心刪除了隊列，則必須執行以下操作：

   1. 安裝擴展的新實例。
   2. 只有在安裝新實例後，才能卸載舊實例。

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

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

2. 在機密列表中，您可以查看為 Firebase Extensions 創建的機密（以及您為項目創建的任何其他機密）。

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

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

   密文標有密鑰firebase-extensions-managed 。除非您想阻止 Firebase 管理機密，否則不要刪除此標籤。

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

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

1. 在Functions 儀表板的Health選項卡中，您可以查看項目中所有函數的錯誤概覽和性能信息。

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

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

1. 在Functions dashboard的Dashboard選項卡中，找到要檢查的 Firebase Extension 的特定函數。

2. 單擊條目最右側的 （溢出菜單），然後選擇Detailed usage stats 。

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

查看擴展日誌

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

在Functions 儀表板的Logs選項卡中，使用頁面頂部的過濾器來選擇您的擴展程序創建的函數。

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

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

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

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

1. 轉到您的Firebase Extensions dashboard ，然後在已安裝的擴展實例的卡片上，單擊Manage 。

2. 在右上角，單擊更新擴展程序。

   如果擴展沒有可用的新版本，詳細信息頁面將沒有更新按鈕。

3. 查看更新中的新增功能並配置擴展（如果需要）。

4. 單擊更新擴展。

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

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

1. 轉到您的Firebase Extensions dashboard ，然後在已安裝的擴展實例的卡片上，單擊Manage 。

2. 在右上角，單擊重新配置擴展。

3. 按照屏幕上的說明為您的分機重新配置參數值。

4. 單擊保存。

注意：保存對分機的更改可能需要係統 3-5 分鐘。

卸載擴展實例

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

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

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

卸載擴展程序的方法如下：

1. 轉到您的Firebase Extensions dashboard ，然後在已安裝的擴展實例的卡片上，單擊Manage 。

2. 在屏幕底部，點擊卸載擴展。

3. 查看將刪除的內容，然後單擊“卸載擴展”以確認刪除。