配置流水线执行计划
操作场景
流水线支持配置事件触发、定时任务和并发策略三种执行计划。通过事件触发和定时任务,实现自动化执行;通过并发策略,更细粒度地为用户分配并发资源。
操作步骤
- 访问CodeArts Pipeline。
- 单击“新建流水线”,配置完流水线基本信息和模板信息,进入“任务编排”页。
- 切换至“执行计划”页面,即可为流水线配置执行计划。
配置流水线事件触发
事件触发包括代码提交时触发、合并请求时触发、创建标签时触发。码云代码仓还支持Pull Request、新建issue、评论issue等其他事件。
- 代码提交时触发(代码托管/码云)
监控代码提交触发事件,可以组合分支和具体路径的包含/排除范围,当在关联的代码仓库中有代码提交且所在的分支和变更文件的路径满足包含/排除策略,会自动触发关联流水线执行。
- 分支包含:提交代码的目标分支在包含分支中,则匹配成功。
- 分支排除:提交代码的目标分支在排除分支中,则匹配失败。
- 路径包含:变更文件有任意一个(若配置了路径排除,则必须为排除范围外的变更文件)在包含范围内,则匹配成功。
- 路径排除:变更文件全部在排除范围内,则匹配失败。
- 合并请求时触发(代码托管/码云)
启用合并请求事件触发:监控合并请求触发事件,可以组合分支和具体路径的包含/排除范围,对新建、更新、代码更新、合并和重新打开事件设置触发策略,当在关联的代码仓库侧触发合并请求事件且分支满足包含/排除策略,会自动触发关联流水线执行。
事件说明:
- 新建:合并请求创建时触发。
- 合并:合并请求合入时触发,该事件会同时触发代码提交事件。
- 重新打开:合并请求重新打开时触发。
- 更新:合并请求内容更新、设置更新或者源代码更新时触发,打开“仅代码更新触发”,则仅源代码更新时触发。
分支说明:
- 分支包含:合并请求的目标分支在包含分支中,则匹配成功。
- 分支排除:合并请求的目标分支在排除分支中,则匹配失败。
- 路径包含:变更文件有任意一个(若配置了路径排除,则必须为排除范围外的变更文件)在包含范围内,则匹配成功。
- 路径排除:变更文件全部在排除范围内,则匹配失败。
- 创建标签时触发(代码托管)
监控创建标签触发事件,可以添加标签包含/排除范围,当在关联的代码仓库创建标签且满足标签包含/排除策略,会自动触发关联流水线执行。
- 标签包含:在代码仓库创建的标签在包含标签中,则匹配成功。
- 标签排除:在代码仓库创建的标签在排除标签中,则匹配失败。
- 其他事件(码云)
- 评论Pull Request:评论Pull Request时触发流水线执行。
- 新建issue:新建issue时触发流水线运行。
- 评论issue:评论issue时触发流水线运行。
- 除了上述事件外,码云代码仓还支持开启事件触发成功后自动评论。
- 先匹配分支,再匹配路径,都匹配成功,则触发流水线。
- 分支排除优先于分支包含,即目标分支同时在包含和排除中时,匹配失败。
- 路径排除优先于路径包含,即先匹配排除的路径,如果变更文件没有全部在排除范围内,则继续匹配包含的路径。若未配置包含路径,则匹配成功;若配置了包含路径,并且变更文件在路径排除范围外有任意一个在包含范围内,则匹配成功。
- 标签排除优先于标签包含,即标签同时在包含和排除中时,则匹配失败。
配置流水线定时执行
单击定时任务区域的“创建定时任务”,增加一个定时任务,打开“启用定时执行”开关(默认开启),然后设置执行日和执行时间,保存流水线后即可生效,满足条件即可自动触发流水线执行。
最多可以设置10个定时任务。
配置流水线并发策略
默认单条流水线最大执行并发数为5,超过并发数后新的触发忽略不执行。可以通过并发策略为单条流水线配置同时处于运行中和暂停状态的流水线最大实例个数,即并发数,更细粒度地为用户分配并发资源。
打开“并发策略”开关,然后设置并发数和超过并发后执行策略,保存流水线后即可生效。
参数项 |
说明 |
---|---|
并发个数 |
单条流水线最大执行并发数,受套餐和购买并发数限制。 |
超过并发后执行策略 |
超过并发数后可选择如下两种处理方式:
|