容器与云原生 / 系统课时

怎样查看镜像到底大在哪里

怎样查看镜像到底大在哪里

镜像突然从几百 MB 涨到几个 GB 时,先别急着改基础镜像。更有效的做法是把镜像总大小与构建历史对上,找到异常的大层,再回到对应 Dockerfile 指令判断是依赖、缓存、复制范围还是“删得太晚”导致膨胀。

学习目标

  • 会用 docker image inspect 与 docker history 查看镜像总大小和各层大小。
  • 能把异常层对应回 Dockerfile 指令,判断常见膨胀原因。
  • 理解为什么在后续层删除文件,通常不能让前一层真正变小。

先确认是整个镜像变大,还是某一层异常

docker image inspect 适合确认镜像整体大小,docker history 则把镜像按构建层展开。排查时先看总量,再从最大的层开始追踪,比逐条猜 Dockerfile 更快。

假设本地已有镜像 demo-app:latest,执行:

bash
docker image inspect demo-app:latest --format '{{.Size}}'
docker history --no-trunc --human --format '{{.Size}}  {{.CreatedBy}}' demo-app:latest

预期输出:

text
<TOTAL_BYTES>
0B      CMD ["./app"]
<SMALL_SIZE>     COPY ./app /app
<LARGE_SIZE>     RUN /bin/sh -c <COMMAND>
<BASE_LAYER_SIZE>     <BASE_IMAGE_COMMAND>

<TOTAL_BYTES>、各层大小以及创建指令会随镜像内容和 Docker 版本变化。真正需要关注的是体积明显高于预期的层,以及这一层的 CreatedBy 是否能对应到某条 RUN、COPY 或 ADD 指令。

把异常层对应回 Dockerfile

最常见的异常来源通常有三类。COPY . . 可能把构建产物、依赖目录或日志一起带入;包管理器安装后没有在同一层清理缓存;编译产物和源码都被留在最终镜像。

例如下面这个片段示例依赖 Debian/Ubuntu 系基础镜像。安装和清理被拆成两层:

dockerfile
RUN apt-get update && apt-get install -y curl
RUN rm -rf /var/lib/apt/lists/*

第二条 RUN 虽然让最终文件系统视图里看不到缓存,但第一层已经保存了那些文件,后续层的删除只是记录“这些路径被删除”,不会重写前一层。

更合理的写法是在同一层完成安装与清理:

dockerfile
RUN apt-get update \
    && apt-get install -y --no-install-recommends curl \
    && rm -rf /var/lib/apt/lists/*

这段配置的生效行为是:缓存不会进入该层的最终快照。重新构建镜像后,再用前面的 docker history 检查对应 RUN 层是否缩小。

为什么删除文件不一定能瘦身

Docker 镜像由只读层叠加而成。前一层写入一个 500 MB 文件,后一层再删除它,容器看到的最终文件系统里确实没有这个文件,但前一层的数据仍属于镜像内容,因此镜像体积不会回到删除前。

继续定位时看什么

如果最大的层来自 COPY,优先检查构建上下文和 .dockerignore,确认没有把 node_modules、target、.git、测试数据或本地日志等无关内容送进镜像。若大层来自编译命令,则重点确认编译工具链、缓存和中间产物是否被带入最终阶段。

还要注意,docker history 展示的是单个镜像的层历史,不等同于 Docker 主机上的真实磁盘占用。多个镜像可能共享底层层,主机总体占用应另看镜像、容器、构建缓存和卷各自的使用情况。排查镜像“为什么变大”时,先用历史定位层;排查主机“为什么磁盘满”时,则要把问题扩大到整个 Docker 存储。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样查看镜像到底大在哪里

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

登录哪都通