管理已安裝的 Firebase Extensions

如要安裝或管理擴充功能，您必須指派下列其中一個角色：擁有者或編輯者或 Firebase 管理員。

列出專案已安裝的擴充功能執行個體

您可以列出已安裝擴充功能的所有執行個體。

執行擴充功能清單指令：

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

監控已安裝的擴充功能執行個體

在 Firebase 控制台中，您可以監控已安裝擴充功能的活動，包括檢查其健康狀態、使用情況和記錄檔。

設定預算快訊

一般而言，設定預算快訊是不錯的做法，但當您信任另一方在專案中執行的程式碼時，快訊可能格外重要。

請確認您的 Firebase 專案已設定預算快訊。

查看擴充功能建立的函式

前往 Firebase 控制台的函式資訊主頁。
在「Dashboard」(資訊主頁) 分頁中，您可以查看 Firebase 擴充功能 (以及您為專案部署的任何其他函式) 提供的函式。

由擴充功能建立的函式具有名稱，格式如下：ext-extension-instance-id-functionName

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

查看擴充功能建立的 Cloud Scheduler 工作

在 Google Cloud 控制台中開啟專案的「Cloud Scheduler」頁面。
在工作清單中，您可以從 Firebase 擴充功能 (以及您為專案建立的任何其他工作) 查看 Cloud Scheduler 工作。

擴充功能建立的工作名稱格式為：firebase-ext-extension-instance-id-functionName

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

查看及管理依擴充功能排入佇列的 Cloud Tasks

有些擴充功能會使用 Cloud Tasks 執行耗時較長的工作，最常見的是處理在擴充功能生命週期中各個時間點執行的工作：安裝、重新設定以及升級後。

通常這些工作會自動執行並完成，不需要您親自動手。不過，如果您需要手動管理擴充功能已排入佇列的工作 (例如暫停佇列或從尚未啟動的工作中移除佇列)，請按照下列步驟操作：

在 Firebase 控制台的「Extensions」(擴充功能) 區段中，開啟擴充功能執行個體的詳細資料頁面。
在詳細資料頁面中，開啟「API 和資源」部分。如果擴充功能使用 Cloud Tasks，系統會顯示「Cloud Task Queues」(Cloud 工作佇列) 部分，其中會有一或多個項目。
針對您要管理的佇列按一下「查看佇列」。系統會開啟 Google Cloud 控制台的「Queue Details」(佇列詳細資料) 頁面，您可在此查看佇列的工作、暫停佇列、移除佇列中的工作等。請參閱 Cloud Tasks 說明文件中的「管理佇列和工作」一文。

注意： 您可以暫停佇列，但如果讓佇列維持暫停狀態的時間過長，工作可能會在恢復佇列時失敗並顯示驗證錯誤。(工作驗證會在加入佇列的一小時後失效)。
警告：請勿刪除佇列，擴充功能需要執行才能運作。如果您不小心刪除佇列，則必須執行下列操作：
1. 安裝擴充功能的新執行個體。
2. 請先安裝新執行個體，再解除安裝舊的執行個體。

查看擴充功能建立的 Cloud Secret Manager 密鑰

在 Google Cloud 控制台中開啟專案的「Secret Manager」頁面。
在「Secrets」(密鑰) 清單中，您可以查看為 Firebase Extensions (以及您為專案建立的任何其他密鑰) 建立的密鑰。

擴充功能建立的密鑰名稱格式為：ext-extension-instance-id-paramnName

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

密鑰會標上 firebase-extensions-managed 金鑰。除非您想停止 Firebase 管理密鑰，否則請勿移除這個標籤。

檢查已安裝的擴充功能是否健康狀態良好

您可以在主控台中查看函式 (包括由 Firebase 擴充功能建立) 的所有錯誤。

在函式資訊主頁的「Health」(健康狀態) 分頁中，您可以查看專案中所有函式的錯誤和效能資訊總覽。
如要查看特定擴充功能的資訊，請使用頁面頂端的篩選器選取特定函式。

查看已安裝的擴充功能的執行頻率

在「函式資訊主頁」的「資訊主頁」分頁中，找出您要檢查的 Firebase 擴充功能特定函式。
按一下項目最右側的 (溢位選單)，然後選取「詳細使用統計資料」。
在顯示的 Google Cloud 控制台中，您可以深入瞭解函式的各種叫用，甚至檢查其原始碼。

查看擴充功能的記錄

如果您想為專案偵錯，或是向 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
```