You need to enable JavaScript to run this app.
导航
代码源触发
最近更新时间:2024.07.25 14:36:08首次发布时间:2023.07.12 20:22:45

持续交付可通过 Webhook 插件的形式监听代码仓库的行为,一旦发生符合条件的代码变更行为,将自动触发流水线运行。本文为您介绍如何配置代码源触发规则。

前提条件

已创建流水线,并为流水线配置代码源,具体操作请参见 创建流水线

使用限制

通用 Git 不支持直接使用代码源触发功能。如需实现代码源事件触发,请配置 普通 Webhook 触发,并在自己的代码仓库侧进一步配置要推送的事件。

操作步骤

  1. 进入流水线的流程编排页签。

    1. 登录 持续交付控制台
    2. 在左侧导航栏选择 工作区
    3. 单击目标工作区名称,进入当前工作区。
    4. 在左侧导航栏选择 流水线,进入流水线页面。
    5. 在流水线列表中选择目标流水线,单击 ... > 编辑,进入当前流水线的流程编排页签。

    alt

  2. 单击代码源配置框,在弹出的配置输入源面板中,勾选 事件触发 的启用框。

  3. 配置事件触发规则。
    alt

    配置项说明
    Webhook URL展示当前流水线的 Webhook URL,流水线通过该 URL 接收代码仓库的变动。
    触发事件选择具体的触发事件,并根据需要设置对应的触发条件。持续交付中,不同代码源支持的触发事件不完全相同,具体介绍请参考 触发事件与触发条件

    过滤条件

    对于 代码Push合并请求新建/更新 事件,支持配置事件触发的过滤条件,避免流水线频繁触发。

    • 全部事件触发执行: 每一个符合条件的 Commit 事件,都将触发流水线执行。

    • 仅最新事件触发执行: 对于同一个 Branch 的 Commit 事件,取最新事件执行流水线,同时取消执行非最新 Commit 事件触发的流水线运行。主要适用于调试代码、缺陷修复等多次提交 Commit 的场景,有利于帮助用户节省资源成本。

    自动评论

    合并请求新建/更新补丁集创建 事件触发流水线执行时,流水线的运行状态支持以评论的方式自动同步至对应代码仓库的合并请求事件下。方便用户根据运行结果判断是否进行代码合并。

    • 流水线运行状态及任务状态:将流水线运行状态及任务状态同步至合并请求事件的评论中。

    • 流水线运行状态:将流水线运行状态同步至合并请求事件的评论中。

    • 不评论:不开启此自动评论功能。

    注意

    自动评论功能需确保代码源 Token 具备 PullRequest 权限。

    运行时变量

    运行时变量用于配置代码源触发流水线运行时,动态变量的实际使用值。如果不配置,动态变量将使用默认值。 例如:如下图所示,提前配置希望流水线传递的动态变量:参数 a,默认值 1,并开启动态设置。

    • 配置运行时变量,参数选择 a,运行值设置为 10。则代码源触发流水线运行时,a 的取值为 10。

    • 不配置运行时变量,则代码源触发流水线运行时,a 的取值为默认值 1。

    alt

  4. 单击 确定,完成代码源触发设置。

  5. 单击右下角 保存,保存流水线配置。

后续操作

将流水线的 URL 配置至您的代码仓库,否则流水线无法正常接收代码仓库的事件触发消息。具体操作可参考以下章节。