容器与云原生 / 系统课时

设计镜像版本发布策略

设计镜像版本发布策略

本课解决“镜像发布后如何做到可追踪、可升级、可回滚”的问题。你将建立版本标签、稳定通道和 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 内容也可能暂时存在,但不能把这种行为当作长期保留策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计镜像版本发布策略

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

登录哪都通