Docker 多阶段构建:把 Go 镜像从几百 MB 瘦到十几 MB
把 Go 程序放进 Docker,最容易踩的坑是镜像越做越大:一个 golang 基础镜像本身就几百 MB,再装上构建工具、源码、缓存,打出来的镜像常常超过 1GB。部署时每次拉取都要传这么大的包,又慢又占磁盘。多阶段构建就是解决这个问题的标准做法:一个阶段负责编译,另一个阶段只负责运行,最后镜像里只留运行必需的东西。
第一阶段用 golang 镜像做构建。Dockerfile 里先 FROM golang:1.22-alpine AS builder,设置工作目录,把 go.mod 和 go.sum 先拷进去跑 go mod download,这样依赖层可以被缓存;只有 go.mod 变了才重新下载依赖,改业务代码时不用重复下载。再把源码拷进去,执行 CGO_ENABLED=0 GOOS=linux go build -o app .,得到一个静态编译的二进制文件。CGO_ENABLED=0 很关键:它让二进制不依赖系统里的 C 库,后面才能放进一个几乎空的运行镜像里。
第二阶段用尽量小的运行镜像。FROM alpine:latest,装一个 ca-certificates 就够了(程序要调 HTTPS 接口时需要根证书),再把第一阶段编译好的二进制 COPY --from=builder /app/app /app,设好 EXPOSE 和 CMD。最终镜像里没有 Go 工具链、没有源码、没有编译缓存,只有几 MB 的二进制加一个十几 MB 的 alpine,总体十几到二十 MB,和原来几百 MB 甚至 1GB 的镜像比,拉取速度和磁盘占用都完全是另一个量级。更极端的做法是用 scratch 空镜像,连 alpine 都不要,镜像可以压到只有二进制本身的大小,但要自己处理时区文件和根证书,适合对体积特别敏感的场景。
多阶段构建还有一个附带好处:构建环境和运行环境彻底分开。构建阶段装什么工具、用什么版本,都不会污染运行镜像;运行镜像里没有编译器和包管理器,攻击面也小得多。配合 .dockerignore 把 .git、本地配置文件、测试数据排除在构建上下文之外,构建更快,也不会把敏感文件误打进镜像。
改代码重新构建时,Docker 的层缓存会发挥作用:依赖没变就复用依赖层,只有源码层和编译层重新执行。发布流程也因此变简单:docker build -t ordering-backend:v2 .,再 docker run -d --name ordering --restart unless-stopped -p 8080:8080 ordering-backend:v2,旧容器删了重建,代码就更新了。镜像小,拉取快,回滚也快——出问题直接用旧版本的镜像重新起一个容器,几秒就能恢复。
镜像瘦身不是为了好看:镜像越小,拉取越快、磁盘占用越少、启动越快、攻击面越小。一个 Go 服务配上多阶段构建,十几 MB 的镜像跑在云服务器上,才是部署该有的样子。
- 点赞
- 收藏
- 关注作者
评论(0)