容器与云原生 / 系统课时

使用摘要固定镜像

使用摘要固定镜像

镜像标签适合人阅读,但标签可以被重新指向新的内容。部署要求可复现时,应记录镜像摘要,并在运行或编排配置中使用摘要引用,这样同一份部署配置始终解析到同一镜像内容。

学习目标

  • 理解标签与镜像摘要在稳定性上的区别
  • 获取镜像的仓库摘要,并用摘要重新拉取镜像
  • 在部署配置中固定摘要,并建立可控的升级流程

标签为什么会变化

alpine:3.20 这样的标签只是仓库中的可读名称。镜像维护者重新发布同一标签后,标签可能指向新的镜像清单;下一次拉取时得到的内容就可能不同。摘要则是内容寻址标识,常见形式为 sha256:<DIGEST>,只要摘要不变,引用的镜像内容就不会悄悄漂移。

获取并验证摘要

先拉取目标标签,再从本地镜像元数据读取仓库摘要。下面的命令会保存完整的 仓库名@sha256:... 引用,并再次按摘要拉取。

bash
docker pull alpine:3.20
IMAGE_REF="$(docker image inspect --format '{{index .RepoDigests 0}}' alpine:3.20)"
printf '%s\n' "$IMAGE_REF"
docker pull "$IMAGE_REF"

预期输出

text
3.20: Pulling from library/alpine
Digest: sha256:<DIGEST>
Status: <VALUE>
alpine@sha256:<DIGEST>
Digest: sha256:<DIGEST>
Status: <VALUE>

<DIGEST> 与 <VALUE> 会随仓库当前状态和本地缓存不同而变化。关键检查点是打印出的 IMAGE_REF 带有 @sha256:,而第二次拉取使用的也是同一个摘要。

在部署配置中固定摘要

在 Compose、Kubernetes 清单或其他部署系统中,可以把原来的标签引用替换为摘要引用。为了兼顾可读性,通常保留标签并同时附带摘要。

下面是片段示例,<DIGEST> 需要替换成实际得到的摘要:

yaml
services:
  worker:
    image: alpine:3.20@sha256:<DIGEST>
    command: ["sh", "-c", "echo pinned-image"]

这里真正决定镜像内容的是摘要。替换真实摘要后,可运行 docker compose pull worker,再使用 docker image inspect 检查实际仓库摘要是否与配置一致。

更新镜像时怎么做

固定摘要以后,镜像不会自动跟随标签更新。正确流程是先在测试环境拉取目标标签,读取新的摘要,完成漏洞扫描与回归验证,再把配置中的旧摘要替换为新摘要并发布。这样每次变化都成为一次显式、可审计的版本升级。

如果只在开发环境追求便利,可以继续使用可变标签;只要进入需要一致部署、回滚或审计的环境,就应优先使用摘要固定实际镜像内容。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用摘要固定镜像

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

登录哪都通