容器与云原生 / 系统课时
检查镜像详情
检查镜像详情
本课解决“镜像能运行,但不知道它包含什么配置、怎样启动、由哪些层组成”的问题。完成后,你可以读取镜像元数据,提取架构、入口命令和环境变量,并结合层信息与构建历史判断镜像来源。
学习目标
- 使用
docker image inspect查看镜像的完整元数据 - 精确提取架构、入口命令、环境变量和文件系统层
- 使用
docker image history分析镜像构建历史及层大小
查看完整镜像元数据
先确认目标镜像已经存在于本地。下面以 nginx:alpine 为例;如果镜像尚未下载,可先执行 docker pull nginx:alpine。
docker image inspect nginx:alpine预期结果是一个 JSON 数组,每个被检查的镜像对应一个对象。下面只展示关键字段,实际 ID、时间、摘要和环境变量会不同:
[
{
"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 模板只取需要的字段,适合排查平台不匹配或确认容器默认启动方式。
docker image inspect --format '架构={{.Architecture}} 操作系统={{.Os}}' nginx:alpine
docker image inspect --format '入口={{json .Config.Entrypoint}} 命令={{json .Config.Cmd}}' nginx:alpine预期输出如下;<ARCH> 可能是 amd64、arm64 等,取决于本机拉取的平台:
架构=<ARCH> 操作系统=linux
入口=["/docker-entrypoint.sh"] 命令=["nginx","-g","daemon off;"]容器启动时,镜像的 Entrypoint 与 Cmd 会共同参与最终命令组合。运行 docker run 时提供的新命令通常覆盖 Cmd,而 --entrypoint 才会替换 Entrypoint。排查“容器一启动就退出”时,应先确认这两个字段的实际值。
查看环境变量
镜像作者通过 Dockerfile 的 ENV 写入默认环境变量。下面逐行输出镜像配置中的变量:
docker image inspect --format '{{range .Config.Env}}{{println .}}{{end}}' nginx:alpine预期输出会随镜像版本变化,形式如下:
PATH=<PATH>
NGINX_VERSION=<VERSION>
NJS_VERSION=<VERSION>这些值是镜像默认值,运行容器时可以通过 docker run -e 或 Compose 配置覆盖。镜像环境变量不应被视为安全存储,检查结果中可能直接暴露写入镜像的敏感信息。
检查文件系统层
镜像根文件系统由多个只读层按顺序叠加。下面将层摘要输出为 JSON 数组:
docker image inspect --format '{{json .RootFS.Layers}}' nginx:alpine预期输出如下,数组顺序从基础层到后续叠加层,摘要值以实际结果为准:
["sha256:<LAYER_1>","sha256:<LAYER_2>","sha256:<LAYER_3>"]层摘要用于内容寻址和复用。两个镜像出现相同层摘要,表示它们可以共享该层的数据。这里看到的是文件系统差异层,不包含只修改元数据而没有产生文件变化的构建步骤。
查看构建历史
docker image history 从最终镜像向基础镜像回溯,显示每一步的创建命令和该步产生的大小。增加 --no-trunc 可以避免命令被截断。
docker image history --no-trunc nginx:alpine预期输出类似下面的结构,真实层数、命令、时间和大小会随镜像版本变化:
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 不会自动拉取,而是直接返回错误。下面故意检查一个不存在的引用:
docker image inspect missing-image:latest预期输出如下:
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展示构建步骤,但历史行与文件系统层并不保证一一对应。
下一课预告
下一课将继续管理本地镜像,讲解删除指定镜像、处理标签引用冲突,以及在清理前判断镜像是否被容器占用。