首页/开发/CI/CD 与发布速查/构建上下文与 .dockerignore
构建与制品管理58 条

构建上下文与 .dockerignore

构建上下文会先传给 Build 守护进程:用 .dockerignore 排除 .git、node_modules、密钥与临时文件,减少传输与被误拷风险。

CI/CD 与发布速查开发更新于 2026-10-12
作用减小上下文体积、加快构建、防止敏感文件进入构建环境
常见条目.git、node_modules、dist、*.key、.env、测试数据
注意docker build 的上下文路径决定默认范围,配合显式 COPY 双保险

.dockerignore

.dockerignore
.git
node_modules
dist
*.log
.env*
*.pem
*.key
tests/fixtures
上下文里有密钥文件时,即使没进最终镜像,也已被传输与缓存;先排除再构建。

易错点

  • 忽略文件写得太宽(如 *):COPY 时缺文件报错,用「排除+显式复制」核对
  • 只在后期加 dockerignore:历史缓存里可能已含敏感文件,重建并审计

数据来源与参考

  • Docker Docs《.dockerignore》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌