Azure DevOps YAML管道中extends与variables共存报错问题

问题重现 #

配置Azure DevOps YAML管道时，在template-publish-pipeline.yml中同时定义variables和extends关键字，验证管道时触发错误：

Unexpected value 'extends'

将变量移至main.yml后管道恢复正常。

问题解答 #

1. 是否可以将变量保留在template-publish-pipeline.yml或单独变量模板中？ #

可以，但不能让变量和extends出现在同一个模板文件里。你可以把变量抽成独立的变量模板文件，然后通过以下方式加载：

• 在main.yml中先加载变量模板，再执行extends
• 在被extends引用的目标模板（即somepath/toatemplate@templates）中加载变量模板

2. 有没有办法在模板中同时使用variables和extends？ #

直接在同一个模板里同时用这两个关键字是Azure DevOps YAML的规则限制，无法实现，但有以下几种可行的替代方案：

方案一：将变量移至main.yml加载

调整main.yml，把原本在template-publish-pipeline.yml中的变量定义移过来，同时引入需要的资源仓库：

resources:
  pipelines:
    - pipeline: somepipeline
      source: somesource
      branch: branch
  repositories:
    - repository: templates
      type: git
      name: someorg/repository
      ref: refs/heads/main

parameters:
  - name: debug
    type: boolean
    default: false

variables:
  - group: SomeGroup
  - group: SomeGroup2
  - name: "system.debug"
    value: ${{ parameters.debug }}
  - template: .pipelines/templates/variables/variable-template.yml@templates
  - group: SomeAnotherGroup
  - name: Connection
    value: "Connection Name"

extends:
  template: /.pipelines/template-publish-pipeline.yml@self
  parameters:
    debug: ${{ parameters.debug }}

然后修改template-publish-pipeline.yml，移除variables块，只保留参数、资源和继承逻辑：

resources:
  repositories:
    - repository: templates
      type: git
      name: someorg/repository
      ref: refs/heads/main

parameters:
  - name: "debug"
    type: boolean
    default: false

extends:
  template: somepath/toatemplate@templates
  parameters:
    parameter123:
      enabled: false
    stages:
      - stage: BuildSetup
        jobs:
          - job: BuildNameSetup

方案二：在被继承的基础模板中加载变量

如果有权限修改somepath/toatemplate@templates这个基础模板，可以直接在该模板中添加变量定义，或者通过引用变量模板的方式加载变量。这样template-publish-pipeline.yml只负责传递参数和继承，变量由基础模板统一管理。

方案三：通过参数传递变量（适合少量变量场景）

把需要的变量以参数形式传递给template-publish-pipeline.yml，再由它传递给被继承的基础模板，在基础模板中设置变量。比如：
修改template-publish-pipeline.yml的参数：

parameters:
  - name: "debug"
    type: boolean
    default: false
  - name: "connectionName"
    type: string
    default: "Connection Name"

extends:
  template: somepath/toatemplate@templates
  parameters:
    parameter123:
      enabled: false
    connectionName: ${{ parameters.connectionName }}
    stages:
      - stage: BuildSetup
        jobs:
          - job: BuildNameSetup

然后在基础模板中接收参数并设置变量：

parameters:
  - name: "connectionName"
    type: string

variables:
  - name: Connection
    value: ${{ parameters.connectionName }}
  # 其他变量定义...

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