容器与云原生 / 系统课时
使用摘要固定镜像
使用摘要固定镜像
镜像标签适合人阅读,但标签可以被重新指向新的内容。部署要求可复现时,应记录镜像摘要,并在运行或编排配置中使用摘要引用,这样同一份部署配置始终解析到同一镜像内容。
学习目标
- 理解标签与镜像摘要在稳定性上的区别
- 获取镜像的仓库摘要,并用摘要重新拉取镜像
- 在部署配置中固定摘要,并建立可控的升级流程
标签为什么会变化
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 检查实际仓库摘要是否与配置一致。
更新镜像时怎么做
固定摘要以后,镜像不会自动跟随标签更新。正确流程是先在测试环境拉取目标标签,读取新的摘要,完成漏洞扫描与回归验证,再把配置中的旧摘要替换为新摘要并发布。这样每次变化都成为一次显式、可审计的版本升级。
如果只在开发环境追求便利,可以继续使用可变标签;只要进入需要一致部署、回滚或审计的环境,就应优先使用摘要固定实际镜像内容。
按自己的节奏,确认真正理解。