Azure DevOps步骤模板添加变量组报错‘Unexpected value variables’求解

核心结论 #

纯步骤模板（仅包含steps节点的YAML文件）不支持顶层variables字段，这就是触发Unexpected value 'variables'错误的原因。Azure DevOps的步骤模板仅允许定义parameters和steps，顶层放置variables属于非法语法。

解决方法 #

根据你的使用场景，有三种可行方案：

1. 通过参数传递变量组值

如果模板仅需要变量组中的部分特定值，可在模板里定义参数，主流水线引用变量组后将对应值传入：

步骤模板template.yaml

parameters:
  - name: devSecOpsApiKey
    type: string
  - name: devSecOpsEnv
    type: string

steps:
  - script: echo "API Key: ${{ parameters.devSecOpsApiKey }}"
  - script: echo "Environment: ${{ parameters.devSecOpsEnv }}"

主流水线pipeline.yaml

variables:
  - group: DevSecOps.POC

steps:
  - template: template.yaml
    parameters:
      devSecOpsApiKey: $(ApiKey)
      devSecOpsEnv: $(Environment)

2. 使用扩展模板（extends）复用变量组+步骤

如果需要同时复用变量组和步骤逻辑，改用支持顶层variables的扩展模板：

基础模板base-pipeline.yaml

variables:
  - group: DevSecOps.POC

steps:
  - script: echo "通用步骤1"
  - script: echo "变量组值：$(SomeVariable)"

主流水线pipeline.yaml

extends:
  template: base-pipeline.yaml

# 可添加额外步骤或覆盖配置
steps:
  - script: echo "主流水线自定义步骤"

3. 改用作业级模板

如果你的复用逻辑包含整个作业，作业模板允许在job节点下定义variables：

作业模板job-template.yaml

jobs:
  - job: SecurityScanJob
    variables:
      - group: DevSecOps.POC
    steps:
      - script: echo "执行安全扫描，使用变量：$(ScanToolPath)"

主流水线pipeline.yaml

jobs:
  - template: job-template.yaml

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