Docker Buildx使用教程：使用Buildx構建多平臺映象

東北小狐狸發表於2022-07-03
DockerUI

寫在前邊

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

構建環境

軟體名 版本
Ubuntu 18.04.2 LTS
Docker 20.10.16

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，過些日子再見！

相關文章