容器与云原生 / 系统课时

生产环境为什么要固定镜像版本

生产环境为什么要固定镜像版本

生产部署最怕“Compose 文件没变,拉到的镜像却变了”。要让回滚、审计和多节点部署可重复,镜像引用必须足够明确;版本标签能降低漂移风险,Digest 则能把镜像内容直接锁定。

学习目标

  • 解释 latest 或可移动标签为什么会破坏可重复部署。
  • 区分明确版本标签与 Digest 的确定性差异。
  • 在 Compose 中使用固定镜像引用,并建立可控的升级流程。

同一个标签为什么会产生漂移

镜像标签本质上是仓库中指向某个镜像内容的名字。维护者可以把同一个标签重新指向新的内容,因此今天拉取的 app:stable 与以后拉取的 app:stable 不一定相同。latest 也只是普通标签,并不自动代表经过验证的安全版本。

生产环境一旦依赖这种可移动引用,重新部署、扩容新节点或灾难恢复时都可能拿到不同镜像。配置文件看起来没有变化,但实际运行的二进制、依赖和基础系统已经改变,问题也更难复现。

版本标签和 Digest 的确定性

写法 可读性 是否可能被重新指向 生产使用特点
app:latest 高 是 难以复现,不推荐
app:1.8 高 是 范围明确一些,但仍可能漂移
app:1.8.4 高 取决于仓库是否允许覆盖标签 常用于明确发布版本
app@sha256:<DIGEST> 较低 否 内容确定性最高

明确补丁版本能让发布意图更清楚,但标签本身仍是仓库中的可变引用。Digest 是内容寻址标识,因此需要严格复现时,可以同时记录人类可读的版本号和部署所使用的 Digest。

获取并使用 Digest

下面以 alpine:3.20 为例,先确保镜像已经拉取,再读取仓库记录的 Digest。Digest 的具体值取决于实际镜像内容,因此用 <DIGEST> 表示运行时得到的值。

bash
docker pull alpine:3.20 >/dev/null 2>&1
docker image inspect --format '{{index .RepoDigests 0}}' alpine:3.20

预期输出

text
alpine@sha256:<DIGEST>

拿到真实 Digest 后,可以把生产 Compose 中的镜像引用固定下来。下面是片段示例,必须把 <DIGEST> 替换为上一条命令得到的真实值。

yaml
services:
  app:
    image: alpine@sha256:<DIGEST>
    command: ['sh', '-c', 'echo production-image && sleep 3600']

保存配置后应检查 Compose 最终解析出的 image 字段,确认它仍然是预期 Digest,没有被环境变量或其他覆盖配置重新替换为可移动标签。

在发布流程里锁定镜像

生产发布应把“构建镜像”和“选择部署镜像”分开。镜像构建并推送完成后,先记录仓库返回的 Digest,再让部署配置引用这个 Digest。即使仓库里的版本标签后来改变,已经发布的配置仍然指向原来的镜像内容。

同样,不应把“重新拉取标签”当成自动升级方案。拉取动作只负责取得当前引用指向的内容,版本变化应当对应一次明确的发布变更,并经过测试、审核和回滚准备。

更新版本时怎么做

升级镜像时,应生成新的版本引用或取得新的 Digest,并把 Compose 中的引用修改作为一次可审计的配置变更。部署前验证新镜像,部署后保留上一个 Digest,出现问题时才能准确回到此前运行的内容。

固定版本的核心不是拒绝升级,而是让每次升级都成为显式事件。这样同一份生产配置在不同时间和不同节点上仍能解析到预期镜像,部署与回滚才具备可重复性。

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

目录与阅读设置

阅读设置

17

记录一个想法

生产环境为什么要固定镜像版本

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

登录哪都通