容器与云原生 / 系统课时
控制构建上下文
控制构建上下文
本节解决 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指令依赖的文件是否被忽略。 - 构建失败信息是否提示文件不存在。
- 敏感配置是否通过运行时注入而不是复制进入镜像。
按自己的节奏,确认真正理解。