跳到主要内容

docker跨平台构建镜像

docker跨平台构建镜像官方文档

启用跨平台构建功能​

使用 Docker Buildx 来构建跨平台镜像，否则本地 Docker 默认只支持你当前机器的架构

创建Docker Buildx 构建器（builder）​

说明

作用：

  • 创建一个新的 Buildx 构建器，名字叫 mybuilder
  • --use 表示：创建完之后立即设为默认使用的构建器（后续 docker buildx build 会使用它）

结果：

  • 实际上会自动创建一个叫 buildx_buildkit_mybuilder 的容器，用作隔离的构建环境
  • 默认 driver 是 docker-container（支持多平台）
docker buildx create --use --name mybuilder

查看创建的构建器，默认是有一个名为 default 的构建器

$ docker buildx ls
NAME/NODE    DRIVER/ENDPOINT             STATUS   PLATFORMS
mybuilder *  docker-container                     
  mybuilder0 unix:///var/run/docker.sock inactive 
default      docker                               
  default    default                     running  linux/amd64, linux/386
构建器名称驱动类型节点状态平台支持
mybuilderdocker-container❌ inactive（未启动）未列出平台（未初始化）
defaultdocker✅ runninglinux/amd64, linux/386

初始化Docker BuildKit 构建器​

$ docker buildx inspect mybuilder --bootstrap
[+] Building 15.9s (1/1) FINISHED                                                             
 => [internal] booting buildkit                                                                         15.9s
 => => pulling image moby/buildkit:buildx-stable-1                                                      13.7s
 => => creating container buildx_buildkit_mybuilder0                                                     2.2s
Name:   mybuilder
Driver: docker-container

Nodes:
Name:      mybuilder0
Endpoint:  unix:///var/run/docker.sock
Status:    running
Platforms: linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/amd64/v4, linux/386

初始化构建器会启动一个容器

$ docker ps -a
CONTAINER ID   IMAGE                                  COMMAND                  CREATED         STATUS                   PORTS                       NAMES
0e7398f34933   moby/buildkit:buildx-stable-1          "buildkitd"              4 minutes ago   Up 4 minutes                                         buildx_buildkit_mybuilder0

再次查看构建器

$ docker buildx ls
NAME/NODE    DRIVER/ENDPOINT             STATUS  PLATFORMS
mybuilder *  docker-container                    
  mybuilder0 unix:///var/run/docker.sock running linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/amd64/v4, linux/386
default      docker                              
  default    default                     running linux/amd64, linux/386

构建镜像​

构建单平台镜像​

--load 添加与否的区别如下

构建命令构建结果保存在哪里是否支持多平台是否可本地 docker run
docker buildx build --platform linux/arm64 ...❌ 不保存（仅缓存中）✅ 是❌ 否
docker buildx build --platform linux/arm64 ... --load✅ 本地 Docker 镜像中❌ 否（仅当前平台）✅ 是

详细解释：

🚫 不加 --load：

  • 构建产物只存在于 BuildKit 的临时缓存中
  • 不会导入到本地镜像库，你在 docker images 里看不到
  • 如果没加 --push，你根本无法用 docker run 启动它
  • 通常用于 CI 构建+推送的中间步骤

✅ 加了 --load：

  • 构建好的镜像会被加载进本地 docker images 仓库

  • 可以马上运行：

    docker run -it pptfz/phpldapadmin:1.2.5

  • ⚠️ 只能构建单平台（不能和 --platform linux/amd64,linux/arm64 一起用）

构建x86架构​

docker buildx build --platform linux/amd64 -t pptfz/phpldapadmin:1.2.5 . --load

构建arm架构​

docker buildx build --platform linux/arm64 -t pptfz/phpldapadmin:1.2.5 . --load

构建多平台镜像​

执行构建命令并推送到远程仓库

说明

如果在构建的时候不指定 --push 参数，则会有如下警告

因此必须显式指定输出方式，否则构建结果不会保存，也不会导入到本地 Docker 镜像库，因为 buildx 构建多平台镜像时，默认是运行在独立容器里（不是 docker 驱动），镜像并不会自动回到宿主机

$ docker buildx build --platform linux/amd64,linux/arm64 -t pptfz/phpldapadmin:1.2.5 . 
WARN[0000] No output specified for docker-container driver. Build result will only remain in the build cache. To push result image into registry use --push or to load image into docker use --load 
docker buildx build --platform linux/amd64,linux/arm64 -t pptfz/phpldapadmin:1.2.5 . --push
Right Bottom Gif
Right Top GIF