容器与云原生 / 系统课时

拉取指定镜像

拉取指定镜像

拉取镜像时应明确仓库、版本和运行平台,避免省略标签后意外使用 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 正常运行并能访问镜像仓库。

bash
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}}'

预期输出

text
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 用于选择多平台镜像中的目标系统与架构
  • 标签便于升级,摘要适合锁定经过审核的不可变镜像内容

下一课预告

下一课将查看本地镜像列表与详细元数据,学习按仓库、标签和摘要确认镜像是否已正确保存。

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

目录与阅读设置

阅读设置

17

记录一个想法

拉取指定镜像

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

登录哪都通