寫在前邊

記錄一下前陣子在X86_64平臺使用Docker Buildx構建多平臺鏡像的辦法，包含但不限于構建ARM鏡像。

構建環境

Ubuntu 和 Fedora 安裝構建環境比較方便，沒有內核版本低導致的一系列問題。如果想使用CentOS請參考其他文檔。

啟用BuildX

Docker Buildx 是 Docker的CLI插件，來自于Moby BuildKit 。自從Docker 18.06 開始這個插件直接集成到了Docker build 中，直至成文之日，它仍處于Experimental狀態，所以想使用它需要顯式地開啟它。

啟用 Buildx 有兩種方式：

臨時激活：在執行構建命令前添加環境變量，如 DOCKER_BUILDKIT=1 docker buildx build -t 鏡像:標簽 --platform linux/arm64 .

配置文件激活：

vim /etc/docker/daemon.json
#添加配置
{
    "experimental": true
}

安裝qemu-user-static

qemu-user-static 用來模擬多平臺環境，它依賴于binfmt-support，所以這兩者都要安裝。

sudo apt install -y qemu-user-static binfmt-support

通知Docker使用qemu

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

創建Buildx構建容器

#創建構建容器
docker buildx create --name mybuilder
#buildx使用構建容器
docker buildx use mybuilder
#初始化構建容器
docker buildx inspect --bootstrap

當初始化成功，會拉下來moby/buildkit:buildx-stable-1的鏡像，并啟動構建容器。通過 docker ps 查看如下：

root@hz:~# docker ps
root@hz:~# docker ps
CONTAINER ID   IMAGE                           COMMAND       CREATED       STATUS          PORTS     NAMES
ba6651e07ab0   moby/buildkit:buildx-stable-1   "buildkitd"   5 weeks ago   Up 50 minutes             buildx_buildkit_mybuilder0

調整Dockerfile接收平臺相關參數

為確保構建容器能拉取到正確平臺的基礎鏡像，可顯式在FROM后指定平臺參數 TARGETPLATFORM 或 BUILDPLATFORM，由buildx自動傳遞。

FROM --platform=$TARGETPLATFORM 基礎鏡像名:TAG
.... 其他內容

同時構建X86_64與ARM64鏡像

構建并直接推送到指定倉庫

docker buildx build -t 鏡像倉庫地址/鏡像名:TAG --platform linux/amd64,linux/arm64 . --push

構建并導出到本地Docker images中

docker buildx build -t 鏡像倉庫地址/鏡像名:TAG --platform linux/arm64 . --load

注意那個點，是構建上下文位置為當前目錄的意思。另外導出到本地只能構建一個鏡像，本地不支持同時導出manifest lists。

導出的鏡像如果與當前運行環境平臺不同，是無法直接啟動的，可以導出(docker save)傳輸到合適的平臺上運行。

寫在最后