容器与云原生 / 系统课时
控制构建上下文
控制构建上下文
执行 docker build 时,Docker 不只读取 Dockerfile,还会把指定目录作为构建上下文发送给构建器。本课将通过 .dockerignore 和正确的目录选择,缩小传输范围,并避免日志、仓库元数据和敏感文件进入镜像构建过程。
学习目标
- 理解构建上下文与 Dockerfile 路径的区别
- 使用
.dockerignore排除无关和敏感文件 - 验证被排除的文件没有进入镜像
构建上下文决定可访问范围
命令末尾的路径才是构建上下文。下面是片段示例,假设当前目录存在可用的 Dockerfile;点号表示当前目录,COPY 和 ADD 只能读取这个目录及其子目录中的文件。
docker build -t context-demo .预期结果:
构建器读取当前目录中未被 .dockerignore 排除的文件,并生成 context-demo:latest。Dockerfile 可以通过 -f 放在其他位置,但不会因此改变上下文。下面同样是片段示例,要求项目中已经存在 docker/Dockerfile。
docker build -f docker/Dockerfile -t context-demo .预期结果:
构建器使用 docker/Dockerfile,但可访问范围仍由末尾的项目根目录决定。使用 .dockerignore 缩小范围
下面创建一个最小项目,其中包含源码、20 MB 日志和环境文件。.dockerignore 会排除日志目录、Git 元数据和所有 .env 文件,同时通过取反规则保留公开模板。
mkdir -p context-demo/src context-demo/logs
cd context-demo
printf 'application data\n' > src/app.txt
dd if=/dev/zero of=logs/debug.log bs=1M count=20 status=none
printf 'TOKEN=secret\n' > secrets.env
printf 'TOKEN=replace-me\n' > .env.example
cat > .dockerignore <<'EOF'
.git
logs/
.env*
*.env
!.env.example
EOF
cat > Dockerfile <<'EOF'
FROM alpine:3.20
COPY . /app
CMD ["sh", "-c", "test -f /app/src/app.txt && test -f /app/.env.example && test ! -e /app/logs/debug.log && test ! -e /app/secrets.env && echo context-ok"]
EOF
docker build --progress=plain -t context-demo .
docker run --rm context-demo预期输出:
#<ID> transferring context: <SIZE>
...
context-ok<ID> 和 <SIZE> 是动态值。关键结果是上下文传输量不包含 20 MB 日志,并且容器输出 context-ok,证明应保留和应排除的文件均符合预期。
选择正确的上下文根目录
上下文过大,会拖慢传输并增加缓存失效范围;上下文过小,则会导致 COPY 找不到文件。下面是片段示例,假设 Dockerfile 位于 docker 子目录,并包含 COPY src /app/src。
先执行上下文过小的命令:
docker build -f docker/Dockerfile -t app-image docker预期结果:
构建失败,因为 src 不在 docker 上下文中。再把项目根目录作为上下文:
docker build -f docker/Dockerfile -t app-image .预期结果:
构建器可以读取根目录下的 src,并继续执行构建。敏感文件不能只靠事后删除
文件一旦被 COPY 进某个镜像层,即使后续执行 RUN rm,旧层中仍可能保留内容。因此应在发送上下文之前通过 .dockerignore 排除密钥、生产配置、数据库备份和本地凭据。
构建所需的临时秘密不应写入 ARG、ENV 或普通文件。需要访问私有仓库时,应使用 BuildKit secret mount,让秘密只在单个构建步骤中短暂可见,并在构建完成后检查镜像历史和最终文件系统。
本课总结
docker build最后的路径决定构建上下文,-f只改变 Dockerfile 位置.dockerignore能减少传输量、提高缓存稳定性并阻止敏感文件进入上下文- 敏感文件必须在进入镜像层之前排除,后续删除不能清除旧层内容
下一课预告
下一课将继续优化镜像构建过程,重点关注分层顺序、缓存复用和减少最终镜像体积的方法。