如何将构建过程中生成的主机文件添加/复制到Docker镜像中

这个问题我之前帮朋友排查过，核心坑点就在Docker的构建上下文机制上，咱们一步步理清楚原因和解决办法：

为什么你的build.log总是空的？ #

你当前的操作里，docker build命令一启动，Docker就会先把当前目录的所有文件（除了.dockerignore排除的）打包成构建上下文，一次性发送给后台的Docker daemon。而你的build.log是在docker build执行过程中才被tee写入的——这时候构建上下文已经打包发送完了，daemon拿到的上下文里要么根本没有这个文件，要么就是还没被写入内容的空文件，后续的ADD/COPY自然没法把日志加到镜像里。

两种可行的解决方案 #

方案一：拆分构建步骤（直观易操作） #

把“生成日志”和“构建镜像”拆成两步，确保build.log存在于构建上下文里：

1. 第一步先执行构建，把日志完整写入本地文件（如果需要在终端同步看日志，就用tee）：

   # 仅生成日志到文件，终端不输出
   docker build -t test-temp . > build.log 2>&1
   # 或者终端同步输出+写入日志
   docker build -t test-temp . 2>&1 | tee build.log
   

2. 第二步基于包含build.log的上下文，构建正式镜像：

   docker build -t test .
   

这时候ADD build.log /root就能正常把日志文件加到镜像里了。

方案二：临时容器+提交（避免重复构建，适合大日志场景） #

如果你的日志特别大，重复构建太耗时间，可以用“构建基础镜像→复制日志到临时容器→提交成新镜像”的方式：

1. 先执行你的构建命令，生成build.log和基础镜像：

   docker build -t test-base . | tee build.log
   

2. 创建一个基于基础镜像的临时容器（只是创建不启动）：

   docker create --name temp-container test-base
   

3. 把本地的build.log复制到临时容器的指定路径：

   docker cp build.log temp-container:/root/build.log
   

4. 把这个临时容器提交成正式的test镜像：

   docker commit temp-container test
   

5. 最后清理掉临时容器：

   docker rm temp-container
   

这样生成的test镜像里就包含了你本地生成的build.log，哪怕日志是部分内容也能正常添加。

备注：内容来源于stack exchange，提问作者killdaclick