容器与云原生 / 系统课时

控制构建上下文

控制构建上下文

本节解决 Docker 构建时无关文件进入上下文的问题。通过编写 .dockerignore 限制源码缓存、日志和敏感文件传输,让构建更快、更安全。

学习目标

  • 理解 Docker 构建上下文的范围和影响。
  • 学会编写 .dockerignore 排除不需要的文件。
  • 掌握通过构建过程验证上下文优化效果的方法。

认识构建上下文

执行 docker build 时,当前目录通常会作为构建上下文发送给 Docker。上下文过大不仅增加传输时间,还可能把日志、临时文件甚至密钥带入构建环境。

例如,一个包含依赖缓存和本地日志的项目目录,虽然最终镜像不一定使用这些文件,但它们仍可能影响构建速度。

编写 .dockerignore 文件

.dockerignore 的作用类似版本控制中的忽略规则。它会在 Docker 发送构建上下文前过滤文件。

text
.git
node_modules
*.log
.env
.tmp
coverage

预期结果

text
匹配规则中的文件不会被发送到 Docker 构建上下文中。

实际过滤内容取决于项目目录中的文件结构。

验证上下文大小变化

优化前后可以通过构建命令输出观察发送上下文大小的变化。

bash
docker build -t demo-api:optimized .

预期输出

text
[internal] load build context
transferring context: <SIZE>

其中 <SIZE> 表示实际传输大小,会随着项目文件变化而不同。

处理常见遗漏文件

配置 .dockerignore 时需要平衡排除范围和构建需求。过度忽略可能导致 Dockerfile 中需要复制的文件不存在。排查时可以检查:

  • Dockerfile 中 COPY 指令依赖的文件是否被忽略。
  • 构建失败信息是否提示文件不存在。
  • 敏感配置是否通过运行时注入而不是复制进入镜像。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制构建上下文

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

登录哪都通