私有Docker仓库无对应镜像时如何用docker-compose自动构建镜像

Docker Compose 原生没有内置「拉取镜像失败自动触发本地构建」的逻辑，你可以通过组合 Shell 命令+Docker Compose 指令实现需求，具体实现方式如下：

单服务场景实现 #

你现有的 docker-compose 配置无需修改，直接执行如下逻辑即可：

• 先尝试拉取私有仓库中的目标镜像，拉取成功则直接启动服务，不需要重复构建
• 拉取失败则自动触发本地源码构建，构建完成后会自动打上你配置的私有仓库镜像标签

if docker pull private_ecr_repo.amazonecr.com/webapp:latest; then
  docker-compose up -d --no-build
else
  docker-compose up -d --build
fi

如果需要一键执行的简化版本，可以用如下命令：

docker pull private_ecr_repo.amazonecr.com/webapp:latest && docker-compose up -d --no-build || docker-compose up -d --build

多服务场景批量实现 #

如果你的 docker-compose 配置包含多个服务，可以用如下脚本批量判断所有镜像的拉取结果：

# 提取配置中所有服务的镜像地址
IMAGES=$(docker-compose config | grep 'image:' | awk '{print $2}')
PULL_SUCCESS=true
for IMAGE in $IMAGES; do
  if ! docker pull $IMAGE; then
    PULL_SUCCESS=false
  fi
done

if [ "$PULL_SUCCESS" = true ]; then
  # 所有镜像都拉取成功，直接启动
  docker-compose up -d --no-build
else
  # 存在拉取失败的镜像，执行全量构建
  docker-compose up -d --build
fi

你之前测试的参数无法满足需求的原因：

• docker-compose build --pull 只会强制拉取构建过程中用到的基础镜像层，不会判断目标业务镜像是否存在于私有仓库，基础层拉取失败会直接报错
• docker-compose up --no-build 会强制跳过所有构建步骤，本地不存在对应镜像时会直接启动失败

你当前的 docker-compose 配置完全符合要求：同时配置image和build字段时，本地构建生成的镜像会自动打上你指定的私有仓库地址标签，后续需要推送到私有仓库时直接执行docker-compose push即可。

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