容器与云原生 / 系统课时

重新标记镜像

重新标记镜像

镜像重新标记并不会复制镜像内容,而是为同一个镜像 ID 增加新的仓库名和版本标签。本课将完成一次可验证的重新标记,并说明标签命名、发布前准备以及删除标签时的边界。

学习目标

  • 理解镜像标签与镜像层之间的关系
  • 使用 docker image tag 添加仓库地址和版本标签
  • 验证新旧标签是否指向同一个镜像,并安全移除标签

标签真正改变了什么

Docker 镜像由内容层和配置共同确定,标签只是指向镜像 ID 的可读引用。执行重新标记后,不会重新构建或复制镜像层,因此操作通常瞬间完成,额外磁盘占用也很小。

例如,alpine:3.20 可以同时拥有 registry.example.com/team/alpine:prod 这个新名称。两个名称指向同一镜像,但后者补充了目标仓库、命名空间和发布标签,便于后续推送或区分环境。

添加并验证新标签

下面先拉取镜像,再添加新标签,最后比较两个名称对应的镜像 ID。示例中的仓库地址只用于演示本地标记,不要求该仓库真实可访问。

bash
docker pull --quiet alpine:3.20 >/dev/null
docker image tag alpine:3.20 registry.example.com/team/alpine:prod

SOURCE_ID=$(docker image inspect --format '{{.Id}}' alpine:3.20)
TARGET_ID=$(docker image inspect --format '{{.Id}}' registry.example.com/team/alpine:prod)

test "$SOURCE_ID" = "$TARGET_ID" && echo "same image"

预期输出:

text
same image

输出表明两个标签解析到同一个镜像 ID。实际镜像 ID 是以 sha256: 开头的长字符串,本示例通过比较结果避免依赖具体值。

读懂标签名称

完整镜像引用通常写成 [仓库地址[:端口]/][命名空间/]仓库名[:标签]。例如 registry.example.com:5000/team/api:1.4.2 中,仓库地址是 registry.example.com:5000,命名空间是 team,仓库名是 api,标签是 1.4.2。

省略标签时 Docker 通常按 latest 解析,但 latest 只是普通标签,并不自动代表最新构建。正式发布更适合使用明确版本,如 1.4.2、20260802 或提交号缩写;环境标签如 test、staging、prod 可以作为附加引用,但不宜替代不可变版本。

重新标记只发生在本机。要让远程仓库拥有该标签,还需要完成仓库登录并执行 docker image push,而且标签中的仓库地址必须与目标仓库一致。

移除不再需要的标签

删除某个标签时,Docker 先解除该名称与镜像 ID 的关联。只要同一镜像仍有其他标签引用,镜像层通常不会被删除。

bash
docker image rm registry.example.com/team/alpine:prod

预期输出:

text
Untagged: registry.example.com/team/alpine:prod

此时 alpine:3.20 仍然可用。只有最后一个标签被删除,且没有容器依赖该镜像时,相关镜像数据才可能被清理。

常见错误

源镜像名称写错时,命令会报告找不到镜像,因此应先用 docker image ls 核对仓库名和标签。把 tag 当成上传命令也是常见误区:它只创建本地引用,不会连接远程仓库。

重复使用 prod、latest 等可变标签可能导致部署结果难以追溯。更稳妥的做法是先为构建产物添加唯一版本标签,再额外添加环境标签;回滚时仍能准确选择原版本。

本课总结

  • docker image tag 为已有镜像增加名称引用,不会重新构建镜像层
  • 仓库地址、命名空间、仓库名和标签共同组成发布用镜像引用
  • 删除一个标签不等于立即删除镜像,只要还有其他引用,镜像仍然存在

下一课预告

下一课将把一个或多个镜像保存为归档文件,并在无网络的环境中恢复镜像和原有标签。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

重新标记镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通