Apple M1上用Skaffold构建amd64镜像：确保使用Rosetta 2而非QEMU

问题背景 #

• 机器：M1架构（arm64），已在Docker Desktop中正确安装并激活Rosetta 2
• 异常现象：
  • 直接在终端执行docker build --platform linux/amd64 .可正常完成linux/amd64镜像构建
  • 通过Skaffold执行skaffold build时构建失败，日志显示Skaffold使用QEMU模拟器而非Rosetta 2，尝试arch -x86_64 skaffold build无效
• 当前Skaffold.yaml镜像构建配置：

- image: $IMAGE
  context: .
  custom:
    buildCommand: docker build --platform linux/amd64 . 

• 核心报错：构建过程调用/dev/.buildkit_qemu_emulator执行apt安装命令，出现dpkg-split、dpkg-deb等工具加载失败，最终导致dpkg执行错误，构建退出码100

解决方案 #

1. 确认Docker Desktop Rosetta 2配置生效 #

打开Docker Desktop的设置：

• 进入「Settings」->「Features in development」
• 勾选「Use Rosetta for x86/amd64 emulation on Apple Silicon」
• 重启Docker Desktop使配置生效

2. 调整Skaffold构建配置 #

方案一：改用Docker原生驱动构建

修改Skaffold.yaml，直接指定平台并禁用BuildKit，避免Skaffold调用QEMU：

build:
  artifacts:
  - image: $IMAGE
    context: .
    docker:
      dockerfile: Dockerfile
      platform: linux/amd64
  cluster:
    disableBuildkit: true

方案二：保留自定义构建命令并强制使用Rosetta

如果需要保留自定义buildCommand，添加环境变量强制Docker使用Rosetta：

build:
  artifacts:
  - image: $IMAGE
    context: .
    custom:
      buildCommand: DOCKER_DEFAULT_PLATFORM=linux/amd64 docker build .
      env:
        - DOCKER_DEFAULT_PLATFORM=linux/amd64

方案三：配置BuildKit使用Rosetta

创建或修改~/.docker/config.json，配置BuildKit优先使用Rosetta作为amd64平台的模拟器：

{
  "features": {
    "buildkit": true
  },
  "builder": {
    "config": {
      "oci-worker": {
        "platforms": {
          "linux/amd64": {
            "emulator": "/usr/local/bin/rosetta"
          }
        }
      }
    }
  }
}

修改完成后重启Docker Desktop，再执行skaffold build

3. 验证Rosetta 2是否被使用 #

执行以下命令查看Docker的emulation配置：

docker system info | grep -A5 "Emulation"

如果输出中包含Rosetta相关信息，说明已成功切换到Rosetta 2进行构建；同时查看Skaffold构建日志，确认不再出现/dev/.buildkit_qemu_emulator的调用记录。

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