本頁面由 Cloud Translation API 翻譯而成。

管理已安裝的 Firebase 擴展程序

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

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

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

運行擴展列表命令：

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

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

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

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

轉到 Firebase 控制台的Functions 儀表板。
在Dashboard選項卡中，您可以查看來自 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

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

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

在 Firebase 控制台擴展部分，打開擴展實例的詳細信息頁面。
在詳細信息頁面上，打開API 和資源部分。如果擴展使用 Cloud Tasks，則會有一個Cloud Task 隊列部分，其中包含一個或多個條目。
針對您要管理的隊列單擊查看隊列。這將打開 Google Cloud Console 中的“隊列詳細信息”頁面，您可以從中查看排隊的任務、暫停隊列、從隊列中刪除任務等。請參閱 Cloud Tasks 文檔中的管理隊列和任務。
注意：您可以暫停隊列，但如果暫停隊列的時間過長，則在恢復隊列時任務可能會失敗並出現身份驗證錯誤。（任務認證在加入隊列後一小時過期。）
警告：不要刪除隊列；擴展需要它來運行。如果您不小心刪除了隊列，則必須執行以下操作：
1. 安裝擴展的新實例。
2. 只有在安裝新實例後，才能卸載舊實例。

在 Google Cloud Console 中打開項目的Secret Manager頁面。
在機密列表中，您可以查看為 Firebase Extensions 創建的機密（以及您為項目創建的任何其他機密）。
擴展創建的秘密具有以下格式的名稱： ext- extension-instance-id - paramnName
例如： ext-awesome-task-simplifier-API_KEY
密文標有密鑰firebase-extensions-managed 。除非您想阻止 Firebase 管理機密，否則不要刪除此標籤。

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

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

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

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

當您更新實例時，所有實例的擴展特定資源和邏輯都會被覆蓋以使用新版本的源代碼和文件。擴展的實例 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
```