如何在Docker多阶段构建中使用多个独立镜像作为基础

针对你需要将多个独立组件阶段合并为单一最终镜像、同时优化缓存效率的需求，以下是两种实用方案：

方案一：BuildKit挂载合并独立阶段 #

利用Docker BuildKit的文件系统挂载能力，将每个独立组件阶段的文件系统完整合并到最终镜像中，同时保留各组件对环境的修改：

# 基础阶段：安装通用依赖（如Python）
FROM ubuntu:22.04 AS base
RUN apt-get update && apt-get install -y python3 python3-pip

# 独立组件阶段：安装pytest，完全基于base
FROM base AS with_pytest
RUN pip install pytest
# 若组件修改了环境变量，在此处显式声明
ENV PATH="/usr/local/lib/python3/dist-packages:$PATH"

# 独立组件阶段：安装pyyaml，同样基于base
FROM base AS with_yaml
RUN pip install pyyaml

# 最终镜像：合并所有独立组件
FROM base AS final_image
# 合并with_pytest的所有文件与环境配置
RUN --mount=from=with_pytest,source=/,target=/tmp/pytest \
    cp -a /tmp/pytest/. / && \
    # 提取并设置组件的环境变量
    echo "$(docker inspect --format '{{range $e := .Config.Env}}export {{$e}}{{"\n"}}{{end}}' with_pytest)" >> /etc/profile.d/component_env.sh

# 合并with_yaml的所有文件与环境配置
RUN --mount=from=with_yaml,source=/,target=/tmp/yaml \
    cp -a /tmp/yaml/. / && \
    echo "$(docker inspect --format '{{range $e := .Config.Env}}export {{$e}}{{"\n"}}{{end}}' with_yaml)" >> /etc/profile.d/component_env.sh

优势 #

• 各组件阶段完全独立，修改任意组件仅需重建该阶段与最终合并步骤，不影响其他组件的缓存
• 完整保留组件对文件系统和环境变量的修改，无需手动复制零散文件

注意事项 #

• 需启用Docker BuildKit（构建时添加DOCKER_BUILDKIT=1前缀）
• 若多个组件修改了同一文件，后执行的合并步骤会覆盖之前的内容，需确保组件间无冲突

方案二：单阶段+缓存挂载简化构建 #

如果组件间无明显冲突，可直接在单阶段内拆分独立的安装命令，利用BuildKit的缓存挂载优化构建效率：

FROM ubuntu:22.04 AS final_image
# 安装基础依赖
RUN apt-get update && apt-get install -y python3 python3-pip

# 独立安装pytest，挂载pip缓存避免重复下载
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install pytest

# 独立安装pyyaml，复用同一pip缓存
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install pyyaml

# 其他组件安装同理，每个组件一个独立RUN命令

优势 #

• 配置简单，可读性强，无需复杂的多阶段复制逻辑
• 每个组件的安装步骤独立缓存，修改某组件仅需重新运行对应RUN命令
• 环境变量自动继承，无需额外处理

注意事项 #

• 组件间若存在依赖关系，需按依赖顺序排列RUN命令
• 若组件修改了同一系统文件，需确保修改逻辑无冲突

方案选择建议 #

• 若组件间可能存在文件或环境变量冲突，优先选择方案一，通过独立阶段隔离后再合并
• 若组件独立无冲突，方案二更简洁高效，适合快速搭建开发环境

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