容器与云原生 / 系统课时
拉取指定镜像
拉取指定镜像
拉取镜像时应明确仓库、版本和运行平台,避免省略标签后意外使用 latest。本课将完成一次指定版本与架构的拉取,并通过检查命令验证本地镜像及其不可变摘要。
学习目标
- 使用标签拉取明确版本的镜像
- 使用
--platform指定操作系统与 CPU 架构 - 通过本地检查结果确认版本、平台和镜像摘要
明确名称、版本与平台
拉取命令的完整形式是 docker image pull [OPTIONS] NAME[:TAG|@DIGEST],也可以使用简写 docker pull。省略标签时 Docker 会默认使用 latest,但 latest 只是普通标签,不代表最新稳定版,也可能被发布者重新指向其他构建。
常见平台值包括 linux/amd64 和 linux/arm64。使用 --platform 可以从多平台镜像中选择目标变体,适合交叉构建、统一部署环境或在不同 CPU 服务器之间保持一致。
拉取并验证镜像
下面拉取 Alpine Linux 3.20 的 linux/amd64 变体,然后检查本地镜像的平台和仓库摘要。执行前应保证 Docker Engine 正常运行并能访问镜像仓库。
docker pull --platform linux/amd64 alpine:3.20
docker image inspect alpine:3.20 --format '{{.Os}}/{{.Architecture}}'
docker image inspect alpine:3.20 --format '{{index .RepoDigests 0}}'预期输出
3.20: Pulling from library/alpine
<IMAGE_LAYER>: Pull complete
Digest: sha256:<DIGEST>
Status: Downloaded newer image for alpine:3.20
docker.io/library/alpine:3.20
linux/amd64
alpine@sha256:<DIGEST><IMAGE_LAYER> 和 <DIGEST> 由仓库实际内容决定,同一标签后续更新时可能变化。若镜像已存在,状态可能显示为已是最新版本,但平台检查仍应输出 linux/amd64。
标签与摘要如何选择
标签便于阅读和升级,例如 alpine:3.20 表示选择 3.20 系列,但发布者可以用同一标签发布修复后的新镜像。因此再次拉取相同标签时,得到的内容可能不同。
摘要形如 alpine@sha256:<DIGEST>,用于锁定一份具体内容,适合要求可重复构建或严格变更控制的环境。摘要固定后不会自动获得安全更新,需要在审核新版本后主动替换摘要。开发环境通常按明确版本标签使用,生产环境可在版本标签之外记录或锁定审核过的摘要。
典型失败处理
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
manifest unknown |
标签不存在或名称写错 | 到仓库标签列表确认精确名称和版本 |
no matching manifest |
目标平台没有对应镜像 | 更换 --platform,或选择支持该架构的标签 |
unauthorized |
私有仓库未认证 | 先执行 docker login <REGISTRY> |
| 拉取超时 | 网络、代理或仓库连接异常 | 检查 Docker daemon 的代理、DNS 和网络连通性 |
从私有仓库拉取时,名称需要包含仓库地址,例如 registry.example.com/team/app:1.2.0。仓库地址不带 https:// 前缀,认证信息由 Docker 登录和凭据配置管理。
本课总结
- 拉取镜像时应明确标签,避免无意使用默认
latest --platform用于选择多平台镜像中的目标系统与架构- 标签便于升级,摘要适合锁定经过审核的不可变镜像内容
下一课预告
下一课将查看本地镜像列表与详细元数据,学习按仓库、标签和摘要确认镜像是否已正确保存。