简介

​ 本文介绍了如何使用 Docker Buildx 一次性构建不同平台架构的 Docker 镜像，并上传到 Docker Hub。通过简单的准备工作和构建脚本，我们可以轻松地实现跨平台的镜像构建和发布。

准备工作

系统版本

root@example:~# lsb_release -a
No LSB modules are available.
Distributor ID:    Ubuntu
Description:    Ubuntu 22.04.4 LTS
Release:    22.04
Codename:    jammy

root@example:~# uname -a 
Linux example 6.5.0-26-generic #26~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue Mar 12 10:22:43 UTC 2 x86_64 x86_64 x86_64 GNU/Linux

docker环境
docker安装请参考阿里巴巴开源镜像站

root@example:~# docker version 
Client: Docker Engine - Community
 Version:           26.0.0
 API version:       1.45
 Go version:        go1.21.8
 Git commit:        2ae903e
 Built:             Wed Mar 20 15:17:48 2024
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          26.0.0
  API version:      1.45 (minimum version 1.24)
  Go version:       go1.21.8
  Git commit:       8b79278
  Built:            Wed Mar 20 15:17:48 2024
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.6.28
  GitCommit:        ae07eda36dd25f8a1b98dfbf587313b99c0190bb
 runc:
  Version:          1.1.12
  GitCommit:        v1.1.12-0-g51d5e94
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

在开始之前，确保你的系统已经安装了以下工具：

• qemu-user-static：用于在当前操作系统上运行其他架构的仿真器。
• binfmt-support：用于解析不同系统的二进制文件，给内核执行，并返回执行结果给用户空间的进程。 你可以使用以下命令安装这些工具：

sudo apt install binfmt-support qemu-user-static

配置 Docker Buildx

首先，创建一个 Docker Buildx 构建器并启用：

sudo docker buildx create --name mybuilder
sudo docker buildx use mybuilder
sudo docker buildx inspect --bootstrap

编写 Go 程序

在开始构建之前，我们先编写一个简单的 Go 程序 main.go，内容如下：

package main

import (
    "fmt"
    "runtime"
)

func main() {
    fmt.Println("Hello, Docker! Platform architecture:", runtime.GOARCH)
}

编写 Dockerfile

然后，编写 Dockerfile 用于构建 Go 程序的镜像：

FROM golang:1.17 AS builder

# 设置工作目录
WORKDIR /app

# 复制源代码到工作目录
COPY . .

# 编译可执行文件
RUN go mod init goDemo && go mod tidy && go build -o app .

准备构建脚本

编写一个构建脚本 build.sh，用于自动化构建不同平台架构的 Docker 镜像并推送到 Docker Hub：

#!/bin/bash

# 设置镜像仓库名称和标签
REPO="adcwb/builds"
TAG="latest"

# 获取所有平台架构
 PLATFORMS=$(sudo docker buildx ls | grep -oP '\blinux/\w+\b' | sort | uniq)

# 遍历所有平台架构并构建镜像
for platform in $PLATFORMS; do
    echo "Building image for platform: $platform"
    sudo docker buildx build -t ${REPO}:$(echo $platform | sed 's/\//-/g')-${TAG} --platform $platform . --push
done

Docker Buildx 是 Docker 的一个构建工具，它提供了一种更灵活和高效的方式来构建、打包和发布多平台架构的 Docker 镜像。以下是 Docker Buildx 的一些常用参数介绍：

• --platform：指定目标平台架构，可以是单个平台或多个平台的逗号分隔列表。例如：--platform linux/amd64,linux/arm64
• --builder：指定使用的构建器名称，可以是预先创建的构建器的名称。例如：--builder mybuilder
• --file：指定 Dockerfile 的路径。默认为当前目录下的 Dockerfile。
• --tag：指定镜像的标签。例如：--tag myimage:latest。
• --build-arg：传递构建参数给 Dockerfile。例如：--build-arg VAR_NAME=value。
• --output：指定输出格式。例如：--output type=image,push=true。
• --progress：设置构建过程中的输出进度格式。例如：--progress plain。
• --load：将构建的镜像导出到本地文件中。
• --push：将构建的镜像推送到镜像仓库。
• --no-cache：禁用构建缓存。
• --allow：设置构建策略，允许或拒绝某些操作。例如：--allow=all。

运行构建脚本

运行构建脚本即可开始构建不同平台架构的 Docker 镜像并推送到 Docker Hub：

注意：如需把镜像推送到现有仓库中，需要先进行登录

bash build.sh

构建过程如下所示，仅展示部分输出日志

查看构建结果

在 Docker Hub 上查看构建完成的镜像，并确认不同平台架构的镜像已经上传成功。

在其他系统上随机拉取镜像测试执行

$ sudo docker run --rm -it --platform linux/arm64 adcwb/builds:linux-arm64-latest 

Hello, Docker! Platform architecture: arm64