从 Bitbucket Cloud 构建代码库

借助 Cloud Build，您可以创建触发器以便根据 Bitbucket Cloud 上托管的代码库进行构建，从而执行构建以响应事件，例如提交推送或与您的 Bitbucket Cloud 代码库关联的合并请求。

本页面介绍了如何在 Bitbucket Cloud 实例上启用触发器功能。详细了解 Cloud Build 触发器和 Cloud Build 代码库。

准备工作

  • 启用 Cloud Build and Secret Manager API。

    启用 API

创建 Bitbucket Cloud 触发器

按照以下步骤创建 Bitbucket Cloud 触发器：

控制台

  1. 打开触发器页面

    打开“触发器”页面

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

  3. 点击创建触发器。

  4. 输入以下触发器设置：

    • 名称：触发器的名称。

    • 区域：为触发器选择区域。

      • 如果与触发器关联的构建配置文件指定了专用池，则 Cloud Build 会使用该专用池来运行构建。在这种情况下，您在触发器中指定的区域必须与创建专用池的区域一致。
      • 如果与触发器关联的构建配置文件未指定专用池，则 Cloud Build 将使用默认池在触发器所在的区域中运行构建。

    • 说明（可选）：触发器的说明。

    • 事件：选择用于调用触发器的代码库事件。

      • 推送到分支：设置触发器，以便基于对特定分支的提交启动构建。

      • 推送新标记：将触发器设置为以基于包含特定标记的提交启动构建。

      • 拉取请求：设置触发器以基于对拉取请求的提交启动构建。

    • 来源：选择第 2 代作为来源。

      • 代码库：从可用代码库列表中，选择相应代码库。如需连接新的代码库，请参阅连接到 Bitbucket Cloud 代码库。

      • 分支或标记：指定要匹配分支或标记值的正则表达式。如需了解可接受的正则表达式语法，请参阅 RE2 语法。

      • 注释控制：如果您选择拉取请求作为事件，请选择以下选项之一，以控制触发器是否自动执行构建：

        • 所有者和协作者除外：当代码库所有者或协作者创建或更新拉取请求时，触发器会自动执行构建。如果操作是由外部贡献者发起，则只有在所有者或协作者对拉取请求添加 /gcbrun 注释后，系统才会执行构建。

        • 必需：如果任何贡献者创建或更新拉取请求，则只有在所有者或协作者对拉取请求添加注释 /gcbrun 后，系统才会执行构建。每次对拉取请求进行更改时，系统都会执行构建。

        • 不需要：任何贡献者创建或更新拉取请求时，触发器会自动执行构建。

    • 配置：选择位于您的代码库中的构建配置文件，或在触发器上以内嵌方式配置构建。

    • 类型：选择要用于构建的配置类型。

      • Cloud Build 配置文件（yaml 或 json）：为您的配置使用构建配置文件。
      • Dockerfile：为您的配置使用 Dockerfile。

    • 位置：为您的配置指定位置。

      • 代码库：如果您的配置文件位于代码库中，请提供构建配置文件的位置或 Dockerfile 目录以及生成的映像的名称。如果您的配置是 Dockerfile，则还可以选择提供构建的超时时间。提供了 Dockerfile 和映像名称后，您将看到 build 的 docker build 命令的预览。

      • 内嵌：如果您选择了 Cloud Build 配置文件（yaml 或 json）作为配置选项，则可以指定内嵌构建配置。点击打开编辑器，使用 YAML 或 JSON 语法在 Google Cloud 控制台中编写构建配置文件。点击完成以保存您的构建配置。

  5. 点击创建以创建 Bitbucket Cloud 触发器。

gcloud

使用以下命令创建代码库推送事件触发器：

gcloud builds triggers create bitbucket-cloud \
    --name=TRIGGER_NAME \
    --repository=\
    projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
    --branch-pattern=".*" --build-config="CONFIG_NAME" \
    --region=REGION

其中：

  • TRIGGER-NAME 是您要为构建触发器指定的名称。
  • PROJECT_ID 是您的 Google Cloud 项目 ID。
  • REGION 是触发器的区域。
  • CONNECTION_NAME 是您的主机连接的名称。
  • REPO_NAME 是 Bitbucket Cloud 中已连接代码库的名称。
  • CONFIG_NAME 是配置架构文件的名称。

创建触发器后，Cloud Build 会监听所有分支上的所有推送事件。当您将任何提交推送到代码库时，系统会调用触发器。您可以在构建记录页面中查看构建结果。

数据共享

从 Cloud Build 发送到 Bitbucket Cloud 的数据可帮助您按名称识别触发器，并查看 Bitbucket Cloud 代码库中的构建结果。

Cloud Build 和 Bitbucket Cloud 主机会共享以下数据：

  • Google Cloud 项目 ID
  • 触发器名称

后续步骤