如何禁用docker buildx多平台并行构建 改为顺序执行

• Docker镜像构建过程中需要启动内置服务完成管理端配置，该服务启动时会占用固定端口
• 使用docker buildx执行多平台构建时，默认采用并行逻辑调度不同架构的构建任务，会同时启动多个服务实例，触发固定端口占用冲突
• 曾尝试添加--cpuset-cpus 1参数将CPU限制为1核以关闭并行，但该参数仅作用于构建容器的资源限制，不会改变buildx的任务调度逻辑，因此未生效。原使用的构建命令如下：

docker buildx build --platform=linux/amd64,linux/arm64/v8 --cpuset-cpus 1 --push -t ivonet/payara .

• 运行环境为Apple M1（aarch64）芯片设备，目标为找到可行方案禁用buildx多平台构建的并行执行模式，改为顺序构建。

buildx目前没有提供直接关闭多平台并行构建的命令行参数，可根据自身环境选择以下两种方案实现顺序构建：

方案1：自定义buildkit配置限制并行度（推荐） #

新版本buildkit支持通过配置文件设置worker最大并行任务数，将该值设为1即可强制所有构建任务排队顺序执行：

1. 新建buildkitd.toml配置文件，写入以下内容：

[worker.oci]
  max-parallelism = 1

2. 基于该配置创建专用的buildx构建实例并切换使用：

docker buildx create --name sequential-builder --config ./buildkitd.toml --use

3. 正常执行多平台构建命令即可，此时不同架构的构建任务会按顺序执行，不会出现同时启动服务导致的端口冲突：

docker buildx build --platform=linux/amd64,linux/arm64/v8 --push -t ivonet/payara .

注意：该方案要求buildkit版本不低于v0.10，对应Docker Desktop版本不低于4.15.0，Apple M1设备更新到近期正式版Docker Desktop即可满足要求。

方案2：拆分构建步骤手动顺序执行 #

如果本地Docker版本较低不支持上述配置，可将多平台构建拆分为两次单平台构建，手动控制执行顺序，同时配合构建缓存避免重复构建步骤：

# 第一步：构建amd64架构镜像，同时推送构建缓存
docker buildx build --platform=linux/amd64 --push -t ivonet/payara:amd64 --cache-to=type=registry,ref=ivonet/payara:buildcache .

# 第二步：构建arm64v8架构镜像，复用前一步的缓存
docker buildx build --platform=linux/arm64/v8 --push -t ivonet/payara:arm64v8 --cache-from=type=registry,ref=ivonet/payara:buildcache .

# 第三步：合并两个架构的镜像，生成统一的多架构镜像标签
docker buildx imagetools create -t ivonet/payara ivonet/payara:amd64 ivonet/payara:arm64v8

内容的提问来源于stack exchange，提问作者Ivonet