如何在adf_deploy.yaml中引用TST-Variables.yml变量？变量不存在报错

我尝试将TST-Variables.yml中的变量引入adf_deploy.yaml使用，流水线配置无语法错误，但运行时出现$(azureResourceManagerConnection)不存在的报错。相关配置代码如下：

阶段配置代码 #

- ${{ if in(parameters.Environment, 'Auto', 'Test') }}:
  - stage: DeployTST
    displayName: 'ARM Template deployment on TST environment'   
    jobs:
    - job:
      displayName: 'Deployment steps:'
      variables:
      - template: /pipeline/variables/TST-Variables.yml
      steps:
      - template: /DataFactory/build/adf_deploy.yaml
        parameters:
              Environment: Test

TST-Variables.yml代码 #

variables:

  # Data Factory
  - name: DataFactoryName
    value: dqe01-t-01-adf
  - name: azureResourceManagerConnection
    value: dqe01-t-rg
  - name: resourceGroupName
    value: dqe01-t-rg
(...)

adf_deploy.yaml代码 #

(...)
# Deploy
- task: AzureResourceManagerTemplateDeployment@3
  displayName: 'ARM Template deployment: Resource Group scope'
  inputs:
    azureResourceManagerConnection: $(azureResourceManagerConnection)
    subscriptionId: $(SubscriptionId)
    resourceGroupName: $(resourceGroupName)
    location: 'West Europe'
    csmFile: '$(Build.Repository.LocalPath)/DataFactory/build/ArmTemplate/ARMTemplateForFactory.json'
    csmParametersFile: '$(Build.Repository.LocalPath)/DataFactory/build/ArmTemplate/ARMTemplateParametersForFactory.json'
(...)

可能的原因及修复方法 #

1. 变量模板路径验证 #

检查/pipeline/variables/TST-Variables.yml的路径是否正确：

• 确认路径是从仓库根目录出发的绝对路径，或相对于当前阶段配置文件的相对路径
• 如果阶段配置文件存放在子目录中，需要将路径调整为相对形式（例如../pipeline/variables/TST-Variables.yml）

2. 变量模板语法检查 #

确保TST-Variables.yml完全符合Azure DevOps变量模板规范：

• 顶级节点必须是variables，下方为数组格式的变量定义
• 检查变量名拼写及大小写一致性（Azure DevOps变量名区分大小写）

3. 调整变量作用域 #

将变量模板的引用提升到stage级别，确保作用域覆盖整个stage下的所有job：

- ${{ if in(parameters.Environment, 'Auto', 'Test') }}:
  - stage: DeployTST
    displayName: 'ARM Template deployment on TST environment'
    variables:
    - template: /pipeline/variables/TST-Variables.yml
    jobs:
    - job:
      displayName: 'Deployment steps:'
      steps:
      - template: /DataFactory/build/adf_deploy.yaml
        parameters:
              Environment: Test

4. 验证变量加载状态 #

在adf_deploy.yaml中添加打印变量的步骤，确认变量是否被正确加载：

steps:
- script: |
    echo "azureResourceManagerConnection: $(azureResourceManagerConnection)"
    echo "resourceGroupName: $(resourceGroupName)"
  displayName: 'Print variables'
# 部署任务
- task: AzureResourceManagerTemplateDeployment@3
  ...

5. 检查其他未定义变量 #

同时确认$(SubscriptionId)是否在变量模板或流水线其他位置已定义，避免后续出现同类报错。

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