CI/CD / 系统课时
设计镜像标签
设计镜像标签
镜像标签的目标不是“看起来整齐”,而是让任意一次部署都能反查到版本、源码提交和发布环境。本课给出一套可在 CI 中直接生成的标签规则,并说明为什么不能只依赖 latest、prod 这类浮动标签。
学习目标
- 设计包含版本号、提交哈希和环境标识的可追溯镜像标签。
- 区分不可变发布标签与
latest、prod等浮动别名的职责。 - 在 CI 脚本中生成标签并验证本地镜像引用是否正确。
从追溯需求反推标签结构
镜像仓库路径通常承担“是谁”的信息,标签承担“是哪一次构建”的信息。一个实用格式是 版本号-提交哈希-环境标识,例如 1.8.0-abc1234def56-prod。版本号方便人阅读,提交哈希把制品绑定到源码,环境标识则记录这次发布上下文。
| 标签 | 适合用途 | 是否建议作为唯一部署依据 |
|---|---|---|
1.8.0-abc1234def56-prod |
精确发布与审计 | 是 |
1.8.0 |
对外版本别名 | 否 |
prod |
指向当前生产版本 | 否 |
latest |
本地试用或非关键流程 | 否 |
环境标识不应改变镜像内容。同一份镜像如果从测试晋升到生产,理想做法是复用同一镜像摘要,只新增或移动环境别名;如果团队必须把环境写入不可变标签,也应保证不同环境标签最终指向同一个 digest。
在 CI 中生成并校验标签
下面用公共镜像模拟“CI 已完成构建”的场景,再生成一个完整的目标标签。真实流水线只需把 SOURCE 换成刚构建出的本地镜像名。
set -euo pipefail
REGISTRY="registry.example.com"
NAMESPACE="platform"
APP="demo-app"
VERSION="1.8.0"
GIT_SHA="abc1234def56"
ENVIRONMENT="prod"
SOURCE="busybox:1.36"
TARGET="${REGISTRY}/${NAMESPACE}/${APP}:${VERSION}-${GIT_SHA}-${ENVIRONMENT}"
# 先准备一个本地镜像,再为同一镜像增加可追溯标签。
docker pull "$SOURCE" >/dev/null
docker tag "$SOURCE" "$TARGET"
# 精确检查目标标签已经出现在本地镜像引用中。
docker image inspect --format '{{range .RepoTags}}{{println .}}{{end}}' "$TARGET" | grep -F "$TARGET"预期输出
registry.example.com/platform/demo-app:1.8.0-abc1234def56-prod这里的 docker tag 只新增引用,不会重新构建镜像,因此版本标签、提交标签和环境别名可以指向同一个镜像内容。后续推送时,真正不可变的身份仍应以 registry 返回的 digest 为准。
不要把浮动标签当发布证据
latest、stable、prod 的问题不是不能用,而是它们会移动。昨天的 prod 和今天的 prod 可能指向不同镜像,如果部署记录只保存这个字符串,事故发生后就无法确定当时运行的是哪一份制品。
更稳妥的做法是先生成不可变标签,例如 1.8.0-abc1234def56-prod,完成构建、扫描和验收后,再把 prod 作为便于人和部署系统读取的别名。部署审计同时记录完整镜像引用和 digest,浮动标签只承担“当前指针”的职责。
约束标签生成规则
标签最好由流水线自动生成,而不是让发布人手工输入。提交哈希应来自当前检出的 commit,版本号来自受控的 release 元数据,环境值则限制在固定集合,例如 dev、staging、prod,避免出现大小写、空格和临时拼写差异。
如果一次提交会产出多个平台镜像,不要把 CPU 架构硬塞进业务标签后再分别部署;更常见的做法是让同一标签指向多架构 manifest。无论采用哪种约定,判断标准都一样:看到部署记录时,必须能够稳定地反查到源码、构建制品和发布上下文。