管理已安裝的 Firebase 擴展程序

要安裝或管理擴展程序，您必須被分配以下角色之一： 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

在 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 文檔中的管理隊列和任務。
注意：您可以暫停隊列，但如果暫停時間太長，恢復隊列時任務可能會失敗並出現身份驗證錯誤。（任務驗證在加入隊列一小時後過期。）
警告：不要刪除隊列；擴展程序需要它才能運行。如果您不小心刪除了隊列，則必須執行以下操作：
1. 安裝擴展的新實例。
2. 僅在安裝新實例後，卸載舊實例。

在 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 提交錯誤報告，那麼查看項目中運行的函數的日誌會很有用。

在函數儀表板的日誌選項卡中，使用頁面頂部的過濾器選擇由您的擴展創建的函數。

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

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

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

要將擴展清單中的擴展實例更新到最新版本，請運行擴展更新命令：
```
firebase ext:update extensionInstanceId
```
要更新到特定版本，請提供您要更新到的版本：
```
firebase ext:update extensionInstanceId versionNumber
```
然後，要將清單中的擴展部署到 Firebase 項目中，請運行：
```
firebase deploy --only extensions --project=projectId-or-alias
```

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

要以交互方式在擴展清單中重新配置擴展，請運行擴展配置命令：
```
firebase ext:configure extensionInstanceId
```
注意：所有提示默認為已安裝擴展的當前值，而不是初始安裝期間可用的默認值（在extension.yaml文件中列為默認值）。
然後，要將清單中的擴展部署到 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
```