容器与云原生 / 系统课时

镜像为什么会越构建越大

镜像为什么会越构建越大

同一个应用反复改 Dockerfile 后,镜像常会从几百 MB 膨胀到数 GB。问题通常不在“构建次数多”,而在基础镜像、依赖、构建产物和层的处理方式。掌握镜像层的累积规则后,就能用 docker history 找到真正占空间的步骤。

学习目标

  • 理解镜像体积由哪些层和文件共同组成
  • 能识别基础镜像、依赖缓存、无用文件和错误分层造成的膨胀
  • 能用 docker history 与构建对比验证瘦身是否有效

镜像大不是因为“构建次数多”

Docker 镜像由只读层叠加而成。重新执行 docker build 不会让同一个镜像无限追加历史构建内容;每次构建得到的是一组新的镜像层,旧镜像如果仍被保留才会继续占宿主机磁盘。

真正决定单个镜像体积的是最终镜像引用的所有层。常见来源包括:

  • 基础镜像本身很大,例如同时包含编译器、包管理器和调试工具的通用发行版。
  • 安装依赖时把下载缓存、软件包索引、临时文件一起留在层里。
  • COPY . . 把源码仓库中的测试数据、构建目录、日志和 .git 一并复制进去。
  • 编译产物之外,还把编译器、SDK、头文件等只在构建期使用的内容留在运行镜像。
  • 文件先在一个层中创建,再在后续层删除。删除只是在新层记录“不可见”,旧层中的文件数据仍然存在。

镜像层中新增与删除文件对最终体积的影响

一个最容易误判的分层案例

下面用随机文件模拟“下载后又删除”的场景。第一个 Dockerfile 把创建和删除拆成两个 RUN,因此大文件已经进入上一层。

dockerfile
FROM alpine:3.20
RUN dd if=/dev/urandom of=/tmp/payload bs=1048576 count=20
RUN rm -f /tmp/payload

第二个版本把临时文件的产生和清理放在同一个 RUN 中。该文件不会出现在这一层最终提交的文件系统结果里。

dockerfile
FROM alpine:3.20
RUN dd if=/dev/urandom of=/tmp/payload bs=1048576 count=20 && rm -f /tmp/payload

分别保存为 Dockerfile.bad 和 Dockerfile.good 后执行:

bash
docker build --quiet -f Dockerfile.bad -t layer-demo:bad .
docker build --quiet -f Dockerfile.good -t layer-demo:good .
bad_size=$(docker image inspect layer-demo:bad --format '{{.Size}}')
good_size=$(docker image inspect layer-demo:good --format '{{.Size}}')
echo "bad=$bad_size good=$good_size"
test "$bad_size" -gt "$good_size" && echo "bad-is-larger"
docker history layer-demo:bad --format '{{.Size}}' | head -n 2

预期输出:

text
sha256:<ID>
sha256:<ID>
bad=<BYTES> good=<BYTES>
bad-is-larger
0B
<ABOUT_20MB>

实际镜像 ID、字节数和压缩后的层大小会不同,但 bad 版本中创建随机文件的层仍会占用明显空间,而后续删除层通常接近 0B。这说明“容器里看不到文件”不等于“镜像层里没有这份数据”。

依赖和构建上下文也会悄悄变大

对于 Debian、Ubuntu 一类基础镜像,安装软件时应避免无必要的推荐包,并在同一层清理包索引。对于语言运行时,也要区分生产依赖和开发依赖。例如生产镜像通常不需要测试框架、编译器和源码。

构建上下文同样值得检查。COPY . . 会复制上下文中的所有未被 .dockerignore 排除的内容。常见排除项包括 .git、日志目录、测试输出、IDE 配置、本地依赖目录和已经生成的构建产物。它们不仅增大镜像,还会让无关文件变化触发缓存失效。

判断镜像变大的顺序

排查时先用 docker image ls 确认是单个镜像变大,还是宿主机上积累了许多旧镜像;再用 docker history 找出体积突增的层。接着回到对应的 FROM、RUN 和 COPY 检查基础镜像、依赖缓存、构建上下文以及临时文件。

如果大量工具只用于编译,而运行时完全不需要,那么继续在单阶段 Dockerfile 里精细清理通常不是最优解。此时应把“构建环境”和“运行环境”拆开,让最终镜像只保留真正运行应用所需的文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

镜像为什么会越构建越大

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

登录哪都通