容器与云原生 / 系统课时
镜像名称与标签规则
镜像名称与标签规则
本课解决镜像引用容易混乱的问题。学完后,你能读懂完整镜像名称,区分标签与摘要,并为开发、测试和生产环境设计清晰、可追踪的版本标记方式。
学习目标
- 掌握镜像引用中仓库地址、命名空间、镜像名和标签的组成
- 理解标签可变、摘要不可变的区别
- 能制定稳定且可追踪的镜像版本策略
完整镜像引用的组成
常见镜像引用可以写成:
text
[registry/][namespace/]repository[:tag][@digest]registry 是镜像仓库地址,省略时通常使用默认仓库;namespace 用于区分组织或用户;repository 是镜像名称;tag 是人为设置的版本别名;digest 是内容摘要。
例如 registry.example.com/payhub/api:1.4.2 表示从指定仓库的 payhub 命名空间中引用 api 镜像,标签为 1.4.2。
标签是可移动的引用
标签本质上是指向某个镜像内容的名称。同一个标签可以在后续发布中改为指向新的镜像,因此只使用 latest 无法保证每次拉取的内容完全相同。
未写标签时,Docker 会使用 latest。它只是默认标签名,不代表该镜像一定最稳定、最新或适合生产环境。
摘要用于锁定内容
摘要通常以 sha256: 开头,由镜像内容计算得到。只要镜像内容发生变化,摘要就会变化,因此使用摘要可以精确锁定一次构建结果。下面拉取镜像并查看仓库摘要。
bash
docker pull alpine:3.20
docker image inspect --format '{{index .RepoDigests 0}}' alpine:3.20预期输出
text
alpine@sha256:<DIGEST><DIGEST> 是实际内容摘要,不同平台或发布时间可能得到不同值。生产部署可以记录标签便于阅读,同时保存摘要用于审计和回滚。
推荐的标签策略
发布版本可采用语义化形式,例如 1.4.2;同时维护 1.4 和 1 等较宽范围标签,供允许自动接收兼容更新的环境使用。
生产环境应优先使用不可变版本号或摘要,避免直接依赖会移动的 latest、stable。测试环境可以使用 dev、test 或提交号,但必须明确这些标签允许被覆盖。
标签命名应统一使用小写字母、数字、点、短横线或下划线,避免把环境、版本、分支和临时说明无规则地堆在同一个标签中。
按自己的节奏,确认真正理解。