拉取新Docker镜像时如何同步移除对应的旧版本镜像

Docker和docker-compose本身没有提供「拉取同仓库新tag镜像时自动删除旧tag镜像」的原生配置，直接在你现有的批量拉取启动脚本里加一段匹配清理逻辑就能实现效果，比全局的镜像清理命令精准度高，不会误删其他镜像。

注意：不要用docker image prune实现这个需求，这个命令默认只会清理无标签的悬空镜像（<none>:<none>），不会清理你打了明确版本号tag的旧镜像，加-a参数也只能删除所有没被容器引用的镜像，很容易误删其他项目用到的镜像。

具体实现逻辑 #

核心思路是新镜像拉取成功后再删旧镜像，绝对不要在拉新前删旧镜像，避免网络波动拉取失败导致服务无镜像可用：

• 第一步：解析当前compose文件中定义的所有镜像地址，拆分出每个镜像的仓库名、待拉取的新版本tag
• 第二步：执行compose拉取命令，确认所有新镜像拉取成功后再进入清理流程，拉取失败直接终止脚本
• 第三步：遍历本地镜像列表，匹配和目标镜像仓库名完全一致的本地镜像，过滤掉刚拉取成功的新版本镜像，剩下的同仓库旧镜像直接删除即可
• 第四步：清理完成后再执行compose应用启动命令

可直接嵌入脚本的代码片段（bash环境） #

# 解析当前目录下docker-compose定义的所有镜像配置，自动处理extends、环境变量替换等场景
COMPOSE_IMAGE_LIST=$(docker compose config | awk '/image:/ {print $2}')

# 批量拉取新镜像，任意镜像拉取失败直接退出，不执行后续清理
docker compose pull || exit 1

for FULL_IMAGE_NAME in $COMPOSE_IMAGE_LIST; do
    # 拆分镜像仓库名和新版本tag
    IMAGE_REPO_PATH=${FULL_IMAGE_NAME%:*}
    NEW_VERSION_TAG=${FULL_IMAGE_NAME#*:}

    # 查询本地所有属于该仓库、且不是刚拉取的新版本的镜像ID
    OLD_VERSION_IMAGE_IDS=$(docker images --format '{{.Repository}}:{{.Tag}} {{.ID}}' \
        | grep "^${IMAGE_REPO_PATH}:" \
        | grep -v ":${NEW_VERSION_TAG} " \
        | awk '{print $2}' \
        | uniq)

    # 存在旧版本镜像则执行删除
    if [ -n "$OLD_VERSION_IMAGE_IDS" ]; then
        echo "清理镜像仓库 ${IMAGE_REPO_PATH} 下的旧版本镜像..."
        docker rmi $OLD_VERSION_IMAGE_IDS
    fi
done

# 清理完成后后台启动compose应用
docker compose up -d

避坑提示 #

• 如果你的主机上跑了多个compose项目，存在共用同仓库不同tag镜像的场景，记得在删除逻辑前加一层校验：先查询所有运行中容器正在使用的镜像ID，把这部分ID从待删除列表里排除，避免把其他项目正在用的镜像删掉
• 不要给docker rmi加-f强制删除参数，正在被运行中容器使用的镜像本来就删不掉，强制删会把镜像的tag去掉变成悬空镜像，反而额外占空间
• 如果你需要保留最近N个版本的旧镜像，只需要在查询旧镜像ID的逻辑里加排序、跳过前N个的处理就行，灵活度很高

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