容器与云原生 / 系统课时
重新标记镜像
重新标记镜像
镜像重新标记并不会复制镜像内容,而是为同一个镜像 ID 增加新的仓库名和版本标签。本课将完成一次可验证的重新标记,并说明标签命名、发布前准备以及删除标签时的边界。
学习目标
- 理解镜像标签与镜像层之间的关系
- 使用
docker image tag添加仓库地址和版本标签 - 验证新旧标签是否指向同一个镜像,并安全移除标签
标签真正改变了什么
Docker 镜像由内容层和配置共同确定,标签只是指向镜像 ID 的可读引用。执行重新标记后,不会重新构建或复制镜像层,因此操作通常瞬间完成,额外磁盘占用也很小。
例如,alpine:3.20 可以同时拥有 registry.example.com/team/alpine:prod 这个新名称。两个名称指向同一镜像,但后者补充了目标仓库、命名空间和发布标签,便于后续推送或区分环境。
添加并验证新标签
下面先拉取镜像,再添加新标签,最后比较两个名称对应的镜像 ID。示例中的仓库地址只用于演示本地标记,不要求该仓库真实可访问。
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"预期输出:
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 的关联。只要同一镜像仍有其他标签引用,镜像层通常不会被删除。
docker image rm registry.example.com/team/alpine:prod预期输出:
Untagged: registry.example.com/team/alpine:prod此时 alpine:3.20 仍然可用。只有最后一个标签被删除,且没有容器依赖该镜像时,相关镜像数据才可能被清理。
常见错误
源镜像名称写错时,命令会报告找不到镜像,因此应先用 docker image ls 核对仓库名和标签。把 tag 当成上传命令也是常见误区:它只创建本地引用,不会连接远程仓库。
重复使用 prod、latest 等可变标签可能导致部署结果难以追溯。更稳妥的做法是先为构建产物添加唯一版本标签,再额外添加环境标签;回滚时仍能准确选择原版本。
本课总结
docker image tag为已有镜像增加名称引用,不会重新构建镜像层- 仓库地址、命名空间、仓库名和标签共同组成发布用镜像引用
- 删除一个标签不等于立即删除镜像,只要还有其他引用,镜像仍然存在
下一课预告
下一课将把一个或多个镜像保存为归档文件,并在无网络的环境中恢复镜像和原有标签。