首页/云/云与容器速查/buildx 多架构构建与推送
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

buildx 多架构构建与推送

用 buildx 一次构建多平台镜像并推送:多架构镜像不能本地 docker load(除非单平台导出),必须直接 --push 或 --output=type=registry。

云与容器速查云更新于 2026-10-12
创建构建器docker buildx create --use --name multi(支持 QEMU 跨架构)
多平台构建--platform linux/amd64,linux/arm64
输出方式--push 直推仓库;--load 仅支持单平台
驱动docker-container 驱动才支持多平台输出

完整流程

完整流程
docker buildx create --use --name multi --driver docker-container
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t registry.example.com/team/app:1.2.3 \
  --push .
跨架构构建经常走 QEMU 模拟:编译耗时可能是原生数倍,构建超时高发,CI 上预留足够时间。

易错点

  • multi-platform 加 --load:直接报错(不支持),要 --push
  • 没创建 buildx 构建器就用 --platform:还是默认 builder,多平台不生效

数据来源与参考

  • Docker Docs:Multi-platform builds
  • Docker Docs:docker buildx build

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌