Azure DevOps构建Docker镜像后本地使用失败求助

问题分析 #

你在Azure Pipeline中构建了本地Docker镜像my_image，但执行docker run时系统会忽略本地镜像，转而尝试从docker.io、quay.io等公共仓库拉取，导致权限拒绝或404错误。核心原因是未指定仓库前缀的镜像名会触发Docker的公共仓库搜索逻辑，加上你使用的Docker版本较老旧，存在镜像查找优先级的兼容性问题，即使本地已存在同名镜像，仍会优先尝试远程拉取。

解决方案 #

1. 给镜像添加本地仓库前缀 #

构建镜像时，给tag加上localhost/前缀，强制Docker将其识别为本地镜像，彻底避免触发远程拉取逻辑：

docker build -t localhost/my_image:latest -f path/to/Dockerfile .

运行镜像时使用相同的带前缀名称：

docker run -t localhost/my_image:latest <some_build_command>

2. 升级Docker版本 #

你当前使用的Docker 17.09.0-ce版本过于老旧，存在镜像查找逻辑的bug，建议升级到最新稳定版（比如24.0.6）：

- task: DockerInstaller@0
  displayName: Docker Installer
  inputs:
    dockerVersion: '24.0.6'
    releaseType: stable

3. 调整docker run的交互参数 #

Pipeline属于无头非交互式环境，docker run中的-i参数会导致交互输入异常，建议去掉-i，保留-t维持终端输出即可：

docker run -t localhost/my_image:latest <some_build_command>

修改后的完整Pipeline配置 #

steps:
    - checkout: self
      clean: true

- task: DockerInstaller@0
  displayName: Docker Installer
  inputs:
    dockerVersion: '24.0.6'
    releaseType: stable

- bash: |
    docker build -t localhost/my_image:latest -f path/to/Dockerfile .
    docker images
  displayName: "Build docker image"

- bash: |
    docker run -t localhost/my_image:latest <some_build_command>
  displayName: "Build application"

验证说明 #

在构建镜像的步骤中添加docker images命令，可以在Pipeline日志中直接确认本地镜像的tag和存在状态，方便后续快速排查问题。

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