如何验证Docker Buildx构建是否实际使用指定平台的原生节点？

我在x64 Linux系统上有一个基于QEMU的多平台Buildx构建器，名为maven，并添加了一台Mac Mini作为Arm构建的原生节点。执行docker buildx ls的输出如下：

$ docker buildx ls
NAME/NODE  DRIVER/ENDPOINT             STATUS   BUILDKIT PLATFORMS
builder    docker-container                              
  builder0 unix:///var/run/docker.sock inactive          
maven *    docker-container                              
  maven0   unix:///var/run/docker.sock running  v0.11.0  linux/amd64*, linux/amd64/v2, linux/arm64, ....
  mac-mini ssh://some-user@10.1.2.3    running  v0.11.5  linux/arm64*, linux/amd64, linux/amd64/v2, ...

我已经通过构建“Hello World”镜像验证配置可用，执行命令及输出如下：

$ docker buildx build --progress plain --builder maven --platform linux/arm64,linux/amd64 --tag my-hello-world .
...
#8 [linux/arm64 internal] load metadata for docker.io/library/debian:bullseye-slim
#8 DONE 1.0s

#6 [linux/amd64 internal] load metadata for docker.io/library/debian:bullseye-slim
#6 DONE 0.9s
...

但无法从现有构建输出判断：Docker是否实际使用原生Mac Mini节点进行Arm构建，还是仍在使用本地QEMU节点？

确认方法 #

1. 查看调试日志中的任务分配 #

在构建命令中添加--debug参数，日志会明确显示每个架构任务对应的节点：

docker buildx build --progress plain --builder maven --platform linux/arm64,linux/amd64 --tag my-hello-world --debug .

在输出中查找类似selected worker: mac-mini的条目，对应linux/arm64的构建任务，即可确认使用了原生节点。

2. 通过节点平台优先级判断 #

从docker buildx ls的输出可以看到：

• mac-mini节点的linux/arm64后带有*，代表这是该节点的原生架构，优先级最高
• maven0节点的linux/arm64无*，是QEMU模拟的架构

Buildx默认会优先为架构任务分配支持该原生架构的节点，因此linux/arm64构建会默认落到mac-mini上。

3. 在Dockerfile中添加验证步骤 #

修改Dockerfile，加入打印主机名和架构的步骤：

FROM debian:bullseye-slim
RUN echo "Hostname: $(hostname)" && echo "Architecture: $(uname -m)"

重新构建后，查看linux/arm64对应的步骤输出：

• 若架构为aarch64、主机名是Mac Mini的实际主机名，说明用了原生节点
• 若架构为x86_64、主机名是类似maven0的容器名，说明用了QEMU模拟

内容的提问来源于stack exchange，提问作者Marcel Stör