部署到 Firebase

本页介绍了如何使用 Cloud Build 将应用部署到 Firebase。如果您是刚接触 Cloud Build，请先阅读快速入门和构建配置概览。

准备工作

  • Enable the Cloud Build, Firebase, and Resource Manager APIs.

    Enable the APIs

  • 如需运行此页面中的 gcloud 命令，请安装 Google Cloud CLI。

  • 保留您的应用源代码，包括 firebase.json。您的源代码需要存储在代码库中，例如 Cloud Source Repositories、GitHub 或 Bitbucket。

  • 如果您还没有要部署到 Firebase 的项目，则可以通过安装和初始化 Firebase 来创建默认项目。

必需的 IAM 权限

  1. 在 Google Cloud 控制台中打开 IAM 页面：

    打开 IAM 页面

  2. 选择您的项目，然后点击打开。

  3. 在权限表中，找到您用于 build 的服务账号的电子邮件地址，然后点击铅笔图标。

  4. 向服务账号添加 Cloud Build Service Account(roles/cloudbuild.builds.builder)、Firebase Admin (roles/firebase.admin) 和 API Keys Admin (roles/serviceusage.apiKeysAdmin) 角色。

  5. 点击保存。

使用 firebase Docker 映像

Cloud Build 提供构建器映像，可用于在 Cloud Build 中调用 firebase 命令。如需在 Cloud Build 配置文件中使用此构建器，您可以使用 firebase 构建步骤将其部署到 Firebase：

  1. 创建一个名为 cloudbuild.yaml 或 cloudbuild.json 的构建配置文件，其中 PROJECT_ID 是您的Google Cloud 项目 ID，而 FIREBASE_PROJECT_ID 是您的 Firebase 项目 ID：

    YAML 

    steps:
- name: "us-docker.pkg.dev/firebase-cli/us/firebase"
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']
## Or, target a specific version of firebase-tools
- name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']

    JSON 

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/firebase",
      "args": [
         "deploy",
         "--project",
         "FIREBASE_PROJECT_ID",
         "--only",
         "hosting"
       ]
  }
  ]
}

    您可以使用
    name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z 选择特定版本的 firebase-tools

  2. 使用构建配置文件启动构建：

    gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    其中：

    • REGION 是受支持的 build 区域之一。
    • CONFIG_FILE_PATH 是构建配置文件的路径。
    • SOURCE_DIRECTORY 是源代码的路径或网址。

持续部署

通过创建 Cloud Build 触发器，您可以将软件自动部署到 Firebase。您可以将触发器配置为每次您在更新源代码时都会构建和部署映像。

要自动部署到 Firebase，请执行以下操作：

  1. 在代码库中，添加一个构建配置文件，其中包含调用 firebase deploy 命令的步骤，其中 PROJECT_ID 是您的 Google Cloud 项目 ID：

    YAML

    steps:
      - name: us-docker.pkg.dev/firebase-cli/us/firebase
        args: ['deploy', '--project=PROJECT_ID', '--only=hosting']

    JSON

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/firebase",
      "args": [
         "deploy",
         "--project",
         "PROJECT_ID",
         "--only",
         "hosting"
       ]
  }
  ]
}

  2. 使用上一步中创建的构建配置文件创建触发器：

    1. 在 Google Cloud 控制台中打开触发器页面：

      打开“触发器”页面

    2. 从页面顶部的项目选择器下拉菜单中选择您的项目。

    3. 点击打开。

    4. 点击创建触发器。

      在创建触发器页面上，输入以下设置：

      1. 输入触发器的名称。

      2. 选择用于启动触发器的代码库事件。

      3. 选择包含源代码和构建配置文件的代码库。

      4. 指定用于启动触发器的分支名称或标记名称的正则表达式。

      5. 配置：选择您之前创建的构建配置文件。

    5. 点击创建以保存您的构建触发器。

每当您将新代码推送到代码库时，系统都将自动在 Firebase 上启动构建和部署。

如需详细了解如何创建 Cloud Build 触发器，请参阅创建和管理构建触发器。

代码示例

要查看使用 Cloud Build 部署到 Firebase 的代码示例，请转到 deploy-firebase-example。

后续步骤