管理已安裝的 Firebase Extensions

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

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

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

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

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

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

設定預算快訊

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

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

查看擴充功能建立的函式

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

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

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

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

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

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

  2. 在工作清單中，您可以從 Firebase 擴充功能 (以及您為專案建立的任何其他工作) 查看 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」(Cloud 工作佇列) 部分，其中會有一或多個項目。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

查看擴充功能的記錄

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

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

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

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

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

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

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

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

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

  3. 請詳閱更新內容，並視需要設定擴充功能。

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

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

您可以針對已安裝的擴充功能執行個體，變更使用者設定的參數值。這些新的值將用於執行個體的任何「未來」觸發條件，但擴充功能建立的所有過往成果或結構元素 (如儲存的映像檔或現有的儲存空間值區) 不會變更。

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

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

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

  4. 按一下「儲存」。

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

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

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

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

解除安裝擴充功能的方法如下：

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

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

  3. 查看即將刪除的內容，然後按一下「解除安裝擴充功能」以確認刪除。