使用現有的 Google Cloud 專案開始使用 Firebase

Firebase 專案是 Google Cloud 專案,已啟用一些額外的 Firebase 專屬設定和服務。這通常稱為在 Google Cloud 專案中「新增 Firebase」。本頁將說明如何「新增 Firebase」,並提供一些常見問題 (FAQ)

將 Firebase 新增至 Google Cloud 專案後,Firebase 會自動啟用多個 API,並建立服務帳戶,簡化所有 Firebase 服務和介面的使用方式。Firebase 也會在 Google Cloud 主控台的「標籤」頁面中,為您的專案新增firebase:enabled標籤。進一步瞭解「新增 Firebase」後會發生什麼事。

Firebase 專案和 Google Cloud 專案之間的關係

由於 Firebase 專案Google Cloud 專案:

  • 您可以在 Firebase 控制台Google Cloud 控制台Google API 控制台 中存取專案並與其互動。

  • 您可以使用 Firebase CLIgcloud CLI 和 Google 提供的任何 Terraform 資源與專案互動。

  • 您可以在專案中使用 Firebase 和 Google Cloud 的產品和 API。

  • 專案的 IAM 權限和角色會在 Firebase 和 Google Cloud 之間共用。專案成員 (即主要使用者) 對 Google Cloud 專案的任何存取權,也會套用至 Firebase 專案 (反之亦然)。

  • 專案的帳單會在 Firebase 和 Google Cloud 之間共用。如果 Google Cloud 專案已啟用計費功能,您的 Firebase 專案將採用 Firebase 的即付即用 Blaze 定價方案。

  • 專案的專屬 ID (例如專案編號專案 ID) 會在 Firebase 和 Google Cloud 之間共用。

  • 套用至 Google Cloud 專案的任何資源階層 (例如機構、資料夾等) 也會套用至 Firebase 專案。

  • 刪除專案會在 Firebase 和 Google Cloud 中刪除該專案。

  • 刪除或修改專案中的資源或資料,會同時影響 Firebase 和 Google Cloud

如何將 Firebase 新增至現有的 Google Cloud 專案

您可以使用下列任一選項,將「Firebase」新增至現有的 Google Cloud 專案。請確認您具備必要權限,才能將 Firebase 新增至 Google Cloud 專案。

請注意,一旦將「Firebase」新增至現有的 Google Cloud 專案,就無法復原 (也就是說,您無法「完全」Google Cloud 專案中「移除 Firebase」)。詳情請參閱常見問題

  1. 前往 Firebase 控制台

  2. 使用可存取現有 Google Cloud 專案的 Google 帳戶登入。

  3. 按一下 [Create a project] (建立專案)。

  4. 按一下頁面底部的「已有 Google Cloud 專案嗎?」連結。

  5. 在文字欄位中輸入現有專案的專案 ID,然後從顯示的清單中選取專案。

  6. 按一下「開啟專案」

  7. 如果系統顯示提示,請接受 Firebase 條款

  8. 按照畫面上的操作說明「新增 Firebase」並設定 Firebase 專案。

    請注意,啟用 Google Analytics 為選用功能。

  1. 如果您尚未安裝,請安裝 Firebase CLI

  2. 使用可存取現有 Google Cloud 專案的 Google 帳戶登入

  3. 執行下列指令:

    firebase projects:addfirebase
  4. 收到系統提示時,請從顯示的清單中選取現有的 Google Cloud 專案。

  1. 在現有的 Google Cloud 專案中啟用 Firebase Management API

  2. 產生 API 存取權杖。

  3. 請呼叫 projects.addFirebase,為專案啟用 Firebase 服務。

    請注意,您必須提供專案的資源名稱才能發出這項呼叫。

如需詳細操作說明,請參閱 Firebase 指南中的「將 Firebase 服務新增至專案」一節:「使用 Management REST API 設定及管理 Firebase 專案」。請務必按照該指南「事前準備」一節中的所有說明操作。

  1. 在現有的 Google Cloud 專案中啟用 Firebase Management API (firebase.googleapis.com)。

  2. 使用 google_firebase_project 資源,為專案啟用 Firebase 服務。

如要進一步瞭解如何使用 Firebase 和 Terraform,請參閱「開始使用 Terraform 和 Firebase」。

常見問題與疑難排解

如要在 Google Cloud 專案中存取及使用 Firebase 的所有功能,您必須接受 Firebase 服務條款。您也必須接受 Firebase 條款,才能將 Firebase 新增至現有的 Google Cloud 專案。

無論您有多少個專案可存取,只需為 Google 帳戶接受一次 Firebase 條款即可。接受條款時,您只會為自己的 Google 帳戶接受條款,不會為所有專案成員在專案層級接受條款。

您可以透過 Firebase 控制台使用下列任一選項接受 Firebase 條款。在系統提示時,接受條款。

  • 使用 Firebase 主控台建立新的 Firebase 專案。

  • Firebase 主控台中開啟現有的 Firebase 專案 (例如,有人邀請您成為專案成員 (即主要人員)。)。

  • Firebase 控制台中開啟現有的 Google Cloud,然後「新增 Firebase」

如要將「Firebase」新增至現有的 Google Cloud 專案,專案成員 (即實體) 必須具備下列 IAM 權限:

  • firebase.projects.update
  • resourcemanager.projects.get
  • serviceusage.services.enable
  • serviceusage.services.get

根據預設,「編輯者」和「擁有者」的 IAM 角色都包含這些權限。

所有 Firebase 專案在 Google Cloud 主控台的「標籤」頁面中都有一個 firebase:enabled 標籤

不過,如果您只將 firebase:enabled 標籤手動新增至專案標籤清單,就不會為 Google Cloud 專案啟用 Firebase 專屬設定和服務。如要這麼做,您必須使用 Firebase 控制台新增 Firebase (如果是進階用途,則可使用 Firebase CLI、Firebase Management REST API 或 Terraform)。

Firebase 專案是 Google Cloud 專案,已啟用一些額外的 Firebase 專屬設定和服務。因此,當您在現有的 Google Cloud 專案中「新增 Firebase」時,Firebase 會採取以下行動,簡化所有 Firebase 服務和介面的使用方式:

  • Google Cloud 主控台的「Labels」頁面中新增「firebase:enabled」標籤

  • 建立「Browser」API 金鑰,並自動將其限制為僅限用於 Firebase 相關 API

  • 建立下列服務帳戶:

    • service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
    • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
  • 啟用下列 API:

    • App Engine Admin API
    • Cloud Pub/Sub API
    • Cloud Resource Manager API
    • Cloud Runtime Configuration API
    • Cloud Testing API
    • Firebase Cloud Messaging API
    • Firebase Dynamic Links API
    • Firebase Hosting API
    • Firebase Installations API
    • Firebase Management API
    • Firebase Remote Config API
    • Firebase 遠端設定即時 API
    • Firebase Rules API
    • Identity Toolkit API
    • Token Service API

將「Firebase」新增至現有的 Google Cloud 專案後,無法復原 (也就是說,您無法從 Google Cloud 專案「完全」「移除 Firebase」)。

「新增 Firebase」程序會啟用 API 和後端服務,這些服務可能會用於其他 Google Cloud 功能。停用所有已啟用的服務可能會因依附元件而導致意外的非預期後果。

不過,如果您選擇這麼做,可以手動停用所有 API,並刪除在您「新增 Firebase」時自動啟用及建立的標籤、API 金鑰和服務帳戶

雖然您無法實際阻止在現有 Google Cloud 專案中「新增 Firebase」的可能性,但可以採取以下做法:

限制擁有 IAM 權限 firebase.projects.update 的專案成員 (即主體),因為您必須擁有該權限才能「新增 Firebase」。您可以使用 IAM 拒絕政策來有效執行這項操作。

後續步驟

  • 如要進一步瞭解 Firebase 專案,請參閱下列資源:

    • 瞭解 Firebase 專案:簡要概述 Firebase 專案的幾個重要概念,包括與 Google Cloud 的關係,以及專案、應用程式和資源的基本階層。

    • 設定 Firebase 專案的一般最佳做法:提供設定 Firebase 專案和將應用程式註冊至專案的一般高層級最佳做法,讓您能擁有使用不同環境的明確開發工作流程。

  • 如要在行動和網頁應用程式中開始使用 Firebase,請將應用程式註冊至 Firebase 專案,並將其連結至 Firebase:iOS+ | Android | 網頁 | Flutter | Unity | C++