Azure Pipelines YAML继承模板时能否自定义变量？

错误原因 #

你遇到的variables is already defined错误，是因为Azure Pipeline不允许主YAML文件和它通过extends引用的模板文件同时定义顶级的variables块，两者只能有一方直接定义这个块。

可行解决方案 #

可以同时使用模板中的变量和自定义变量，只是需要调整变量的定义方式：

方法一：让模板支持接收自定义变量参数 #

修改你引用的模板pipelines/templates/pipeline-team-test.yaml@templates，添加一个参数来接收自定义变量，然后在模板内部合并原有变量和自定义变量：

# 模板文件内容修改
parameters:
  stagesVersion: ''
  customVariables: {} # 新增参数，用于接收外部传入的自定义变量

variables:
  # 模板原有的变量定义（保留不变）
  template_default_var: 'default_value'
  # 合并自定义变量
  ${{ each kv in parameters.customVariables }}:
    ${{ kv.key }}: ${{ kv.value }}

然后修改你的主YAML，移除顶级variables块，通过extends的参数传递自定义变量：

parameters:
- name: vm
  displayName: Choose a vm
  type: string
  default: vm1
  values:
  - vm1
  - vm2
  - vm3
- name: env # 补充你之前遗漏的env参数定义
  displayName: Target Environment
  type: string
  default: dev
  values:
  - dev
  - test
  - prod

trigger: none

resources:
  repositories:
  - repository: templates
    type: git
    name: team-templates

extends:
  template: pipelines/templates/pipeline-team-test.yaml@templates
  parameters:
    stagesVersion: 2
    customVariables:
      TF_VAR_ENV: ${{ parameters.env }}

方法二：使用变量模板拆分定义 #

把你的自定义变量单独放到一个变量模板文件中（比如variables/terraform-vars.yaml）：

# 自定义变量模板
variables:
  TF_VAR_ENV: ${{ parameters.env }}

然后修改扩展模板，让它支持引入外部变量模板：

# 模板文件内容修改
parameters:
  stagesVersion: ''
  customVarTemplate: '' # 新增参数接收自定义变量模板路径

variables:
  # 模板原有变量
  template_default_var: 'default_value'
  # 引入自定义变量模板（如果传入了路径）
  ${{ if ne(parameters.customVarTemplate, '') }}:
    - template: ${{ parameters.customVarTemplate }}

最后在主YAML中通过参数传递这个模板路径：

parameters:
- name: vm
  displayName: Choose a vm
  type: string
  default: vm1
  values:
  - vm1
  - vm2
  - vm3
- name: env
  displayName: Target Environment
  type: string
  default: dev

trigger: none

resources:
  repositories:
  - repository: templates
    type: git
    name: team-templates

extends:
  template: pipelines/templates/pipeline-team-test.yaml@templates
  parameters:
    stagesVersion: 2
    customVarTemplate: variables/terraform-vars.yaml # 传入自定义变量模板路径

额外注意点 #

你当前的主YAML中引用了parameters.env，但没有定义env参数，这会导致额外的语法错误，记得补上该参数的定义。

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