Azure DevOps Pipeline推送Docker镜像至ACR报错：无指定前缀标签镜像

核心问题原因 #

你本地构建的镜像标签是appname:latest，但Azure Pipeline的Docker@2推送任务尝试推送的是***/appname:latest（其中***是你的ACR登录服务器地址，格式通常为xxx.azurecr.io）。Docker推送镜像时，要求本地镜像的标签必须与远程仓库的地址完全匹配，否则会提示找不到对应标签的镜像。

Azure的具体要求 #

• 镜像标签必须包含ACR登录服务器前缀：推送到ACR的镜像，标签格式必须为 <ACR登录服务器地址>/<仓库名>:<标签>，例如xxx.azurecr.io/appname:latest。这个前缀用于标识镜像归属的远程仓库，Docker通过它确定要推送到哪个ACR实例。
• Docker@2任务的push命令依赖完整标签：当使用单独的push命令任务时，任务会自动拼接ACR登录服务器地址和你指定的repository、tags参数，形成完整的推送目标，因此本地必须存在对应完整标签的镜像。

解决方法 #

方法1：在自定义构建脚本中添加标签命令 #

在你的.sh构建脚本末尾，添加以下命令（替换为你的ACR登录服务器地址）：

docker tag appname:latest xxx.azurecr.io/appname:latest

执行后，本地会同时保留appname:latest和带ACR前缀的镜像标签，推送任务就能找到对应镜像。

方法2：使用Docker@2的buildAndPush命令（推荐） #

将单独的push任务改为构建推送一体化任务，任务会自动处理标签拼接，无需手动打标签：

- task: Docker@2
  inputs:
    containerRegistry: 'someazureregistry'
    repository: 'appname'
    command: 'buildAndPush'
    Dockerfile: '**/Dockerfile' # 替换为你的Dockerfile实际路径
    tags: 'latest'

方法3：在Pipeline中添加独立标签任务 #

如果必须分开构建和推送步骤，可以在push任务前添加标签脚本，利用Pipeline变量自动获取ACR地址：

- script: |
    docker tag appname:latest $(someazureregistry.loginServer)/appname:latest
  displayName: '为镜像添加ACR前缀标签'

- task: Docker@2
  inputs:
    containerRegistry: 'someazureregistry'
    repository: 'appname'
    command: 'push'
    tags: 'latest'

$(someazureregistry.loginServer)会自动读取你配置的ACR服务连接的登录服务器地址，避免硬编码。

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