如何基于Azure DevOps运行时变量动态生成流水线步骤？

我尝试在Azure DevOps流水线里利用前一阶段生成的运行时变量动态创建任务步骤，参考官方文档修改后编写了流水线代码，但Stage B1中displayName: Printing ${{ var }}步骤报错：

/home/vsts/work/_temp/11476078-561a-41c8-8177-9d27a9bf3f81.sh: line 1: stageDependencies.A.A1.outputs['MyOutputVar.myStageVal']: syntax error: invalid arithmetic operator (error token is ".A.A1.outputs['MyOutputVar.myStageVal']")

核心问题是模板表达式${{ }}无法处理运行时定义的变量myStageVal，想知道如何基于运行时变量实现动态步骤创建。

原流水线代码：

name: Playground
trigger: none

pool:
  vmImage: ubuntu-latest

variables:
  - group: main
  - name: System.Debug
    value: true

stages:
  - stage: A
    jobs:
    - job: A1
      steps:
      # 获取提交变更路径，拼接成逗号分隔的字符串并输出为变量
      - script: |
              result=$(curl --location 'https://dev.azure.com/$(org)/$(System.TeamProject)/_apis/git/repositories/$(Build.Repository.Name)/commits/$(Build.SourceVersion)/changes?api-version=5.0' \
                --header 'Authorization: Basic $(PAT_base64)' \
                | jq '.changes[].item.path' \
                | tr '\n' ',')
              echo $result
              echo "##vso[task.setvariable variable=myStageVal;isOutput=true]$result"
        name: MyOutputVar

  - stage: B
    dependsOn: A
    jobs:
    - job: B1
      variables:
        myStageAVar: $[stageDependencies.A.A1.outputs['MyOutputVar.myStageVal']]
      
      steps:
        # 变量值可正常输出
        - bash: echo $(myStageAVar)

        # 尝试基于变量动态生成步骤失败
        - ${{ each var in split(variables.myStageAVar, ',') }}:
          - script: |
              echo ${{ var }}
            displayName: Printing ${{ var }}

原因分析 #

Azure DevOps的模板表达式${{ }}是编译时执行的，会在流水线启动前完成解析；而通过##vso[task.setvariable]设置的输出变量属于运行时变量，只有在流水线运行过程中才会生成实际值。

用${{ split(variables.myStageAVar, ',') }}写法时，编译阶段myStageAVar还未被赋值，会直接把stageDependencies.A.A1.outputs['MyOutputVar.myStageVal']作为原始字符串传入split函数，最终导致执行时出现语法错误。

解决方案 #

要基于运行时变量动态创建步骤，需要通过运行时生成YAML步骤文件的方式实现，具体步骤如下：

1. 在Stage B1中先将运行时变量的值解析并写入临时YAML文件；
2. 使用template参数引用这个临时YAML文件，实现动态加载步骤。

修改后的流水线代码 #

name: Playground
trigger: none

pool:
  vmImage: ubuntu-latest

variables:
  - group: main
  - name: System.Debug
    value: true

stages:
  - stage: A
    jobs:
    - job: A1
      steps:
      # 获取提交变更路径，拼接成逗号分隔的字符串并输出为变量（移除末尾多余逗号）
      - script: |
              result=$(curl --location 'https://dev.azure.com/$(org)/$(System.TeamProject)/_apis/git/repositories/$(Build.Repository.Name)/commits/$(Build.SourceVersion)/changes?api-version=5.0' \
                --header 'Authorization: Basic $(PAT_base64)' \
                | jq '.changes[].item.path' \
                | tr '\n' ',')
              # 移除末尾多余的逗号，避免生成空步骤
              result=${result%,}
              echo $result
              echo "##vso[task.setvariable variable=myStageVal;isOutput=true]$result"
        name: MyOutputVar

  - stage: B
    dependsOn: A
    jobs:
    - job: B1
      variables:
        myStageAVar: $[stageDependencies.A.A1.outputs['MyOutputVar.myStageVal']]
      
      steps:
        # 验证变量值正常输出
        - bash: echo $(myStageAVar)

        # 动态生成YAML步骤文件
        - bash: |
            # 将逗号分隔的字符串转为数组
            IFS=',' read -r -a paths <<< "$(myStageAVar)"
            # 初始化步骤文件
            echo "steps:" > dynamic-steps.yml
            # 循环生成每个步骤
            for path in "${paths[@]}"; do
              # 处理路径中的特殊字符，用单引号包裹避免语法错误
              escaped_path=$(echo "$path" | sed "s/'/'\\\''/g")
              echo "  - script: echo '$escaped_path'" >> dynamic-steps.yml
              echo "    displayName: Printing $path" >> dynamic-steps.yml
            done
            # 打印生成的文件内容用于调试
            cat dynamic-steps.yml

        # 引用动态生成的步骤文件
        - template: dynamic-steps.yml

注意事项 #

• 生成YAML文件时要保证格式正确，比如缩进统一为2个空格；
• 如果路径包含空格、单引号等特殊字符，需要做转义处理，避免脚本执行报错；
• 原代码中获取的result末尾会多一个逗号，需用${result%,}移除，防止生成空的步骤；
• 动态生成的YAML文件要放在流水线工作目录下，确保template能正确引用。

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