Azure Pipelines中Docker@2动态设置containerRegistry报错排查

问题原因 #

Docker@2任务的containerRegistry参数属于编译阶段解析项，管道在编译时会验证该服务连接是否存在。而通过##vso[task.setvariable]设置的是运行时变量，编译阶段变量值为空，导致系统无法找到对应服务连接，触发报错。

解决方法 #

方法一：用Bash/Azure CLI直接执行登录（推荐动态场景）

绕过Docker@2任务的服务连接参数限制，直接通过命令行完成ACR登录，支持运行时动态传递ACR名称：

1. 先动态设置ACR名称变量：

- bash: |
    echo "##vso[task.setvariable variable=acr_name;]$ACR"
  displayName: Set dynamic ACR name

2. 使用Azure CLI登录ACR（依赖Azure服务连接访问Azure资源）：

- task: AzureCLI@2
  inputs:
    azureSubscription: '<你的Azure全局服务连接名称>'
    scriptType: 'bash'
    inlineScript: |
      az acr login --name $(acr_name)
  displayName: Login to ACR via Azure CLI

或者直接用docker login命令（需获取ACR凭据）：

- bash: |
    # 获取ACR登录凭据
    ACR_USER=$(az acr credential show --name $(acr_name) --query username -o tsv)
    ACR_PASS=$(az acr credential show --name $(acr_name) --query passwords[0].value -o tsv)
    # 执行docker登录
    echo "$ACR_PASS" | docker login $(acr_name).azurecr.io -u $ACR_USER --password-stdin
  displayName: Login to ACR via docker command

方法二：编译阶段确定服务连接名称（适合固定可选列表场景）

如果服务连接名称可提前确定（如通过管道参数、变量组），可使用编译时变量/参数传递：

1. 用管道参数传递：

parameters:
  - name: acrSvcConnName
    type: string
    default: 'default-acr-service-connection'

steps:
- task: Docker@2
  inputs:
    containerRegistry: '${{ parameters.acrSvcConnName }}'
    command: 'login'
  displayName: Login to ACR

2. 用变量组传递：

variables:
  - group: 'acr-service-connections' # 变量组中预定义acr_svc_conn变量

steps:
- task: Docker@2
  inputs:
    containerRegistry: '${{ variables.acr_svc_conn }}'
    command: 'login'
  displayName: Login to ACR

关键说明 #

• Docker@2任务的containerRegistry参数必须在编译阶段解析，无法直接使用运行时动态变量，因为服务连接的权限验证在编译阶段就已完成。
• 动态场景下优先选择方法一，无需依赖预定义的服务连接名称，完全支持运行时动态切换ACR。

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