Azure DevOps Pipelines each循环中合并模板与传入作业变量问题咨询

解决方案 #

使用Azure DevOps YAML原生的insert指令在variables块内部插入传入作业的变量即可解决结构冲突问题，该写法无需在variables块外层加判断，无论传入作业是否自带变量，模板内置的通用变量都会正常生效。

修正后的完整代码如下：

parameters:
- name: jobs
  type: jobList
  default: []

jobs:
- job: CredScan                       # Cred scan 前置作业
  pool: MyCredScanPool
  steps:
  - task: MyCredScanTask@1
    name: OutputVars # 补充步骤名，避免输出变量引用失效，可根据实际情况修改

- ${{ each job in parameters.jobs }}: # 遍历所有传入的作业
  - ${{ each pair in job }}:          # 插入除dependsOn、variables外的原有作业属性
      ${{ if and(ne(pair.key, 'dependsOn'), ne(pair.key, 'variables')) }}:
        ${{ pair.key }}: ${{ pair.value }}
    dependsOn:                        # 注入依赖关系
    - CredScan
    - ${{ if job.dependsOn }}:            
      - ${{ job.dependsOn }}
    variables:
      # 模板内置通用变量，所有传入作业都会继承
      bar.foo: $[ dependencies.CredScan.outputs['OutputVars.bar.foo'] ]
      # 仅当传入作业自带变量时合并插入
      ${{ if job.variables }}:
        ${{ insert }}: ${{ job.variables }}

原报错原因说明 #

之前的写法报错是因为直接将${{ job.variables }}嵌套在variables块下时，Azure DevOps的YAML解析器无法兼容变量的两种结构（键值对映射、name/value列表结构），会出现结构不匹配的问题。insert指令的作用就是自动将目标变量对象的内容完整展开合并到当前块，不需要手动处理结构适配，不会触发语法错误。

该写法同时兼容两种变量定义格式，无需额外调整逻辑。

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