在Azure Pipelines条件中访问变量组遇判断异常问题

管道定义 #

trigger:
  batch: true

resources:
  repositories:
  - repository: templates
    type: git
    ref: refs/heads/master
    name: my-template

variables:
- group: deployment-branches

extends:
  template: my-template.yml@templates
  parameters:
    ${{ if ne(variables['Build.Reason'], 'PullRequest') }}:
      deploy_stages:
      - ${{ if eq(variables['Build.SourceBranch'], variables['dev']) }}:
          - dev
      - ${{ if startsWith(variables['Build.SourceBranch'], variables['test']) }}:
          - test

变量库配置 #

dev: refs/heads/branch-1
test: refs/heads/branch-1

问题现象 #

当构建分支为refs/heads/branch-1时，eq(variables['Build.SourceBranch'], variables['dev'])判断始终返回false，但startsWith(variables['Build.SourceBranch'], variables['test'])始终返回true，怀疑变量组中的dev和test变量值为空。

原因分析 #

Azure DevOps的模板表达式（${{ ... }}）属于编译时执行的逻辑，而变量组中的变量默认是运行时变量，编译阶段还无法读取到变量组的实际值，此时直接引用variables['dev']或variables['test']会得到空字符串。

对于startsWith函数，当第二个参数为空时，任何字符串都会匹配成功，所以返回true；而eq判断中，Build.SourceBranch的有效值和空字符串对比自然返回false。

解决方案 #

方案1：将变量组变量转为编译时可用变量 #

在variables块中显式声明编译时变量，通过运行时表达式$[variables.dev]获取变量组的值并赋值，这样编译阶段就能读取到变量内容：

variables:
- group: deployment-branches
- name: dev_compile
  value: $[variables.dev]
- name: test_compile
  value: $[variables.test]

extends:
  template: my-template.yml@templates
  parameters:
    ${{ if ne(variables['Build.Reason'], 'PullRequest') }}:
      deploy_stages:
      - ${{ if eq(variables['Build.SourceBranch'], variables.dev_compile) }}:
          - dev
      - ${{ if startsWith(variables['Build.SourceBranch'], variables.test_compile) }}:
          - test

方案2：硬编码分支值（适合固定分支场景） #

如果分支名称不常变更，可直接将分支路径硬编码到模板表达式中，跳过变量组的读取问题：

extends:
  template: my-template.yml@templates
  parameters:
    ${{ if ne(variables['Build.Reason'], 'PullRequest') }}:
      deploy_stages:
      - ${{ if eq(variables['Build.SourceBranch'], 'refs/heads/branch-1') }}:
          - dev
      - ${{ if startsWith(variables['Build.SourceBranch'], 'refs/heads/branch-1') }}:
          - test

方案3：改用运行时条件判断 #

将判断逻辑移到阶段或任务的condition中，condition属于运行时执行逻辑，可以直接读取变量组的变量：

# 在my-template.yml中调整阶段定义
stages:
- stage: Dev
  condition: and(ne(variables['Build.Reason'], 'PullRequest'), eq(variables['Build.SourceBranch'], variables['dev']))
  jobs:
  - job: DeployDev
    steps:
    - script: echo 部署到dev环境
- stage: Test
  condition: and(ne(variables['Build.Reason'], 'PullRequest'), startsWith(variables['Build.SourceBranch'], variables['test']))
  jobs:
  - job: DeployTest
    steps:
    - script: echo 部署到test环境

内容的提问来源于stack exchange，提问作者stefan.stt