如何创建可复用的ADO Pipeline资源模板？解决extends与stages冲突

问题出在extends的使用逻辑：当用extends引入模板时，主YAML文件不能同时存在顶层的stages、jobs等节点——extends会将模板内容作为Pipeline的基础结构，主文件只能补充模板未定义的部分，若模板已包含resources，主文件再写stages就会触发解析冲突。

以下是三种可行的解决办法：

方案1：引用资源片段模板（推荐） #

将资源配置拆分为可复用的片段，直接在主文件的resources.pipelines下引用模板，既保留主文件的自定义stages，又实现资源配置的统一复用。

1. 调整资源模板Templates/_Shared/resource-template.yml，仅保留Pipeline资源定义：

- pipeline: test
  project: Project
  source: test
  version: 1.3.0

2. 主Pipeline文件test.yml中，在resources.pipelines节点引用该模板：

trigger: none

resources:
  pipelines:
    - template: Templates/_Shared/resource-template.yml

stages:
  - stage: Validation
    jobs:
      - job: Validation
        steps:
          - script: echo "Validating"

后续只需更新资源模板中的version值，所有引用该模板的Pipeline都会自动同步资源版本。

方案2：用变量模板统一管理版本号 #

若仅需统一管理资源的版本号，可将版本号存入变量模板，主文件引用变量后自行定义资源结构。

1. 创建变量模板Templates/_Shared/version-variables.yml：

variables:
  - name: TestPipelineVersion
    value: 1.3.0

2. 主Pipeline文件中引用变量并定义资源：

trigger: none

variables:
  - template: Templates/_Shared/version-variables.yml

resources:
  pipelines:
    - pipeline: test
      project: Project
      source: test
      version: $(TestPipelineVersion)

stages:
  - stage: Validation
    jobs:
      - job: Validation
        steps:
          - script: echo "Validating"

后续更新变量模板中的版本值即可同步所有主Pipeline的资源版本。

方案3：参数化基础模板（包含资源+自定义Stages） #

将资源配置和Pipeline基础结构做成参数化模板，主文件通过参数传入自定义的stages。

1. 创建基础模板Templates/_Shared/pipeline-base-template.yml：

parameters:
  stages: []

resources:
  pipelines:
    - pipeline: test
      project: Project
      source: test
      version: 1.3.0

stages: ${{ parameters.stages }}

2. 主Pipeline文件通过extends传入自定义stages：

trigger: none

extends:
  template: Templates/_Shared/pipeline-base-template.yml
  parameters:
    stages:
      - stage: Validation
        jobs:
          - job: Validation
            steps:
              - script: echo "Validating"

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