管理已安裝的 Firebase Extensions

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


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

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

執行 extensions-list 指令：

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

查看已安裝擴充功能例項的詳細資料和設定

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

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

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

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

設定預算快訊

一般來說，設定預算快訊是個好做法，但如果您信任其他方的程式碼會在專案中執行，快訊就顯得格外重要。

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

查看擴充功能建立的函式

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

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

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

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

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

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

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

    擴充功能建立的工作名稱格式如下： 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」(Cloud 工作佇列) 部分，內含一或多個項目。

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

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

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

  2. 在密鑰清單中，您可以查看為 Firebase Extensions 建立的密鑰 (以及您為專案建立的任何其他密鑰)。

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

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

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

檢查已安裝的擴充功能是否正常運作

您可以在控制台中查看函式的所有錯誤 (包括 Firebase Extensions 建立的錯誤)。

  1. 在函式資訊主頁的「健康狀態」分頁中，您可以查看專案中所有函式的錯誤和效能資訊總覽。

  2. 如要查看特定擴充功能的資訊，請使用頁面頂端的篩選器選取特定函式。

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

  1. 在函式資訊主頁的「資訊主頁」分頁中，找出要檢查 Firebase Extension 的特定函式。

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

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

查看擴充功能的記錄

如要偵錯專案或向 Firebase 提交錯誤報告，查看專案中執行的函式記錄會很有幫助。

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

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

您可以將已安裝的擴充功能更新至最新發布版本。您可能需要更新已安裝的執行個體，因為該執行個體已在測試、專案或應用程式工作流程中積極運作或設定。

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

更新期間，系統會通知您新版本的所有變更，並可指定任何新參數的值。

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

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

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

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

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

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

您可以變更已安裝擴充功能執行個體的使用者設定參數值。這些新值會用於執行個體的後續觸發程序，但擴充功能建立的所有先前構件或結構元素 (例如儲存的圖片或現有儲存空間值區) 都不會變更。

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

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

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

  4. 按一下 [儲存]。

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

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

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

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

如要解除安裝擴充功能，請按照下列步驟操作：

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

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

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