12.6. 构建触发器
构建触发器会在满足触发的条件时调用构建,如源控制推送、创建 webhook 调用 等等。
12.6.1. 创建构建触发器
使用以下步骤使用自定义 Git 存储库创建构建触发器。
以下流程假设您没有在 config.yaml
文件中包含 Github 凭证。
先决条件
- 您已导航到存储库的 Builds 页面。
流程
- 在 Builds 页面中,点 Create Build Trigger。
- 选择所需的平台,如 Github、BitBucket、Gitlab 或使用自定义 Git 存储库。在本例中,我们使用来自 Github 的自定义 Git 存储库。
-
输入自定义 Git 存储库名称,例如
git@github.com:<username>/<repo>.git
。然后,单击 Next。 提示时,通过选择其中一个或两者都选项来配置标记选项:
- 使用分支或标签名称 标记清单。选择此选项时,构建的清单会标记 git 提交的分支或标签的名称。
如果在默认分支 上,添加
latest
标签。在选择此选项时,如果构建发生在存储库的默认分支上,则构建带有 latest 的清单会被标记。另外,您可以添加自定义标记模板。您可以在此处输入多个标签模板,包括将提交中的短 SHA ID、时间戳、作者名称、提交者和分支名称用作标签。如需更多信息,请参阅"构建触发器的标签命名"。
配置标记后,单击 下一步。
- 出现提示时,选择在调用触发器时要构建的 Dockerfile 的位置。如果 Dockerfile 位于 git 存储库的根目录并命名 Dockerfile,请输入 /Dockerfile 作为 Dockerfile 路径。然后,单击 Next。
-
出现提示时,选择 Docker 构建的上下文。如果 Dockerfile 位于 Git 存储库的根目录,请输入
/
作为构建上下文目录。然后,单击 Next。 - 可选。选择可选的机器人帐户。这可让您在构建过程中拉取私有基础镜像。如果您知道没有使用私有基础镜像,您可以跳过这一步。
- 点击 Next。检查任何验证警告。如有必要,请在单击 Finish 前修复问题。
您收到了触发器已成功激活的警报。请注意,使用这个触发器需要以下操作:
- 您必须为以下公钥授予 git 存储库读取访问权限。
您必须将存储库设置为
POST
到以下 URL,以触发构建。保存 SSH 公钥,然后点 return to <organization_name>/<repository_name>。您将被重定向到存储库的 Builds 页面。
在 Builds 页面中,您现在有一个 Build 触发器。例如:
12.6.2. 手动触发构建
可以按照以下流程手动触发构建。
流程
- 在 Builds 页面中,启动新构建。
- 出现提示时,选择 Invoke Build Trigger。
点 Run Trigger Now 手动启动进程。
构建启动后,您可以看到 Repository Builds 页面上的 Build ID。