GitLab流水线中Docker :latest标签推送及相关标签机制疑问

问题背景 #

在GitLab构建流水线中执行以下命令：

docker build -t ${CI_REGISTRY_IMAGE}/myimage:latest -t ${CI_REGISTRY_IMAGE}/myimage:$CI_VERSION .
docker push --all-tags ${CI_REGISTRY_IMAGE}/myimage

针对Docker镜像标签机制有以下疑问及解答：

1. latest标签会被多个镜像同时拥有吗？ #

不会。容器仓库会确保只有一个latest标签存在，每次推送带有latest标签的镜像时，仓库会自动取消旧的latest标签与原镜像的关联，将其重新绑定到新推送的镜像上。旧镜像如果还有其他标签（比如你的$CI_VERSION），会继续保留在仓库中，只是不再和latest挂钩；如果旧镜像没有其他标签，后续可能会被仓库的自动清理策略移除。

2. 为什么业内习惯说“推送标签”而非“推送容器镜像”？ #

Docker镜像的核心是分层存储的文件集合，而标签只是镜像唯一ID的别名。当你执行推送操作时：

• 如果仓库中已经存在该镜像的所有分层，那么实际只推送了“标签与镜像ID的绑定关系”；
• 如果仓库缺少部分分层，才会同步缺失的分层，再完成标签绑定。

也就是说，推送操作的核心是传递标签的关联关系，而非整个镜像文件（多数情况下分层已经存在），所以用“推送标签”来表述更准确，也更贴合Docker的底层逻辑。

3. 仅推送单个标签时，镜像只会带有这一个标签吗？ #

这个要分情况：

• 如果本地镜像只有这一个标签，且仓库中没有该镜像的其他标签，那么推送后仓库里的这个镜像就只有你推送的这个标签；
• 如果仓库中原本就有该镜像的其他标签（比如之前推送过latest），那么仓库里的镜像会保留原有标签，同时新增你推送的这个标签；
• 如果你本地镜像有多个标签，但只推送其中一个，仓库只会新增这个标签的关联，不会同步你本地的其他标签到仓库。

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