安裝 Firebase 擴充功能

您可以安裝 (及管理) 任何 官方 Firebase 擴充功能的範本,您可以透過 Firebase 控制台或 Firebase CLI (指令列介面)。

請務必詳閱 差異 Firebase CLI 和 Firebase 控制台支援的動作。



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

如要安裝擴充功能,專案必須採用 Blaze (即付即用方案) 前往) 計畫。雖然安裝擴充功能不必付費,但你可能要 您必須支付使用 Firebase 服務或 Cloud 服務 (例如 Cloud Secret Manager (如果您的用量超過服務)免費 級別。

事前準備

如果您尚未將 Firebase 新增至專案並升級,請先完成這項操作。 Firebase 專案中的 Blaze (即付即用) 方案。

步驟 1:查看擴充功能的詳細資訊

這是選擇性步驟,但強烈建議執行。

安裝 Firebase Extension 之前,建議您先 查看擴充功能的詳細資訊,包括:

  • 擴充功能運作方式、安裝前工作,以及 擴充功能
  • 一般身分識別資訊和說明
  • 擴充功能的工作是否需要帳單帳戶
  • Google 服務 (API) 存取角色 作業
  • 已建立資源 適用於擴充功能 (例如函式)
  • 可由使用者設定的參數說明

如何查看擴充功能的詳細資訊:

  1. 前往 Extensions Hub瀏覽官方 Firebase 擴充功能。

  2. 按一下擴充功能資訊卡即可:

步驟 2:安裝擴充功能

在安裝過程中,系統會提示您檢閱 擴充功能的規格 (例如已啟用的 API 資源 存取等方式)。 如有任何帳單要求,您會收到通知,並提示您 指定擴充功能可設定參數的值。

  1. 前往 Extensions Hub瀏覽官方 Firebase 擴充功能。

  2. 按一下擴充功能的資訊卡,然後查看 擴充功能,可提供特定使用操作說明和任何 安裝前的工作

  3. 按一下「安裝」,然後按照畫面上的指示安裝 。

步驟 3:完成安裝後設定

部分擴充功能必須提供必要或選用步驟,您才能開始使用 具體做法是指示 Kubernetes 建立並維護 一或多個代表這些 Pod 的物件請前往擴充功能的安裝後詳細資料頁面,查看以下操作說明: Firebase 控制台的 Extensions 資訊主頁 (連至 安裝之後,終端機中就會顯示資訊主頁)。

您也可以在下方的 POSTINSTALL.md 檔案中找到這些操作說明: 擴充功能的來源目錄

建立 Firebase 資源

如果您將擴充功能設為使用 Firebase 資源 (Cloud Firestore), 現有的集合、Realtime Database 路徑、Cloud Storage 個值區) 請先建立網址,再使用擴充功能

建立 Eventarc 事件處理常式

部分擴充功能會發布至 Eventarc 在執行期間發生重要事件時如果擴充功能會發布事件 如果您在安裝期間啟用事件, 自訂邏輯這項功能很實用 當使用者長時間執行的工作完成時,或是對以下內容進行後續處理時, 加上擴充功能函式

請參閱擴充功能的說明文件,瞭解其發布的事件清單 (如果有的話)。 如需範例,請參閱 「透過 Stripe 執行付款」擴充功能的事件類型

接著,請參閱「自訂事件觸發條件」一文 瞭解如何編寫 Eventarc 事件處理常式。

安裝多個擴充功能執行個體

您可以在同一個專案中多次安裝同一個擴充功能。 每個已安裝的執行個體都能有專屬的自訂設定 擴充功能資源您可以識別並參照每個已安裝的執行個體 「執行個體 ID」,為專案中不重複的 ID。您 系統會提示您確認或編輯每個額外執行個體的執行個體 ID 你安裝的擴充功能

後續步驟

  • 查看詳細資料和 設定 您已安裝的擴充功能 (位於 Firebase 控制台中)。

  • 監控活動 您已安裝的擴充功能,包括檢查其健康狀態、使用情形和記錄。

  • 使用 Firebase 控制台,您可以 管理 已安裝的擴充功能。如果是官方版 Firebase 擴充功能,你可以重新設定 或解除安裝擴充功能,並將擴充功能更新到 版本。

  • 是所有專案的最佳做法,請務必設定 預算快訊 ,並監控用量與帳單 資訊主頁Firebase