容器与云原生 / 系统课时

.dockerignore 有什么作用

.dockerignore 有什么作用

Docker 构建时会读取一个构建上下文,目录里的无关文件如果一起进入上下文,会拖慢传输、扩大缓存失效范围,还可能把本地日志或敏感临时文件带进镜像构建过程。.dockerignore 的作用,就是在上下文送给构建器之前先做过滤。

学习目标

  • 理解 .dockerignore 过滤的是构建上下文而不是运行中容器
  • 能排除日志、Git 目录、缓存和本地临时文件
  • 能验证忽略规则是否误伤构建所需文件

它过滤的是构建上下文

执行 docker build . 时,最后的 . 表示构建上下文目录。Docker 会根据 .dockerignore 规则排除不需要的路径,再把剩余内容交给构建器。这样做直接影响三件事:需要传输和扫描的数据量、COPY 指令可见的文件集合,以及哪些文件变化会参与缓存判断。

.dockerignore 在构建上下文进入构建器前进行过滤

.dockerignore 不会删除宿主机文件,也不会改变容器运行时的挂载规则。它只决定某个路径是否能进入本次构建上下文。如果某文件被忽略,后面的 COPY 或 ADD 就不能把它当作普通上下文文件复制进镜像。

写一份实用的忽略规则

下面是一份常见项目可直接改造的示例:

text
.git
.gitignore
*.log
logs/
node_modules/
dist/
.cache/
tmp/
.env.local

这些规则适合排除版本库元数据、日志、本地依赖、构建产物和缓存目录。是否忽略 dist/、.env.local 等文件要以项目实际构建方式为准:如果镜像构建本身需要它们,就不能排除。

规则支持通配匹配,也可以用 ! 重新包含先前被排除的路径。例如希望忽略所有日志但保留一份示例日志,可以写:

text
*.log
!example.log

验证哪些文件真正进入了上下文

可以临时使用一个专门用于检查上下文的 Dockerfile。下面是片段示例,只用于本地验证,不应作为生产镜像设计。

dockerfile
FROM alpine:3.22

WORKDIR /ctx
COPY . .
RUN find . -maxdepth 2 -type f | sort

保存后执行:

bash
docker build --no-cache --progress=plain -t ignore-check .

预期输出:find 只会列出未被 .dockerignore 排除、且确实被复制进镜像的文件。实际步骤编号会不同。

text
#<ID> [<STAGE> <N>/<M>] RUN find . -maxdepth 2 -type f | sort
#<ID> 0.1 ./src/<FILE>

如果输出中仍出现 logs/、.git/ 或本地缓存文件,说明忽略模式没有覆盖实际路径;如果构建在 COPY 阶段报“文件不存在”,则要检查是不是把构建所需文件误排除了。

忽略规则也会影响缓存

.dockerignore 不只是“让上传更小”。当无关文件被排除后,它们的变化就不会再作为普通构建上下文输入影响相关的 COPY 步骤。例如本地日志不断增长,如果没有忽略,而 Dockerfile 又使用 COPY . .,这些变化就可能频繁让该层失去缓存。

因此,合理的 .dockerignore 与 Dockerfile 排序通常一起使用:前者缩小“哪些文件能参与构建”,后者控制“这些文件在哪一步参与构建”。两者配合,既能减少误打包,也能让缓存边界更稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

.dockerignore 有什么作用

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

登录哪都通