如何在主YAML模板中向阶段模板干净传递运行时变量值？

问题背景 #

需要在主YAML模板运行时设置变量值，再调用阶段YAML模板，但当前实现存在关注点混杂问题：阶段模板不应知晓输入参数以外的内容，主模板也不应了解阶段模板内部的变量名。

当前错误示例及问题 #

主模板 #

stages:
- stage: prepStage
  jobs:
  - job: prepJob
    steps:
    - task: AzurePowerShell@5
      name: MyCheckStep
      inputs:
        azureSubscription: mysubscription
        ScriptType: 'InlineScript'
        Inline: |
          echo "##vso[task.setvariable variable=CheckValue;isOutput=true]MyValue"
        azurePowerShellVersion: 'LatestVersion'
- template: test_template.yaml
  parameters:    
    Environment: $(CheckValueFromPreviousStage)
    Environment2: $[ stageDependencies.prepStage.prepJob.outputs['MyCheckStep.CheckValue'] ]

阶段模板 #

parameters:
- name: Environment
  type: string
- name: Environment2
  type: string

stages:
- stage: MyDecisionStage
  dependsOn: prep
  variables:
    CheckValueFromPreviousStage: $[ stageDependencies.prepStage.prepJob.outputs['MyCheckStep.CheckValue'] ]
  jobs:   
  - job: myJob
    steps:
    - script: |
        echo $(CheckValueFromPreviousStage)
        echo "Environment: ${{ parameters.Environment }}"
        echo "Environment2: ${{ parameters.Environment2 }}"

运行报错信息 #

MyValue
Environment: MyValue
/home/vsts/work/_temp/4570001c-b86b-4f0b-987c-356b70a9c07e.sh: line 3: stageDependencies.prep.prep.outputs['MyCheckStep.CheckValue'] : syntax error: invalid arithmetic operator (error token is ".prepStage.prepJob.outputs['MyCheckStep.CheckValue'] ")

错误原因 #

1. 阶段模板中dependsOn: prep写错，应为prepStage，导致依赖关系失效，变量解析出错
2. ${{ parameters.Environment2 }}是编译时表达式，而stageDependencies是运行时变量，编译时无法解析，直接传入脚本引发语法错误
3. 阶段模板内部定义CheckValueFromPreviousStage变量，导致主模板和阶段模板的关注点混杂

干净的实现方案 #

核心遵循关注点分离原则：主模板负责获取前置阶段的运行时输出，作为参数传递给阶段模板；阶段模板仅处理传入的参数，不依赖任何外部阶段细节。

修改后主模板 #

stages:
- stage: prepStage
  jobs:
  - job: prepJob
    steps:
    - task: AzurePowerShell@5
      name: MyCheckStep
      inputs:
        azureSubscription: mysubscription
        ScriptType: 'InlineScript'
        Inline: |
          echo "##vso[task.setvariable variable=CheckValue;isOutput=true]MyValue"
        azurePowerShellVersion: 'LatestVersion'
- template: test_template.yaml
  parameters:    
    # 主模板用运行时表达式获取前置阶段输出，直接传递给阶段模板参数
    Environment: $[ stageDependencies.prepStage.prepJob.outputs['MyCheckStep.CheckValue'] ]

修改后阶段模板 #

parameters:
- name: Environment
  type: string

stages:
- stage: MyDecisionStage
  # 明确依赖主模板中的前置阶段
  dependsOn: prepStage
  jobs:   
  - job: myJob
    steps:
    - script: |
        echo "Environment: ${{ parameters.Environment }}"

方案优势 #

• 阶段模板仅关注定义好的输入参数，完全不了解主模板的前置阶段结构，符合单一职责
• 主模板只需传递运行时变量值，无需知晓阶段模板内部的变量定义
• 避免了编译时与运行时表达式混用的错误，逻辑清晰易维护

验证结果 #

运行后脚本输出：

Environment: MyValue

内容的提问来源于stack exchange，提问作者Carl in 't Veld