容器与云原生 / 系统课时

使用多阶段构建优化镜像

使用多阶段构建优化镜像

多阶段构建让编译工具、源码和中间产物停留在构建阶段,只把运行真正需要的文件复制到最终阶段。这样既能保留完整的编译流程,又能避免把编译器、依赖缓存和源代码一起交付到生产镜像。

学习目标

  • 理解多个 FROM 阶段之间的职责边界
  • 使用 COPY --from 只传递最终运行产物
  • 验证最终镜像中不再包含编译工具链

构建阶段与运行阶段如何分工

Dockerfile 可以包含多个 FROM。每个 FROM 开启一个新的构建阶段,前面的阶段可以安装编译器、下载依赖并生成产物,后面的阶段再选择性复制这些产物。

最终生成的镜像默认来自最后一个阶段,因此前面阶段中的 Go 编译器、源码和临时文件不会因为曾经参与构建就自动进入最终镜像。

Docker 多阶段构建产物流向

构建一个最小 Go 示例

先创建 go.mod:

text
module example.com/multistage

go 1.22

再创建 main.go:

go
package main

import "fmt"

func main() {
	fmt.Println("hello from multi-stage")
}

Dockerfile 使用命名阶段 build 编译静态二进制,然后只把结果复制到运行阶段:

dockerfile
FROM golang:1.24-alpine AS build
WORKDIR /src

COPY go.mod ./
COPY main.go ./
# 关闭 CGO,使生成的程序不依赖构建阶段的 C 运行库
RUN CGO_ENABLED=0 GOOS=linux go build -o /out/app .

FROM alpine:3.21
WORKDIR /app
COPY --from=build /out/app ./app
CMD ["./app"]

COPY --from=build 中的 build 来自第一阶段的名称。Docker 只复制 /out/app,不会把 /usr/local/go、/src/main.go 或第一阶段安装的其他文件一起带入最终阶段。

构建并运行最终镜像

在三个文件所在目录执行构建:

bash
docker build -t multistage-demo .
docker run --rm multistage-demo

预期输出:

text
hello from multi-stage

构建日志会同时出现两个阶段,但最终标签 multistage-demo 指向最后的运行阶段。具体步骤编号、下载进度和耗时属于动态输出。

验证编译器没有进入生产镜像

可以直接在最终容器中检查 go 命令。由于最终阶段基于 Alpine 且只复制了应用二进制,正常情况下找不到 Go 工具链。

bash
docker run --rm multistage-demo sh -c 'command -v go || echo "go-not-found"'

预期输出:

text
go-not-found

这个验证比只观察镜像大小更直接:生产镜像确实没有继承构建阶段的编译器。源码和构建缓存同样不会自动存在于最后阶段,从而减少不必要的软件包和潜在攻击面。

控制阶段之间的传递边界

多阶段构建的关键不是简单写多个 FROM,而是严格控制跨阶段复制内容。不要为了省事把整个工作目录执行 COPY --from=build /src /app,否则源码、测试文件和临时产物仍可能进入最终镜像。

如果应用运行时需要 CA 证书、时区数据、动态链接库或其他系统文件,也必须在最终阶段明确安装或复制。构建阶段能够成功运行,并不意味着最后阶段天然具备相同环境。

把编译环境和运行环境分开后,Dockerfile 同时承担了两项职责:前半部分保证产物可重复构建,后半部分定义生产环境真正需要交付的最小文件集合。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用多阶段构建优化镜像

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

登录哪都通