Docker多阶段构建如何禁止特定阶段运行时其他阶段并行执行

Docker默认使用BuildKit执行构建时，会自动并行调度没有依赖关系的独立阶段，你当前Dockerfile中的client_build和open_cv_builder属于完全独立的两个阶段，所以会同时运行触发资源抢占。可通过以下几种方案解决： #

方案1：显式设置阶段依赖（无需修改构建命令） #

通过添加虚拟依赖声明，强制BuildKit按你需要的顺序调度阶段，避免两个重负载阶段并行：

• 若优先执行open_cv_builder，让其他阶段等它完成后再启动，只需在client_build阶段添加一行无实际作用的COPY语句建立依赖：

FROM node:12.22.1 AS client_build
# 新增该行，声明当前阶段依赖open_cv_builder的执行结果
COPY --from=open_cv_builder /etc/hostname /tmp/.build_dep_mark
COPY client/package*.json .
RUN npm install
RUN npm run build

• 若想先执行轻量的client_build再跑opencv编译，将上述虚拟COPY语句添加到open_cv_builder阶段即可。

该虚拟COPY操作仅用于标记阶段依赖，不会对最终镜像的大小和内容产生任何影响。 #

方案2：全局限制构建并行度（操作最便捷） #

执行构建命令时添加参数，强制所有阶段串行执行，完全避免并行冲突：

docker build --build-arg BUILDKIT_MAX_PARALLELISM=1 .

该方案不需要修改Dockerfile，适合临时快速解决问题，缺点是整体构建速度会略有下降。 #

方案3：限制opencv构建的资源用量（从根源解决冲突） #

不需要禁止并行，直接限制opencv编译阶段的CPU占用，避免占满所有核心导致其他进程超时或冻结：

1. 调整make编译的并行线程数，预留部分核心给其他进程：
   将原有make -j8修改为make -j$(nproc --ignore=2)，会自动识别当前机器的CPU核心数，预留2个核心供其他进程使用。
2. 若使用Dockerfile 1.4及以上语法，可直接给RUN指令绑定CPU限制：

# Dockerfile开头声明语法版本
# syntax=docker/dockerfile:1.4

FROM pkg_builder AS open_cv_builder
ARG PYTHON_VERSION
# 给RUN指令添加--cpus参数，限制最多使用6核
RUN --cpus=6 cd ~ && \
    python${PYTHON_VERSION} -m pip install numpy==1.18.2 && \
    # 后续原有代码保持不变
    ...

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