配置流水线执行条件表达式

更新时间：2024-12-27 GMT+08:00

查看PDF

在流水线阶段任务的执行条件中通过表达式引用流水线上下文，用以限制任务执行。表达式由流水线上下文、操作符、函数或常量组合而成，表达式以编程的方式访问流水线上下文，实现将流水线中运行的实例、变量、任务等信息在流水线之间互相传递。

操作符

表达式中可以使用如下操作符：

表1 操作符
操作符	说明
.	属性引用。如：${{ pipeline.trigger_type }}，表示获取流水线的触发类型。
!	非。如：${{ !startsWith(sources.my_repo.target_branch, 'release') }}，表示判断流水线代码源的分支是否不以release开头。
==	等于。如：${{ pipeline.trigger_type == 'Manual' }}，表示判断流水线的触发方式是否为手动触发。
!=	不等于。如：${{ pipeline.trigger_type != 'Manual' }}，表示判断流水线的触发方式是否不为手动触发。
&&	且。如：${{ pipeline.trigger_type == 'Manual' && sources.my_repo.target_branch == 'master' }}，表示判断流水线的触发方式为手动触发并且流水线代码源的分支为master。
\|\|	或。如：${{ pipeline.trigger_type == 'Manual' \|\| sources.my_repo.target_branch == 'master' }}，表示判断流水线的触发方式为手动触发或者流水线代码源的分支为master。

函数

表达式中可使用如下内置函数：

表2 内置函数
函数	说明
contains	格式 contains(search, item) 含义如果“search”包含“item”，则函数返回“true”。如果“search”是一个数组，那么如果“item”是数组中的一个元素，则此函数返回“true”。如果“search”是一个字符串，那么如果“item”是“search”的子字符串，则函数返回“true”。示例 contains('abc', 'bc') ，函数将返回“true”。
startsWith	格式 startsWith(searchString, searchValue) 含义如果“searchString ”以“searchValue”开始，则函数返回“true ”。示例 startsWith('abc', 'ab')，函数将返回“true”。
endsWith	格式 endsWith(searchString, searchValue) 含义如果“searchString”以“searchValue”结束，则函数返回“true”。示例 endsWith('abc', 'bc')，函数将返回“true”。
对象筛选器	使用“”语法应用筛选器并选择集合中的匹配项。示例：如下是流水线某次运行的jobs上下文 { "check_job": { "status": "COMPLETED", "metrics": { "critical": "0", "major": "0" } }, "demo_job": { "status": "FAILED" } } 示例1：“jobs..status”，表示所有任务的状态，所以返回“[ 'COMPLETED', 'FAILED' ]”。示例2：结合contains函数一起使用，如：contains(jobs..status, 'FAILED')，“jobs..status”中包含“FAILED”，所以返回“true”。

父主题： 流水线上下文

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

7*24