如何创建Azure Pipeline模板使JobList全部在同一代理上运行？

主要问题点 #

• 未命名首个作业且跨作业变量引用错误：捕获代理名称的首个作业未指定name，导致后续作业无法正确引用其输出的agentName变量。跨作业引用输出变量必须采用[作业名].[变量名]格式，同时后续作业需要添加dependsOn依赖首个作业以保证执行顺序。

• Demands循环语法错误：首个作业的demands数组循环写法不符合YAML语法规范，正确的数组元素循环需要将-置于循环项内。

• 硬写Pool名称且未继承参数配置：后续作业的Pool名称硬写为Default，未使用模板参数中的pool配置，导致与首个作业的Pool环境不一致。

• 作业遍历逻辑存在覆盖风险：遍历jobsToRun时直接展开键值对，可能导致原作业的已有配置（如dependsOn、variables等）被意外覆盖或格式错乱。

修正后的模板代码 #

parameters:
  - name: jobsToRun
    type: jobList
  - name: pool
    type: string
    default: Default
  - name: demands
    type: object
    default: []

jobs:
  # 首个作业：捕获当前代理名称并输出为跨作业变量
  - job: CaptureAgentName
    displayName: Capture Agent Name
    steps: 
      - script: echo "##vso[task.setvariable variable=agentName;isOutput=true;]$(Agent.Name)"
        displayName: Capture Agent Name
    pool:
      name: ${{ parameters.pool }}
      demands:
        ${{ each demand in parameters.demands }}:
          - ${{ demand }}

  # 遍历传入的作业列表，强制绑定到同一代理
  - ${{ each job in parameters.jobsToRun }}:
      ${{ job }}
      dependsOn: CaptureAgentName
      pool:
        name: ${{ parameters.pool }}
        demands:
          - Agent.Name -equals $(CaptureAgentName.agentName)

关键修正说明 #

1. 命名首个作业：为捕获代理名称的作业指定name: CaptureAgentName，确保后续作业能精准引用其输出变量。

2. 正确引用跨作业变量：后续作业通过$(CaptureAgentName.agentName)引用首个作业的输出变量，同时添加dependsOn: CaptureAgentName保证作业执行顺序。

3. 修复Demands循环语法：调整首个作业的demands循环为正确的数组元素格式，确保参数中的需求项能被正确解析。

4. 继承Pool参数配置：后续作业的Pool名称使用${{ parameters.pool }}，与首个作业保持一致，避免硬写固定值导致环境不一致。

5. 优化作业遍历逻辑：直接展开${{ job }}保留原作业的所有配置，再追加dependsOn和pool配置，避免覆盖原作业的已有属性。

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