管理已安裝的 Firebase Extensions

如要安裝或管理擴充功能，您必須具備下列任一角色：擁有者或編輯者或 Firebase 管理員。

Firebase 控制台 Firebase CLI 自動產生的 SDK

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

您可以列出已安裝的擴充功能的每個例項。

執行 extensions-list 指令：

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

查看已安裝擴充功能執行個體的詳細資料和設定

1. 前往 Firebase 主控台的 Firebase Extensions 資訊主頁。

2. 在已安裝的擴充功能例項資訊卡上，按一下「管理」。

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

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

設定預算快訊

一般來說，設定預算快訊是良好的做法，但如果您信任其他人會在專案中執行程式碼，那麼快訊就特別重要。

請務必為 Firebase 專案設定預算快訊。

查看擴充功能建立的函式

1. 前往 Firebase 控制台的「Functions 資訊主頁」。

2. 您可以在「資訊主頁」分頁中查看 Firebase Extensions 的函式 (以及為專案部署的任何其他函式)。

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

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

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

1. 在 Google Cloud 控制台中開啟專案的 Cloud Scheduler 頁面。

2. 在「Jobs」(工作) 清單中，您可以查看 Firebase Extensions 中的 Cloud Scheduler 工作 (以及為專案建立的任何其他工作)。

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

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

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

部分擴充功能會使用 Cloud Tasks 執行較長時間的工作：最常見的是處理在擴充功能生命週期中不同時間點執行的工作，例如安裝、重新設定和升級後。

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

1. 在 Firebase 控制台的「Extensions」 部分，開啟擴充功能執行個體的詳細資料頁面。

2. 在詳細資料頁面中，開啟「API 和資源」部分。如果擴充功能使用 Cloud Tasks，就會有「Cloud Task queues」專區，其中包含一或多個項目。

3. 針對您要管理的佇列按一下「查看佇列」。這麼做會在 Google Cloud 主控台中開啟「Queue Details」(佇列詳細資料) 頁面，您可以在其中查看佇列中的任務、暫停佇列、從佇列中移除任務等等。請參閱 Cloud Tasks 說明文件中的「管理佇列和工作」。

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

   1. 安裝擴充功能的新例項。
   2. 請在安裝新例項後，再解除安裝舊例項。

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

1. 在 Google Cloud 控制台中開啟專案的「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. 在函式資訊主頁的「資訊主頁」分頁中，找出要檢查的 Firebase Extension 對應的特定函式。

2. 按一下項目最右側的 (溢出選單)，然後選取「詳細使用統計資料」。

3. 在顯示的 Google Cloud 主控台中，您可以深入瞭解函式的各種叫用，甚至檢查其原始碼。

查看擴充功能的記錄

如果您想為專案偵錯，或是向 Firebase 提交錯誤報告，建議您查看專案中所執行函式的記錄。

在「函式資訊主頁」的「記錄檔」分頁中，使用頁面頂端的篩選器選取擴充功能建立的函式。

將已安裝的擴充功能執行個體更新至最新版本

您可以將已安裝的擴充功能例項更新至最新發布版本。建議您更新已安裝的執行個體，因為執行個體已在測試、專案或應用程式工作流程中已主動執行或設定。

注意： 如果您是使用自動產生的 SDK 安裝擴充功能，請使用相同的方法升級擴充功能，而非使用控制台或 CLI。

更新執行個體時，系統會覆寫所有執行個體的擴充功能專屬資源和邏輯，以便使用新版本的原始碼和檔案。擴充功能的執行個體 ID 和服務帳戶不會變更。

在更新程序期間，您將會收到新版本的任何變更通知，並能夠指定任何新參數的值。

1. 前往 Firebase Extensions 資訊主頁，然後在已安裝的擴充功能例項資訊卡上，按一下「管理」。

2. 按一下右上角的「更新擴充功能」。

   如果擴充功能沒有可用的新版本，詳細資料頁面就不會顯示更新按鈕。

3. 查看更新內容，並視需要設定擴充功能。

4. 按一下「更新擴充功能」。

重新設定已安裝的擴充功能執行個體

您可以變更已安裝擴充功能例項的使用者設定參數值。這些新值會用於執行個體的任何未來觸發事件，但擴充功能先前建立的所有構件或結構元素 (例如已儲存的圖片或現有儲存空間儲存桶) 都不會受到影響。

注意： 如果您是使用自動產生的 SDK 安裝擴充功能，請使用相同的方法重新設定，而非使用控制台或 CLI。

1. 前往 Firebase Extensions 資訊主頁，然後在已安裝的擴充功能例項資訊卡上，按一下「管理」。

2. 按一下右上角的「重新設定擴充功能」。

3. 按照畫面上的指示重新設定擴充功能的參數值。

4. 按一下 [儲存]。

注意： 系統儲存擴充功能的變更可能需要 3 到 5 分鐘。

解除安裝擴充功能執行個體

您可以在 Firebase 專案中解除安裝擴充功能的執行個體。這項操作會刪除 服務帳戶，以及 Firebase 專為該擴充功能例項建立的所有資源 (例如一組函式)。不過，下列項目不會遭到刪除：

• 擴充功能建立的所有構件，例如已儲存的圖片。

• 專案中的任何其他資源，例如資料庫執行個體或 Cloud Storage 值區。即使擴充功能與這些其他資源互動，但這些資源並非擴充功能專屬，因此在解除安裝擴充功能後，這些資源不會遭到刪除。

以下說明如何解除安裝擴充功能：

1. 前往 Firebase Extensions 資訊主頁，然後在已安裝的擴充功能例項資訊卡上按一下「管理」。

2. 按一下畫面底部的「解除安裝擴充功能」。

3. 查看要刪除的項目，然後按一下「解除安裝擴充功能」確認刪除。

注意： 如果您使用系統產生的 SDK 安裝擴充功能，請務必從 Cloud Functions 程式碼中移除執行個體設定。