Azure DevOps:YAML模板引用中变量在条件判断无法展开如何解决
我有两个基于.yml的Azure DevOps模板,其中一个引用另一个。被引用模板中定义的变量,在引用模板的条件判断中无法正常展开。具体情况如下:
父模板:
jobs: - deployment: displayName: Release variables: - template: variables.yml environment: name: QA resourceType: VirtualMachine strategy: runOnce: deploy: ... #this copies to xxMaster - task: CopyFiles@2 #condition: eq('${{ parameters.appName }}', 'all') condition: and(eq(variables['Build.SourceBranchName'], 'master'), eq('${{ configuration }}', '$(productionConfiguration)')) inputs: SourceFolder: 'C:\DevOps\$(Build.BuildNumber)\Content\D_C\a\1\s\xxTexas\obj\Release\Package\PackageTmp' Contents: '**\*.*' OverWrite: true TargetFolder: 'C:\Production\Web Sites\xxMaster'
子模板(variables.yml):
variables: - name: solution value: '**/*.sln' - name: buildPlatform value: 'Any CPU' - name: buildConfiguration value: "${{ parameters.configuration }}" - name: productionConfiguration value: 'Horsie'
当${{ configuration }}等于'Horsie'时,条件判断应生效,但YAML解析结果为:
and(eq(variables['Build.SourceBranchName'], 'master'), eq('Horsie', '$(productionConfiguration)'))
可见被引用模板中的变量$(productionConfiguration)始终未展开为'Horsie',如何让子模板的变量正常展开,使条件判断生效?
问题核心是Azure DevOps的变量解析时机差异:${{ ... }}属于编译时表达式,会在流水线启动前完成解析;$(...)是运行时变量引用,要等到任务执行阶段才会展开。条件判断中混合使用两种语法时,编译阶段无法解析运行时变量,导致$(productionConfiguration)原样保留。
可以通过以下两种方式解决:
方式一:统一使用编译时表达式引用变量
子模板中的productionConfiguration是固定值,直接用编译时表达式引用该变量:
condition: and(eq(variables['Build.SourceBranchName'], 'master'), eq('${{ configuration }}', '${{ variables.productionConfiguration }}'))
编译阶段会直接将${{ variables.productionConfiguration }}替换为'Horsie',最终条件会被解析为:
and(eq(variables['Build.SourceBranchName'], 'master'), eq('Horsie', 'Horsie'))
方式二:统一使用运行时变量引用
将${{ configuration }}也转为运行时变量引用(前提是configuration参数已传递到子模板的buildConfiguration变量中):
condition: and(eq(variables['Build.SourceBranchName'], 'master'), eq(variables['buildConfiguration'], variables['productionConfiguration']))
这种方式下所有变量都会在运行时展开,适合变量值可能在流水线运行过程中动态变化的场景。
补充说明
如果productionConfiguration是动态生成的运行时变量,只能使用方式二;如果是固定值,方式一更高效,因为编译阶段就能确定条件是否成立,可直接跳过不必要的任务执行。
内容的提问来源于stack exchange,提问作者Gus Mueller

