GitLab webhook 事件 - AWS CodeBuild

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

GitLab webhook 事件

您可以使用 webhook 筛选器组来指定哪些 GitLab Webhook 事件会触发构建。例如，您可以指定仅在对特定分支做出更改时触发构建。

您可以创建一个或多个 Webhook 筛选条件组，来指定哪些 Webhook 事件触发构建。如果任何筛选条件组评估为 true（即组中的所有筛选条件都评估为 true），则会触发构建。创建筛选条件组时，应指定：

事件

对于 GitLab，您可以选择以下一个或多个事件：PUSH、PULL_REQUEST_CREATED、PULL_REQUEST_UPDATED、PULL_REQUEST_MERGED、PULL_REQUEST_REOPENEDPULL_REQUEST_CLOSED、RELEASED、和WORKFLOW_JOB_QUEUED。

webhook 的事件类型位于其在 X-GitLab-Event 字段中的标头中。下表显示了 X-GitLab-Event 标头值如何映射到事件类型。对于 Merge Request Hook webhook 事件，有效载荷的 object_atttributes.action 将包含有关合并请求类型的更多信息。

X-GitLab-Event 标头值 object_atttributes.action 事件类型
Push Hook

不适用

 PUSH
Merge Request Hook

打开

 PULL_REQUEST_CREATED
Merge Request Hook

更新

 PULL_REQUEST_UPDATED
Merge Request Hook

merge

 PULL_REQUEST_MERGED
Merge Request Hook

重新打开

 PULL_REQUEST_REOPENED
Merge Request Hook

关闭

 PULL_REQUEST_CLOSED
Release Hook

创建、更新

 RELEASED
Job Hook

不适用

 WORKFLOW_JOB_QUEUED

对于 PULL_REQUEST_MERGED，如果拉取请求与压缩策略合并且拉取请求分支已关闭，则原始的拉取请求提交将不再存在。在这种情况下，CODEBUILD_WEBHOOK_MERGE_COMMIT 环境变量包含压缩后的合并提交的标识符。

一个或多个可选筛选条件

使用正则表达式来指定筛选条件。对于触发构建的事件，组内与其关联的每个筛选条件都必须评估为 True。

ACTOR_ACCOUNT_ID（控制台中的 ACTOR_ID）

当 GitLab 账户 ID 与正则表达式模式匹配时，Webhook 事件会触发构建。此值显示在 Webhook 筛选条件负载中的 actor 对象的 account_id 属性中。

HEAD_REF

当头部引用与正则表达式模式（例如 refs/heads/branch-name 和 refs/tags/tag-name）匹配时，Webhook 事件会触发构建。HEAD_REF 筛选条件将评估分支或标签的 Git 引用名称。分支或标签名称显示在 Webhook 负载的 push 对象中的 new 对象的 name 字段中。对于拉取请求事件，分支名称显示在 Webhook 负载中的 source 对象的 branch 中的 name 字段中。

BASE_REF

当基础引用与正则表达式模式匹配时，Webhook 事件会触发构建。BASE_REF 筛选条件仅处理拉取请求事件（例如，refs/heads/branch-name）。BASE_REF 筛选条件评估分支的 Git 引用名称。分支名称显示在 branch 对象的 name 字段中，该对象位于 Webhook 负载的 destination 对象中。

FILE_PATH

当更改的文件的路径与正则表达式模式匹配时，Webhook 会触发构建。

COMMIT_MESSAGE

当 HEAD 提交消息与正则表达式模式匹配时，Webhook 会触发构建操作。

WORKFLOW_NAME

当工作流名称与正则表达式模式匹配时，Webhook 会触发构建操作。

注意

你可以在仓库的 webhook 设置中找到 webhook 有效负载。 GitLab

主题