容器与云原生 / 系统课时
为镜像添加标签
为镜像添加标签
本课解决“如何给同一个镜像增加新名称或版本号”的问题。学完后,你能使用 docker tag 创建新的镜像引用,验证多个标签是否指向同一镜像,并避免把标签误解为镜像副本。
学习目标
- 使用
docker tag为现有镜像创建新引用 - 验证不同标签是否指向同一个镜像 ID
- 建立清晰、稳定的版本标签规范
标签不会复制镜像数据
docker tag 源镜像 目标镜像 只会创建一个新的名称引用,不会复制镜像层。多个标签可以同时指向同一个镜像 ID,因此增加标签通常几乎不增加磁盘占用。
目标名称可以包含仓库地址、命名空间、镜像名和标签。为远程推送准备标签时,目标名称必须与实际仓库路径一致。
创建并验证新标签
下面把 alpine:3.20 标记为一个内部项目镜像版本。
bash
docker pull alpine:3.20
docker tag alpine:3.20 registry.example.com/team/alpine-demo:1.0.0
docker image ls --format '{{.Repository}}:{{.Tag}} | {{.ID}}' alpine
docker image ls --format '{{.Repository}}:{{.Tag}} | {{.ID}}' registry.example.com/team/alpine-demo预期输出:
text
alpine:3.20 | <IMAGE_ID>
registry.example.com/team/alpine-demo:1.0.0 | <IMAGE_ID>两行中的 <IMAGE_ID> 应相同,说明新标签和原标签指向同一份镜像内容。registry.example.com 仅为示例仓库地址,实际使用时应替换为真实可访问的仓库。
设计稳定的标签规则
正式发布建议使用不可重复覆盖的精确版本,例如 1.0.0、构建号或提交哈希。环境标签如 test、staging、prod 可以保留,但应明确它们会随着部署移动。
不要只维护 latest。更稳妥的做法是同时发布精确版本和便捷别名,例如让 1.0.0 保持不变,让 1.0 指向该系列当前版本。
删除标签时的影响
执行 docker image rm 仓库名:标签 通常只删除该引用。只要还有其他标签或容器引用相同镜像,底层镜像数据就不会被清理。
因此,清理镜像前应先查看所有引用,避免误以为删除一个标签等同于删除全部镜像内容。
按自己的节奏,确认真正理解。