如何在Docker多阶段构建中导出指定阶段产物并生成最终镜像

使用Docker BuildKit的多目标输出能力即可满足需求，无需维护两份Dockerfile重复构建，也不会将SQL迁移脚本带入最终生产镜像，具体实现步骤如下：

调整Dockerfile结构 #

在原有多阶段构建逻辑基础上，新增一个独立的文件导出阶段，该阶段不会被纳入最终生产镜像的构建链路：

# 构建阶段：完成业务编译、生成SQL迁移脚本
FROM golang:1.22 AS build
WORKDIR /app
# 执行业务构建、迁移脚本生成的原有逻辑
RUN make build && make generate-migration
# 构建完成后，/app/server 为业务运行二进制，/script.sql 为待导出的迁移脚本

# 独立导出阶段：仅存放需要导出的SQL脚本，不关联业务镜像逻辑
FROM scratch AS sql-export
COPY --from=build /script.sql /script.sql

# 最终生产镜像阶段：仅复制业务运行必需文件，完全不引入SQL脚本
FROM debian:bookworm-slim AS production
WORKDIR /app
COPY --from=build /app/server /app/server
CMD ["/app/server"]

执行构建命令 #

使用docker buildx build配置多输出规则，单次构建即可同时完成文件导出和镜像生成：

docker buildx build \
  --target production \
  --output type=docker,dest=- \
  --output type=local,dest=./migration-export,target=sql-export \
  -t your-business-image:v1 . | docker load

参数说明：

• --target production：指定最终业务镜像的构建阶段，产物和常规构建的业务镜像完全一致
• 第一个--output配置：将production阶段的产物输出为标准Docker镜像格式，通过管道传给docker load直接导入本地镜像列表，和普通docker build生成的镜像使用方式无区别
• 第二个--output配置：指定将sql-export阶段的内容导出到本地./migration-export目录，构建完成后即可在该路径下拿到需要的script.sql文件

方案特性 #

• 无冗余构建：整个构建流程仅执行一次，BuildKit会自动缓存复用所有构建层，不会重复跑编译等耗时步骤
• 生产镜像无冗余：SQL脚本完全不会被复制到最终生产镜像中，不会额外增加镜像体积，也不会残留无业务用途的文件
• 不受阶段顺序限制：导出文件的源阶段不需要放在Dockerfile末尾，可从任意构建阶段提取需要的文件，完全不影响原有业务镜像的构建逻辑

可选优化：调整导出文件权限 #

如果需要修改导出SQL文件的读写权限，可以新增一个轻量临时阶段处理权限，该阶段不会进入最终生产镜像：

# 临时权限调整阶段
FROM busybox AS perm-fix
COPY --from=build /script.sql /script.sql
RUN chmod 0644 /script.sql

# 导出阶段从权限调整阶段复制文件
FROM scratch AS sql-export
COPY --from=perm-fix /script.sql /script.sql

注意：该方案依赖Docker BuildKit，Docker Desktop默认已开启，Linux环境如果使用旧版本Docker，可在构建命令前添加DOCKER_BUILDKIT=1环境变量启用。

内容的提问来源于stack exchange，提问作者Vočko