触发规则
功能介绍
在流水线的配置过程中，我们通常会希望通过一些策略使得流水线能够自动被触发，或者配置流水线的运行频率与特定的触发条件。带有一定智能性的流水线发布策略能够使得日常的开发工作变得更加游刃有余。流水线支持以下几种触发方式：
- 手动触发
- 代码源事件触发
- 定时触发
- API 触发
上述的多种触发方式可以同时使用。
手动触发
您可以主动触发一个构建计划，手动触发时，可输入对应的构建参数，构建参数将以环境变量的形式加入到构建环境中。在流水线页面点击“立即构建”，在弹框中按需选择构建目标（标签、分支、修订版本），填写相应的参数完成触发构建。
代码源事件触发
通过提交代码或在合并请求中完成流水线的触发能够带来行云流水的开发体验，也是大部分开发人员首选的自动化发布策略。流水线提供了代码提交触发、代码标签触发、合并请求触发三种可选的触发方式。
代码提交触发
包含以下六种代码提交策略的触发机制：
- 包含代码分支。当前选中的目标分支有更新操作后自动运行流水线。
- 排除代码分支。当前选中的目标分支有更新操作后不运行流水线。
- 包含文件路径。监听范围涵盖所有分支，当前选中的文件路径下的文件有更新后运行流水线。
- 排除文件路径。监听范围涵盖所有分支，当前选中的文件路径下的文件有更新后不运行流水线。
- 包含创建人。当目标人员提交代码后才会触发流水线。
- 排除创建人。当目标人员提交代码后不会触发流水线。
合并请求触发
目前合并请求会在以下几种情况下执行构建：
- 新建合并请求时触发
- 合并合并请求时触发
- 合并请求中的源代码发生变更时触发
新建合并请求时触发与合并合并请求时触发的不同之处在于，合并请求构建会构建源分支与目标分支合并后的结果，可以尽早发现集成中的错误。
自动取消相同构建
您可以在设置中勾选是否取消“自动取消相同版本号”以及“自动取消相同合并请求”所触发的构建（仅保留最新一个）。
定时触发
通过给构建计划添加定时触发配置，您可以周期性或在某个具体的时间点，自动触发一个构建计划，产生一个具体的构建任务。您可以为一个构建计划添加多个定时触发，没有前后优先级之分，多个定时触发有时间重合的，依然会触发多次构建。
触发条件：
勾选选项后，若监听的分支代码相比上次触发记录无任何变动记录，即使到达触发时间，也不会触发流水线。
日期选择
您可以选择选择一周内的多个日期。
周期触发
您可以选定 00:00 - 24:00 之间的任意时间为周期（精确到小时），按照选中的间隔触发任务。
单次触发
您可以在 00:00 - 24:00 之间选择任意时间为触发时间点（精确到分钟）。
API 触发
在使用此项功能之前，请确保您已经在【项目设置】->【开发者选项】->【项目令牌】->【新建令牌】中生成了具备持续集成 API 触发权限的令牌。
生成具备相应权限的令牌后便能够调用构建计划中的 API 触发接口。点击生成 curl 命令触发示例后即可生成相应的调用命令。
2023-02-21最近更新在阅读中是否遇到以下问题？*
您希望我们如何改进？*
如果您希望得到回复，请留下您的邮箱地址。
