如何将Docker Build的构建输出保存到标准输出(stdout)？

问题原因 #

启用BuildKit作为构建后端时，docker build默认将构建进度、步骤日志等非结果类输出写入stderr而非stdout，终端显示的内容是stdout与stderr的合并结果，因此直接重定向/捕获stdout只能拿到-q参数输出的镜像ID这类标准输出内容。

可用解决方案 #

1. 直接合并流捕获全部输出

将stderr重定向到stdout后再处理即可：

• 输出写入文本文件：

# 写法1：兼容所有shell
docker build --progress=plain . > build.log 2>&1
# 写法2：bash/zsh等shell可用简化写法
docker build --progress=plain . &> build.log

• 脚本中通过popen读取（以Python为例）：
  显式指定将stderr合并到stdout流中再读取：

import subprocess
cmd = ["docker", "build", "--progress=plain", "."]
proc = subprocess.Popen(
    cmd,
    stdout=subprocess.PIPE,
    stderr=subprocess.STDOUT,
    text=True
)
for line in iter(proc.stdout.readline, ""):
    # 此处处理每一行构建输出
    print(line.strip())

2. 去除控制字符优化输出

如果捕获到的内容包含乱码、颜色控制符，添加--no-color参数关闭彩色输出即可：

docker build --progress=plain --no-color . &> build.log

异常排查 #

如果以上操作仍无法获取完整输出，确认当前shell的DOCKER_BUILDKIT环境变量值为1，且docker版本不低于18.09，避免版本兼容性导致的输出逻辑异常。

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