多平台Docker镜像构建时相互干扰的问题排查与解决咨询

多架构并行构建时，Docker BuildX默认同时启动两个架构的构建进程，尽管每个进程在独立容器内执行，但由于并行构建的资源竞争（或Postgres恢复环节的竞态条件），导致数据被重复导入，触发主键重复错误。单独构建时串行执行，无此冲突。

1. 禁用并行构建 #

修改构建命令，添加--parallel=false强制串行构建两个架构，避免资源竞争：

docker buildx build --no-cache --parallel=false --platform linux/arm64,linux/amd64 --tag minus34/gnafloader_test:latest --tag minus34/gnafloader_test:202411 -f ${DOCKER_FOLDER}/Dockerfile . --load

2. 串行构建并合并镜像 #

若禁用并行仍有问题，可分别构建单个架构镜像，再合并为多架构镜像清单：

# 构建arm64镜像并推送到仓库
docker buildx build --no-cache --platform linux/arm64 --tag minus34/gnafloader_test:202411-arm64 -f ${DOCKER_FOLDER}/Dockerfile . --push
# 构建amd64镜像并推送到仓库
docker buildx build --no-cache --platform linux/amd64 --tag minus34/gnafloader_test:202411-amd64 -f ${DOCKER_FOLDER}/Dockerfile . --push
# 创建多架构镜像清单
docker manifest create minus34/gnafloader_test:202411 minus34/gnafloader_test:202411-arm64 minus34/gnafloader_test:202411-amd64
# 推送清单到仓库
docker manifest push minus34/gnafloader_test:202411

3. 优化Dockerfile恢复步骤 #

确保Postgres完全就绪后再执行pg_restore，避免因服务未启动完成导致的异常：

RUN /etc/init.d/postgresql start \
    && until pg_isready -h 127.0.0.1 -p 5432 -U postgres; do sleep 1; done \
    && pg_restore -Fc -d postgres -h 127.0.0.1 -p 5432 -U postgres /data/gnaf-202411.dmp \
    && /etc/init.d/postgresql stop \
    && rm /data/gnaf-202411.dmp

RUN /etc/init.d/postgresql start \
    && until pg_isready -h 127.0.0.1 -p 5432 -U postgres; do sleep 1; done \
    && pg_restore -Fc -d postgres -h 127.0.0.1 -p 5432 -U postgres /data/admin-bdys-202411.dmp \
    && /etc/init.d/postgresql stop \
    && rm /data/admin-bdys-202411.dmp

无需换用Podman，通过调整BuildX构建参数或Dockerfile即可解决问题。优先尝试禁用并行构建，若无效再采用串行构建合并镜像的方式。

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