容器与云原生 / 系统课时
.dockerignore 有什么作用
.dockerignore 有什么作用
Docker 构建时会读取一个构建上下文,目录里的无关文件如果一起进入上下文,会拖慢传输、扩大缓存失效范围,还可能把本地日志或敏感临时文件带进镜像构建过程。.dockerignore 的作用,就是在上下文送给构建器之前先做过滤。
学习目标
- 理解
.dockerignore过滤的是构建上下文而不是运行中容器 - 能排除日志、Git 目录、缓存和本地临时文件
- 能验证忽略规则是否误伤构建所需文件
它过滤的是构建上下文
执行 docker build . 时,最后的 . 表示构建上下文目录。Docker 会根据 .dockerignore 规则排除不需要的路径,再把剩余内容交给构建器。这样做直接影响三件事:需要传输和扫描的数据量、COPY 指令可见的文件集合,以及哪些文件变化会参与缓存判断。

.dockerignore 不会删除宿主机文件,也不会改变容器运行时的挂载规则。它只决定某个路径是否能进入本次构建上下文。如果某文件被忽略,后面的 COPY 或 ADD 就不能把它当作普通上下文文件复制进镜像。
写一份实用的忽略规则
下面是一份常见项目可直接改造的示例:
.git
.gitignore
*.log
logs/
node_modules/
dist/
.cache/
tmp/
.env.local这些规则适合排除版本库元数据、日志、本地依赖、构建产物和缓存目录。是否忽略 dist/、.env.local 等文件要以项目实际构建方式为准:如果镜像构建本身需要它们,就不能排除。
规则支持通配匹配,也可以用 ! 重新包含先前被排除的路径。例如希望忽略所有日志但保留一份示例日志,可以写:
*.log
!example.log验证哪些文件真正进入了上下文
可以临时使用一个专门用于检查上下文的 Dockerfile。下面是片段示例,只用于本地验证,不应作为生产镜像设计。
FROM alpine:3.22
WORKDIR /ctx
COPY . .
RUN find . -maxdepth 2 -type f | sort保存后执行:
docker build --no-cache --progress=plain -t ignore-check .预期输出:find 只会列出未被 .dockerignore 排除、且确实被复制进镜像的文件。实际步骤编号会不同。
#<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 排序通常一起使用:前者缩小“哪些文件能参与构建”,后者控制“这些文件在哪一步参与构建”。两者配合,既能减少误打包,也能让缓存边界更稳定。