容器与云原生 / 系统课时

镜像名称与标签规则

镜像名称与标签规则

本课解决镜像引用容易混乱的问题。学完后,你能读懂完整镜像名称,区分标签与摘要,并为开发、测试和生产环境设计清晰、可追踪的版本标记方式。

学习目标

  • 掌握镜像引用中仓库地址、命名空间、镜像名和标签的组成
  • 理解标签可变、摘要不可变的区别
  • 能制定稳定且可追踪的镜像版本策略

完整镜像引用的组成

常见镜像引用可以写成:

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 或提交号,但必须明确这些标签允许被覆盖。

标签命名应统一使用小写字母、数字、点、短横线或下划线,避免把环境、版本、分支和临时说明无规则地堆在同一个标签中。

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

目录与阅读设置

阅读设置

17

记录一个想法

镜像名称与标签规则

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

登录哪都通