本页介绍了如何在 Bitbucket Cloud 实例上启用触发器功能。详细了解 Cloud Build 触发器和 Cloud Build 仓库。
准备工作
-
Enable the Cloud Build and Secret Manager APIs.
- 按照说明连接 Bitbucket Cloud 主机。
- 按照连接到 Bitbucket Cloud 代码库中的说明操作。
创建 Bitbucket Cloud 触发器
请按照以下步骤创建 Bitbucket Cloud 触发器:
控制台
打开触发器页面
选择您的 Google Cloud 项目,然后点击打开。
点击创建触发器。
输入以下触发器设置:
名称:触发器的名称。
区域:为触发器选择区域。
- 如果与触发器关联的 build 配置文件指定了专用池,Cloud Build 会使用该专用池运行 build。在这种情况下,您在触发器中指定的区域必须与您创建专用池的区域一致。
- 如果与触发器关联的 build 配置文件未指定专用池,Cloud Build 会使用默认池在与触发器相同的区域中运行 build。
说明(可选):触发器的说明。
事件:选择用于调用触发器的代码库事件。
推送到分支:设置触发器,以便基于对特定分支的提交启动构建。
推送新标记:将触发器设置为以基于包含特定标记的提交启动构建。
拉取请求:设置触发器,以便基于针对拉取请求进行的提交启动构建。
来源:选择第 2 代作为来源。
代码库:从可用代码库列表中,选择代码库。如需关联新的代码库,请参阅关联到 Bitbucket Cloud 代码库。
分支或标记:指定要匹配分支或标记值的正则表达式。如需了解可接受的正则表达式语法,请参阅 RE2 语法。
评论控制:如果您选择了拉取请求作为事件,请选择以下选项之一来控制构建是否将由触发器自动执行:
必需(所有者和协作者除外):代码库所有者或协作者创建或更新拉取请求后,触发器会自动执行构建。如果外部贡献者发起操作,则只有在所有者或协作者对拉取请求中的
/gcbrun
添加注释之后,触发器才会执行构建。必需:任何贡献者创建或更新拉取请求后,只有在所有者或协作者对拉取请求中的
/gcbrun
添加注释之后,触发器才会执行构建。每次对拉取请求进行更改时,系统都会执行构建。不需要:任何贡献者创建或更新拉取请求后,触发器会自动执行构建。
配置:选择位于您的代码库中的构建配置文件,或在触发器上以内嵌方式配置构建。
类型:选择要用于构建的配置类型。
- Cloud Build 配置文件(yaml 或 json):为您的配置使用构建配置文件。
- Dockerfile:为您的配置使用
Dockerfile
。
位置:为您的配置指定位置。
代码库:如果您的配置文件位于代码库中,请提供构建配置文件的位置或
Dockerfile
目录,并为生成的映像提供名称。如果您的配置是Dockerfile
,则还可以选择提供构建的超时时间。提供了Dockerfile
和映像名称后,您会看到构建的docker build
命令的预览。内嵌:如果您选择了 Cloud Build 配置文件(yaml 或 json)作为配置选项,则可以指定内嵌构建配置。点击打开编辑器,使用 YAML 或 JSON 语法在 Google Cloud 控制台中编写您的构建配置文件。点击完成以保存您的构建配置。
点击创建以创建 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
- 触发器名称
后续步骤
- 了解如何创建和管理触发器。
- 了解如何手动启动构建。
- 了解如何查看构建结果。
- 了解如何在 Compute Engine 上执行蓝绿部署。