YAML流水线中计数器变量作为构建名称一部分时失效问题

背景 #

在经典流水线中，可通过以下配置实现带版本号和递增计数器的构建编号：

• 生成编号格式：

  $(app.version.number).$(app.version.rv)+$(date:yyyyMMdd)$(rev:.r)
  

• 流水线变量：

  app.version.number = 1.5.0
  app.version.rv = $[counter(variables['app.version.number'], 100)]
  

最终构建运行标题为#1.5.0.1xx+20221007.1 • <团队提交信息>，计数器从100开始递增，符合预期。

但在YAML流水线中尝试复刻该逻辑时，计数器表达式未被计算，直接输出了原始文本（如#7.0.0.$[counter(format('{0}.{1}.{2}', variables['version.major'], variables['version.minor'], variables['version.patch']), 0)]+20231005.1 • ）。

问题原因 #

核心问题在于变量替换的时机冲突：

• ${{ variables.xxx }}是编译时替换，流水线初始化阶段就会解析，此时运行时表达式$[]还未执行，会被直接当作文本保留。
• 之前的写法中，app.fullVersion用${{}}引用version.rv，而version.rv的值是运行时计数器表达式，导致编译时直接把表达式文本插入到了构建编号中。

解决方案 #

方案1：直接在name字段中组合所有逻辑 #

将版本拼接、计数器计算直接放到构建编号的name配置中，利用运行时表达式完成所有计算：

variables:
- name: version.major
  value: 7
- name: version.minor
  value: 0
- name: version.patch
  value: 0
- name: app.baseVersion
  value: '${{ variables.version.major }}.${{ variables.version.minor }}.${{ variables.version.patch }}'

# 构建编号配置
name: '$[format(''{0}.{1}+{2}.{3}'', variables[''app.baseVersion''], counter(variables[''app.baseVersion''], 100), format(''{0:yyyyMMdd}'', pipeline.startTime), rev)]'

方案2：拆分变量+运行时引用 #

先定义运行时计数器变量，再在name中用$(变量名)的运行时引用方式调用：

variables:
- name: version.major
  value: 7
- name: version.minor
  value: 0
- name: version.patch
  value: 0
- name: app.baseVersion
  value: '${{ variables.version.major }}.${{ variables.version.minor }}.${{ variables.version.patch }}'
# 定义运行时计数器变量，基于baseVersion递增
- name: version.rv
  value: $[counter(variables['app.baseVersion'], 100)]

# 构建编号配置，用$(变量名)引用运行时计算后的变量值
name: '$(app.baseVersion).$(version.rv)+$(Date:yyyyMMdd).$(Rev:r)'

验证效果 #

两种方案都会生成类似#7.0.0.100+20231005.1 • <团队提交信息>的构建标题，且每次基于相同app.baseVersion构建时，version.rv会从100开始自动递增（100→101→102...）。

内容的提问来源于stack exchange，提问作者Lupa