如何在单次Docker构建中用多组参数参数化Dockerfile构建阶段

问题背景 #

原始Dockerfile示例：

FROM base AS build-project-a
RUN /src-a/build.sh # Builds to /output

FROM base AS build-project-b
RUN /src-b/build.sh # Builds to /output

FROM base AS run-both
COPY --from=build-project-a /output/ /build-a
COPY --from=build-project-b /output/ /build-b

提问：
是否可以参数化构建阶段，使其根据给定的参数生成多个镜像产物？或者说，是否存在如下等效于上述显式Dockerfile的语法？

FROM base AS build-project
RUN ${SRC_DIR}/build.sh # Builds to /output

FROM base AS run-both
COPY --from=build-project-a --build-arg=SRC_DIR=/src-a /output/ /build-a
COPY --from=build-project-b --build-arg=SRC_DIR=/src-b /output/ /build-b

这种实现是否可行？若可行，具体该如何操作？

实际场景痛点：存在大量步骤相似但难以重构为辅助脚本的构建阶段——辅助脚本虽能减少Dockerfile行数，但会牺牲步骤缓存能力（若将多个RUN合并到脚本中）；此外，RUN的BuildKit参数、COPY步骤等无法放入脚本；而分开构建又会破坏并行性。

可行性与实现方法 #

你设想的原生Dockerfile语法写法不可直接实现，但借助Docker BuildKit特性和外部工具，可以达成类似效果，同时保留缓存和并行构建能力：

方法1：BuildKit参数化目标+并行构建 #

1. 编写通用化Dockerfile，定义可参数化的构建阶段：

ARG SRC_DIR
ARG BUILD_STAGE_NAME=build-project

FROM base AS ${BUILD_STAGE_NAME}
ARG SRC_DIR
RUN ${SRC_DIR}/build.sh # Builds to /output

FROM base AS run-both
COPY --from=build-project-a /output/ /build-a
COPY --from=build-project-b /output/ /build-b

2. 并行构建多个目标阶段，最后合并产物：

# 后台并行执行两个构建阶段，保留各自缓存
docker build --build-arg SRC_DIR=/src-a --target build-project-a --tag build-a . &
docker build --build-arg SRC_DIR=/src-b --target build-project-b --tag build-b . &
wait
# 构建最终合并镜像
docker build --target run-both --tag run-both .

方法2：Docker Compose多服务并行构建 #

1. 编写docker-compose.yml定义多构建服务：

version: "3.8"
services:
  build-a:
    build:
      context: .
      args:
        SRC_DIR: /src-a
      target: build-project
    image: build-a
  build-b:
    build:
      context: .
      args:
        SRC_DIR: /src-b
      target: build-project
    image: build-b
  run-both:
    build:
      context: .
      target: run-both
    image: run-both
    depends_on:
      - build-a
      - build-b

2. 执行并行构建：

docker-compose build --parallel

Compose会自动并行处理build-a和build-b，完成后再构建合并镜像，全程保留各步骤缓存。

方法3：模板引擎动态生成Dockerfile #

如果需要完全复用构建逻辑，用模板工具生成最终Dockerfile：

1. 创建Dockerfile.j2模板：

{% for proj in projects %}
FROM base AS build-project-{{ proj }}
RUN /src-{{ proj }}/build.sh # Builds to /output
{% endfor %}

FROM base AS run-both
{% for proj in projects %}
COPY --from=build-project-{{ proj }} /output/ /build-{{ proj }}
{% endfor %}

2. 编写脚本生成Dockerfile（可通过环境变量传递项目列表）：

# 定义需要构建的项目，可灵活修改
projects="a b"
jinja2 Dockerfile.j2 -D projects="$projects" > Dockerfile

3. 正常构建：

docker build --tag run-both .

生成的Dockerfile与原始示例完全等效，BuildKit会自动并行处理独立的构建阶段，同时保留每个步骤的缓存。

场景痛点优化说明 #

• 缓存保留：所有方法均未合并RUN步骤到脚本，单个项目的构建修改只会影响对应阶段的缓存，不会失效全局缓存。
• BuildKit参数支持：在Dockerfile的RUN指令中可直接添加BuildKit参数（如RUN --mount=type=cache,target=/cache ${SRC_DIR}/build.sh），无需依赖外部脚本。
• 并行性保障：三种方法均支持多构建阶段并行执行，不会因参数化重构降低构建效率。

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