容器与云原生 / 系统课时

检查镜像详情

检查镜像详情

本课解决“镜像能运行,但不知道它包含什么配置、怎样启动、由哪些层组成”的问题。完成后,你可以读取镜像元数据,提取架构、入口命令和环境变量,并结合层信息与构建历史判断镜像来源。

学习目标

  • 使用 docker image inspect 查看镜像的完整元数据
  • 精确提取架构、入口命令、环境变量和文件系统层
  • 使用 docker image history 分析镜像构建历史及层大小

查看完整镜像元数据

先确认目标镜像已经存在于本地。下面以 nginx:alpine 为例;如果镜像尚未下载,可先执行 docker pull nginx:alpine。

bash
docker image inspect nginx:alpine

预期结果是一个 JSON 数组,每个被检查的镜像对应一个对象。下面只展示关键字段,实际 ID、时间、摘要和环境变量会不同:

json
[
  {
    "Id": "sha256:<IMAGE_ID>",
    "RepoTags": ["nginx:alpine"],
    "Architecture": "<ARCH>",
    "Os": "linux",
    "Config": {
      "Env": ["PATH=<PATH>", "NGINX_VERSION=<VERSION>"],
      "Entrypoint": ["/docker-entrypoint.sh"],
      "Cmd": ["nginx", "-g", "daemon off;"]
    },
    "RootFS": {
      "Type": "layers",
      "Layers": ["sha256:<LAYER_1>", "sha256:<LAYER_2>"]
    }
  }
]

Id 是镜像配置对象的内容摘要,RepoTags 是指向它的标签集合。Config 保存容器创建时继承的默认配置,RootFS.Layers 记录组成根文件系统的只读层摘要。

提取架构和启动配置

完整 JSON 信息较多。--format 可以使用 Go 模板只取需要的字段,适合排查平台不匹配或确认容器默认启动方式。

bash
docker image inspect --format '架构={{.Architecture}} 操作系统={{.Os}}' nginx:alpine
docker image inspect --format '入口={{json .Config.Entrypoint}} 命令={{json .Config.Cmd}}' nginx:alpine

预期输出如下;<ARCH> 可能是 amd64、arm64 等,取决于本机拉取的平台:

text
架构=<ARCH> 操作系统=linux
入口=["/docker-entrypoint.sh"] 命令=["nginx","-g","daemon off;"]

容器启动时,镜像的 Entrypoint 与 Cmd 会共同参与最终命令组合。运行 docker run 时提供的新命令通常覆盖 Cmd,而 --entrypoint 才会替换 Entrypoint。排查“容器一启动就退出”时,应先确认这两个字段的实际值。

查看环境变量

镜像作者通过 Dockerfile 的 ENV 写入默认环境变量。下面逐行输出镜像配置中的变量:

bash
docker image inspect --format '{{range .Config.Env}}{{println .}}{{end}}' nginx:alpine

预期输出会随镜像版本变化,形式如下:

text
PATH=<PATH>
NGINX_VERSION=<VERSION>
NJS_VERSION=<VERSION>

这些值是镜像默认值,运行容器时可以通过 docker run -e 或 Compose 配置覆盖。镜像环境变量不应被视为安全存储,检查结果中可能直接暴露写入镜像的敏感信息。

检查文件系统层

镜像根文件系统由多个只读层按顺序叠加。下面将层摘要输出为 JSON 数组:

bash
docker image inspect --format '{{json .RootFS.Layers}}' nginx:alpine

预期输出如下,数组顺序从基础层到后续叠加层,摘要值以实际结果为准:

json
["sha256:<LAYER_1>","sha256:<LAYER_2>","sha256:<LAYER_3>"]

层摘要用于内容寻址和复用。两个镜像出现相同层摘要,表示它们可以共享该层的数据。这里看到的是文件系统差异层,不包含只修改元数据而没有产生文件变化的构建步骤。

查看构建历史

docker image history 从最终镜像向基础镜像回溯,显示每一步的创建命令和该步产生的大小。增加 --no-trunc 可以避免命令被截断。

bash
docker image history --no-trunc nginx:alpine

预期输出类似下面的结构,真实层数、命令、时间和大小会随镜像版本变化:

text
IMAGE          CREATED       CREATED BY                                      SIZE      COMMENT
<IMAGE_ID>     <CREATED>     CMD ["nginx" "-g" "daemon off;"]                0B        buildkit.dockerfile.v0
<missing>      <CREATED>     ENTRYPOINT ["/docker-entrypoint.sh"]            0B        buildkit.dockerfile.v0
<missing>      <CREATED>     RUN /bin/sh -c <BUILD_COMMAND>                  <SIZE>    buildkit.dockerfile.v0

历史记录中的一行不一定对应一个文件系统层。CMD、ENTRYPOINT、ENV 等元数据指令常显示为 0B,而合并构建、BuildKit 优化或导入方式也可能让历史记录与 RootFS.Layers 的数量不同。

处理典型失败

镜像不存在时,inspect 不会自动拉取,而是直接返回错误。下面故意检查一个不存在的引用:

bash
docker image inspect missing-image:latest

预期输出如下:

text
Error response from daemon: No such image: missing-image:latest

先用 docker image ls 核对仓库名和标签,必要时执行 docker pull <IMAGE>。如果 Go 模板字段写错,命令会返回模板求值错误;此时先查看完整 JSON,确认字段路径和大小写,再修改 --format 表达式。

本课总结

  • docker image inspect 返回镜像配置、平台、标签和根文件系统层等完整元数据。
  • --format 适合精确提取 Architecture、Config 和 RootFS 字段,减少人工浏览大型 JSON。
  • docker image history 展示构建步骤,但历史行与文件系统层并不保证一一对应。

下一课预告

下一课将继续管理本地镜像,讲解删除指定镜像、处理标签引用冲突,以及在清理前判断镜像是否被容器占用。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查镜像详情

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

登录哪都通