Azure DevOps流水线中Docker任务如何使用矩阵运行时变量？

问题根源 #

Azure DevOps流水线在初始化阶段（运行前）就会验证任务中引用的服务连接，而矩阵变量属于运行时变量，在初始化阶段还未被解析。你用$(acrConnection)作为服务连接名称时，系统会直接把字符串$(acrConnection)当成服务连接的名字去查找，自然找不到对应的服务连接，从而报错。

解决方案 #

核心思路是改用编译阶段解析的模板表达式来引用矩阵变量，让服务连接名称在初始化阶段就被替换为实际值，通过系统验证。

正确的YAML示例 #

jobs:
- job: docker
  strategy:
    matrix:
      dev:
        acrConnection: 'dev-acr-service-connection'  # 填写实际的服务连接名称
        imageTag: 'dev-latest'
      prod:
        acrConnection: 'prod-acr-service-connection'
        imageTag: 'prod-latest'
  steps:
  - task: Docker@2
    inputs:
      containerRegistry: ${{ variables.acrConnection }}  # 用模板表达式替换运行时变量
      repository: 'my-app'
      command: 'buildAndPush'
      Dockerfile: '**/Dockerfile'
      tags: |
        $(imageTag)  # 镜像标签用运行时变量没问题，无需提前验证

关键区别说明 #

Azure DevOps有两种变量解析方式，适用场景不同：

• $(variable)：运行时解析，任务执行时才替换变量值，适合不需要提前验证的参数（如镜像标签、文件路径）
• ${{ variables.variable }}：编译阶段解析，流水线初始化时就替换为实际值，适合需要提前验证的资源（如服务连接、代理池）

特殊场景处理 #

如果服务连接名称需要动态生成（无法提前写在矩阵里），可以把Docker构建推送逻辑拆成Azure CLI脚本步骤，通过Azure CLI完成ACR登录、构建和推送：

jobs:
- job: docker
  strategy:
    matrix:
      dev:
        acrName: 'devacr'
        acrConnection: 'dev-acr-service-connection'
        imageTag: 'dev-latest'
      prod:
        acrName: 'prodacr'
        acrConnection: 'prod-acr-service-connection'
        imageTag: 'prod-latest'
  steps:
  - task: AzureCLI@2
    inputs:
      azureSubscription: ${{ variables.acrConnection }}
      scriptType: 'bash'
      inlineScript: |
        az acr login --name $(acrName)
        docker build -t $(acrName).azurecr.io/my-app:$(imageTag) .
        docker push $(acrName).azurecr.io/my-app:$(imageTag)

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