容器与云原生 / 系统课时
设计镜像版本发布策略
设计镜像版本发布策略
本课解决“镜像发布后如何做到可追踪、可升级、可回滚”的问题。你将建立版本标签、稳定通道和 Digest 固定规则,避免所有环境都依赖含义模糊的 latest。
学习目标
- 用语义化版本表达兼容性和变更范围
- 区分不可变版本标签与可移动通道标签
- 使用 Digest 固定生产部署内容
建立标签分层
建议把标签分成三类:精确版本、版本通道和环境通道。精确版本如 1.4.2 发布后不再覆盖;版本通道如 1.4、1 可以移动到同系列的新补丁或次版本;stable 可以指向当前推荐版本。
| 标签 | 是否可移动 | 主要用途 |
|---|---|---|
1.4.2 |
否 | 审计、回滚、精确复现 |
1.4 |
是 | 自动获得同一小版本系列的补丁 |
1 |
是 | 自动获得同一主版本的兼容更新 |
stable |
是 | 指向当前推荐发布 |
latest |
可移动但不建议依赖 | 默认体验或临时测试 |
如果存在不兼容变更,应提升主版本;新增向后兼容功能提升次版本;兼容性修复提升补丁版本。镜像标签应与应用版本保持一致,避免同一 1.4.2 被重复覆盖。
一次发布多个标签
下面假设本地已经存在 publish-demo:build,并已登录 Docker Hub。把 <DOCKER_ID> 替换为实际命名空间。
bash
set -euo pipefail
IMAGE='<DOCKER_ID>/publish-demo'
SOURCE='publish-demo:build'
VERSION='1.4.2'
for TAG in "$VERSION" '1.4' '1' 'stable'; do
docker tag "$SOURCE" "$IMAGE:$TAG"
docker push "$IMAGE:$TAG"
done
docker pull "$IMAGE:$VERSION"
docker image inspect "$IMAGE:$VERSION" --format '{{index .RepoDigests 0}}'预期结果
text
四个标签均推送成功。
最后输出 <DOCKER_ID>/publish-demo@sha256:<DIGEST>。推送日志和摘要实际值会不同。脚本中的版本号应由发布流程统一提供,不能从分支名随意推断。
生产部署固定 Digest
测试环境可以跟随 1.4 或 stable,生产环境在验证通过后应记录并部署 Repository@sha256:<DIGEST>。这样即使 stable 后续移动,当前生产实例仍会拉取原来的内容。
回滚时不要重新构建旧代码并复用旧标签,而应直接使用历史发布记录中的 Digest。重新构建可能因为基础镜像、依赖源或构建工具变化而产生不同内容。
发布规则的最小闭环
每次发布至少记录应用版本、Git 提交、构建时间、镜像 Digest 和变更说明。流程应先推送精确版本,完成扫描与测试后再移动 stable 等通道标签。
删除远程标签前要确认没有环境仍在引用。即使标签被删除,只要 Registry 尚未清理对应清单和文件层,Digest 内容也可能暂时存在,但不能把这种行为当作长期保留策略。
按自己的节奏,确认真正理解。