容器与云原生 / 系统课时

使用多阶段构建

使用多阶段构建

本课解决生产镜像体积过大、包含无用构建工具的问题,通过 Docker 多阶段构建拆分编译环境和运行环境,只复制最终产物,生成更轻量、更安全的镜像。

学习目标

  • 理解多阶段构建中不同阶段的职责划分
  • 掌握从构建阶段复制运行产物的方法
  • 能够验证最终镜像是否只包含生产依赖

多阶段构建的核心思想

传统 Dockerfile 往往把依赖下载、源码编译和应用运行写在同一个镜像中,导致最终镜像包含编译器、缓存文件和开发依赖。

多阶段构建允许一个 Dockerfile 定义多个 FROM 阶段。前面的阶段负责构建,后面的阶段只复制需要运行的文件,因此最终镜像不需要携带完整开发环境。

Docker 多阶段构建产物流转图

编写多阶段 Dockerfile

下面以 Go 应用为例,第一阶段负责编译二进制文件,第二阶段只保留运行程序。

dockerfile
# 构建阶段
FROM golang:1.24-alpine AS builder

WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN go build -o app ./cmd/server

# 运行阶段
FROM alpine:3.22

WORKDIR /app
COPY --from=builder /src/app ./app

EXPOSE <PORT>
CMD ["./app"]

预期结果

text
构建阶段生成 /src/app
运行阶段镜像中只包含 /app/app 和运行所需基础环境

COPY --from=builder 是多阶段构建的关键,它让不同阶段之间只传递明确需要的文件。

选择阶段边界

阶段划分应该围绕产物边界设计,而不是简单拆分命令。常见划分方式包括:

  • 依赖准备阶段:下载并缓存第三方依赖
  • 构建阶段:编译源码或生成静态资源
  • 测试阶段:执行自动化测试和质量检查
  • 运行阶段:提供最小生产环境

如果测试步骤不影响最终镜像,可以单独作为中间阶段存在,避免测试工具进入生产环境。

验证镜像优化效果

构建完成后,可以通过镜像查看命令比较优化前后的大小。

bash
docker build -t optimized-app:<ID> .
docker image inspect optimized-app:<ID> --format '{{.Size}}'

预期输出

text
镜像大小以字节数形式输出,例如:52346880

实际大小会受到基础镜像、依赖数量和应用类型影响,但多阶段构建通常可以明显减少无关文件。

常见失败处理

多阶段构建失败通常来自复制路径错误或遗漏运行依赖。排查时优先检查:

  • COPY --from 指向的文件是否真实存在
  • 运行阶段是否缺少动态库或配置文件
  • 构建阶段生成的文件权限是否满足运行要求

对于需要动态链接库的程序,不能只复制单个二进制文件,需要同步复制必要运行依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用多阶段构建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通