使用buildx构建镜像

创建支持 x86 和 ARM64 的 buildx Builder 并构建镜像

前提条件

1. Docker 版本：确保 Docker ≥ 19.03，运行：

   docker --version
   

2. buildx 插件：确认 buildx 可用：

   docker buildx version
   

   若不可用，需启用实验性功能或安装插件（见下方）。
3. QEMU 模拟器：为跨平台构建安装 QEMU（Docker Desktop 通常已包含，Linux 系统需手动安装）：

   sudo apt-get install qemu-user-static
   

4. 实验性功能（若 buildx 不可用）：编辑 ~/.docker/config.json：

   {
     "experimental": "enabled"
   }
   

   或临时设置：

   export DOCKER_CLI_EXPERIMENTAL=enabled
   

步骤 1：创建支持 x86 和 ARM64 的 Builder

1. 创建 Builder 实例：

   docker buildx create --name multiarch-builder \
     --driver docker-container \
     --platform linux/amd64,linux/arm64 \
     --use
   

   • --name multiarch-builder：命名 Builder。
   • --driver docker-container：使用容器驱动隔离构建。
   • --platform：指定支持 linux/amd64 和 linux/arm64。
   • --use：设为默认 Builder。

2. 启动并验证 Builder：

   docker buildx inspect --bootstrap
   

   • 输出示例：

     Name:   multiarch-builder
     Driver: docker-container
     Nodes:
     Name:      multiarch-builder0
     Endpoint:  default
     Status:    running
     Platforms: linux/amd64, linux/arm64
     

   • 确认 Platforms 包含 linux/amd64 和 linux/arm64。

3. 列出 Builder：

   docker buildx ls
   

   • 确保 multiarch-builder 状态为 running。

步骤 2：使用 Builder 构建多平台镜像

1. 准备 Dockerfile
   确保当前目录有一个有效的 Dockerfile，例如：

   FROM alpine:latest
   CMD ["echo", "Hello, Multi-Arch World!"]
   

2. 构建并推送镜像：
   使用 multiarch-builder 构建支持 x86 和 ARM64 的镜像：

   docker buildx build \
     --builder multiarch-builder \
     --platform linux/amd64,linux/arm64 \
     -t yourusername/myimage:latest \
     --push .
   

   • --builder multiarch-builder：指定使用创建的 Builder。
   • --platform：目标架构。
   • -t：镜像名称（替换 yourusername 为你的 Docker Hub 用户名）。
   • --push：构建后推送到镜像仓库。
   • .：当前目录（包含 Dockerfile）。

3. 验证构建结果：

   • 检查镜像是否支持多平台：

     docker buildx imagetools inspect yourusername/myimage:latest
     

   • 输出将显示支持的架构（如 linux/amd64 和 linux/arm64）。

注意事项

• Docker Hub 登录：推送镜像前需登录：

  docker login
  

• QEMU 安装：若缺少平台支持，运行：

  docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
  

• 性能优化：启用 BuildKit 缓存以加速构建：

  export DOCKER_BUILDKIT=1
  

• 权限：确保用户有 Docker 权限：

  sudo usermod -aG docker $USER
  

• 清理：若需删除 Builder：

  docker buildx rm multiarch-builder
  

验证

确认 Builder 和镜像支持 x86 和 ARM64：

docker buildx inspect multiarch-builder
docker buildx imagetools inspect yourusername/myimage:latest