如何在Dockerfile构建时打印链式RUN命令中的每条执行命令？

在Dockerfile中，我们通常会将多个命令通过&&链式组合到单个RUN指令中，比如：

RUN cmd1 && cmd2 && cmd3 && ...

执行docker build时，只会打印整条链式命令后再执行。一旦出现错误，往往无法直接定位是哪条命令导致的问题。以下是适用于Linux和Windows容器的解决方案：

Linux容器解决方案 #

可以通过开启shell的调试模式，让每条执行的命令都被打印出来：

• 直接在RUN指令中添加set -x开启调试：

  RUN set -x && cmd1 && cmd2 && cmd3
  

  set -x会让shell在执行每条命令前，先打印该命令的内容，出错时最后打印的那条命令就是故障源。
• 如果命令逻辑复杂，也可以将命令写入shell脚本，在脚本开头添加set -x，再通过RUN执行脚本：

  COPY script.sh /tmp/
  RUN chmod +x /tmp/script.sh && /tmp/script.sh
  

  script.sh内容示例：

  #!/bin/bash
  set -x
  cmd1
  cmd2
  cmd3
  

Windows容器解决方案 #

Windows容器需根据使用的shell（cmd或PowerShell）选择对应方式：

使用cmd的情况 #

通过echo on开启命令回显：

RUN cmd /c "echo on && cmd1 && cmd2 && cmd3"

echo on会让cmd在执行每条命令前打印命令内容，便于定位错误。

使用PowerShell的情况 #

通过Set-PSDebug -Trace 1开启调试输出，同时设置ErrorActionPreference='Stop'保证命令出错时立即终止（与&&的效果一致）：

RUN powershell -Command "$ErrorActionPreference='Stop'; Set-PSDebug -Trace 1; cmd1; cmd2; cmd3"

补充说明 #

如果不介意镜像层数增加，也可以将链式命令拆分为多个独立的RUN指令，每个RUN只执行一条命令。不过这种方式会增加镜像的层数，因此更推荐使用上述开启调试输出的方法，在单个RUN指令中兼顾镜像层数优化和错误定位能力。

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