Docker Buildx使用教程：使用Buildx構建多平台鏡像

• 2022 年 7 月 3 日
• 筆記
• docker

寫在前邊

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

構建環境

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

啟用BuildX

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

啟用 Buildx 有兩種方式：

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

2. 配置文件激活：

   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)傳輸到合適的平台上運行。

寫在最後

本文簡易地創建了多平台鏡像構建環境，如果對你有所幫助，歡迎點贊、評論、關注。

我是 Hellxz，過些日子再見！