Docker构建报错求助：如何查看命令输出及调试Dockerfile

一、获取缓存步骤的输出 #

你的pwd和ls -aF执行结果看不到，核心原因是Docker默认会缓存已成功执行的构建步骤，直接跳过重复执行。要拿到输出，有两种简单方法：

• 完全禁用缓存重建
  执行构建时加--no-cache参数，强制Docker重新跑所有步骤，这样就能看到每一步的完整输出：

  docker build --no-cache -t kuard .
  

• 局部破坏缓存
  如果不想全量重建，就在需要重新执行的步骤前加一个会变化的指令，让Docker认为后续步骤需要更新。比如在COPY . .之后加一行：

  RUN echo "Force rebuild: $(date)"
  

  这样后面的pwd、ls等步骤就会重新执行并输出内容。

二、Dockerfile调试实用技巧 #

结合你遇到的build/build.sh: not found错误，给你几个实用的调试思路：

1. 分步构建+临时容器排查
   构建到出错步骤之前，然后启动容器手动验证：

   # 构建到COPY完成后的阶段，生成调试镜像
   docker build --target=builder -t kuard-debug .
   # 启动临时容器进入交互模式
   docker run --rm -it kuard-debug sh
   

   进容器后可以直接敲pwd、ls -aF，甚至手动找build.sh，直观排查文件是否存在、路径对不对。
2. 检查COPY的实际效果
   你提到当前目录无其他文件，那COPY . .等于什么都没复制到容器里，这就是build.sh找不到的直接原因！先确认你是不是在正确的项目目录下执行构建，或者是不是没下载完整《Kubernetes Up & Running》的示例代码（缺失了build目录和build.sh脚本）。
3. 添加更精准的调试指令
   在Dockerfile里加一行查找脚本的命令，确认容器内是否存在该文件：

   COPY . .
   RUN find / -name "build.sh" 2>/dev/null
   

   这样能直接看到脚本的实际路径，避免路径错误。
4. 用--progress=plain查看完整日志
   执行构建时加这个参数，能强制输出每一步的详细执行日志，哪怕是之前缓存过的步骤（缓存步骤不会重跑，但能看到历史输出）：

   docker build --progress=plain -t kuard .
   

内容的提问来源于stack exchange，提问作者MiguelMunoz