如要安裝或管理擴充功能,您必須獲派下列任一角色:擁有者或編輯者,或 Firebase 管理員。
列出專案已安裝的擴充功能執行個體
您可以列出已安裝擴充功能的每個執行個體。
執行 extensions-list 指令:
firebase ext:list --project=projectId-or-alias
查看已安裝擴充功能執行個體的詳細資料和設定
前往 Firebase 控制台的Firebase Extensions 資訊主頁。
在已安裝擴充功能例項的資訊卡上,按一下「管理」。
監控已安裝的擴充功能執行個體
在 Firebase 控制台中,您可以監控已安裝擴充功能的活動,包括檢查健康狀態、使用情況和記錄。
設定預算快訊
一般來說,設定預算快訊是個好做法,但如果您信任其他方的程式碼會在專案中執行,快訊就顯得格外重要。
請務必為 Firebase 專案設定預算快訊。
查看擴充功能建立的函式
在「資訊主頁」分頁中,您可以查看 Firebase Extensions 中的函式 (以及您為專案部署的任何其他函式)。
擴充功能建立的函式名稱格式如下:
ext-extension-instance-id-functionName
例如:
ext-awesome-task-simplifier-onUserCreate
查看擴充功能建立的 Cloud Scheduler 個工作
在 Google Cloud 控制台中開啟專案的Cloud Scheduler頁面。
在「Jobs」(工作) 清單中,您可以查看 Cloud Scheduler 的工作 (以及您為專案建立的任何其他工作)。Firebase Extensions
擴充功能建立的工作名稱格式如下:
firebase-ext-extension-instance-id-functionName
例如:
firebase-ext-awesome-task-simplifier-doTask
查看及管理擴充功能加入佇列的 Cloud Tasks
部分擴充功能會使用 Cloud Tasks 執行長時間執行的工作,最常見的是在擴充功能生命週期的各個階段 (安裝、重新設定及升級後) 執行的處理工作。
通常這些工作會自動執行並完成,不需要您介入。 不過,如果需要手動管理擴充功能的佇列工作 (例如暫停佇列,或從佇列中移除尚未開始的工作),請按照下列步驟操作:
在詳細資料頁面中,開啟「API 和資源」部分。如果擴充功能使用 Cloud Tasks,就會顯示「Cloud Task queues」(Cloud 工作佇列) 部分,其中包含一或多個項目。
找到要管理的佇列,然後按一下「查看佇列」。這會在 Google Cloud 控制台中開啟「Queue Details」(佇列詳細資料) 頁面,您可以在其中查看佇列中的工作、暫停佇列、從佇列中移除工作等。請參閱 Cloud Tasks 說明文件中的「管理佇列和工作」。
查看擴充功能建立的 Cloud Secret Manager 密鑰
在 Google Cloud 控制台中,開啟專案的 Secret Manager 頁面。
在密鑰清單中,您可以查看為 Firebase Extensions 建立的密鑰 (以及您為專案建立的任何其他密鑰)。
擴充功能建立的密鑰名稱格式如下:
ext-extension-instance-id-paramnName
例如:
ext-awesome-task-simplifier-API_KEY
Secret 會標示金鑰
firebase-extensions-managed
。除非您想停止讓 Firebase 管理密鑰,否則請勿移除這個標籤。
檢查已安裝的擴充功能是否正常運作
您可以在控制台中查看函式的所有錯誤 (包括 Firebase Extensions 建立的錯誤)。
在函式資訊主頁的「健康狀態」分頁中,您可以查看專案中所有函式的錯誤和效能資訊總覽。
如要查看特定擴充功能的資訊,請使用頁面頂端的篩選器選取特定函式。
查看已安裝擴充功能的執行頻率
在函式資訊主頁的「資訊主頁」分頁中,找到要檢查 Firebase Extension 的特定函式。
按一下項目最右側的
(溢位選單),然後選取「詳細使用情況統計資料」。在顯示的 Google Cloud 控制台中,您可以深入瞭解函式的各種呼叫,甚至檢查其原始碼。
查看擴充功能的記錄
如要偵錯專案或向 Firebase 提交錯誤報告,查看專案中執行的函式記錄會很有幫助。
在函式資訊主頁的「記錄」分頁中,使用頁面頂端的篩選器,選取擴充功能建立的函式。
將已安裝的擴充功能執行個體更新至最新版本
您可以將已安裝的擴充功能更新至最新發布版本。您可能需要更新已安裝的執行個體,因為該執行個體已在測試、專案或應用程式工作流程中積極執行或設定。
更新執行個體時,系統會覆寫執行個體的所有擴充功能專屬資源和邏輯,改用新版本的原始碼和檔案。擴充功能的執行個體 ID 和服務帳戶不會變更。
更新期間,系統會通知您新版本的所有變更,並可指定任何新參數的值。
前往Firebase Extensions 資訊主頁,然後在已安裝擴充功能例項的資訊卡上,按一下「管理」。
按一下右上角的「更新擴充功能」。
如果擴充功能沒有可用的新版本,詳細資料頁面就不會顯示更新按鈕。
查看更新內容,並視需要設定擴充功能。
按一下「更新擴充功能」。
重新設定已安裝的擴充功能執行個體
您可以變更已安裝擴充功能執行個體的使用者設定參數值。這些新值會用於執行個體的後續觸發程序,但擴充功能建立的所有先前構件或結構元素 (例如已儲存的圖片或現有儲存空間值區) 都不會變更。
前往Firebase Extensions資訊主頁,然後在已安裝擴充功能例項的資訊卡上,按一下「管理」。
按一下右上角的「重新設定擴充功能」。
按照畫面上的指示,重新設定擴充功能的參數值。
按一下 [儲存]。
解除安裝擴充功能執行個體
您可以從 Firebase 專案解除安裝擴充功能執行個體。這項操作會刪除服務帳戶,以及 Firebase 專為該擴充功能執行個體建立的所有資源 (例如一組函式)。不過,系統不會刪除下列項目:
這項擴充功能建立的所有構件,例如已儲存的圖片。
專案中的任何其他資源,例如資料庫執行個體或 Cloud Storage 值區。即使擴充功能與這些其他資源互動,這些資源也不屬於擴充功能專用,因此即使解除安裝擴充功能,這些資源也不會遭到刪除。
如要解除安裝擴充功能,請按照下列步驟操作:
前往Firebase Extensions資訊主頁,然後在已安裝擴充功能例項的資訊卡上,按一下「管理」。
按一下畫面底部的「解除安裝擴充功能」。
查看要刪除的項目,然後按一下「解除安裝擴充功能」確認刪除。