Azure Pipelines引用模板报Unexpected value 'pool'/'steps'错误如何解决

你在主流水线的stages[*].jobs属性下引用模板，Azure Pipelines要求该位置引入的模板顶层层级必须为jobs数组，不能直接将pool、steps作为模板顶层属性，因此触发属性不匹配的报错。

Azure Pipelines的模板层级完全和引用位置的父层级对齐，对应规则如下：

• 主流水线在stages节点下引用模板 → 模板顶层必须是stages数组
• 主流水线在jobs节点下引用模板 → 模板顶层必须是jobs数组
• 主流水线在steps节点下引用模板 → 模板顶层必须是steps数组

针对你的场景有两种可行配置方案：

方案1：模板封装完整Job（推荐） #

保持主流水线配置不变，修改模板内容，给现有属性套上jobs和job层级：

jobs:
- job: run_custom_task
  pool:
    name: "Azure Pipelines"
    vmImage: "windows-2019"
  steps:
  - task: myTask
    inputs: ...

方案2：模板仅封装Step #

如果你的模板只需要复用步骤逻辑，不需要单独定义Job参数，可以调整主流水线结构，把模板引用放到steps层级下：

主流水线配置： #

trigger:
- master

stages:
- stage: build
  displayName: "Run Build"
  jobs:
  - job: build_job
    pool:
      name: "Azure Pipelines"
      vmImage: "windows-2019"
    steps:
    - template: someTemplate.yml

模板配置： #

- task: myTask
  inputs: ...

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