Docker 容器化 Go 服务的几个实战细节

多阶段构建：让镜像小到 10MB 以内

Go 是静态编译语言，只需要编译后的二进制文件，不需要运行时环境。多阶段构建可以分离构建环境和运行环境，最终镜像只包含二进制文件。

# 阶段1：构建
FROM golang:1.23-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags='-w -s' -o server .

# 阶段2：运行
FROM alpine:3.19
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
WORKDIR /app
COPY --from=builder /app/server .
RUN chmod +x server
USER appuser
CMD ["./server"]

利用 Docker BuildKit 加速构建

# 启用 BuildKit
export DOCKER_BUILDKIT=1

# 并行下载依赖，大幅加速
docker build --progress=plain -t myapp:latest .

健康检查：让 K8s/Compose 知道服务已就绪

在 Dockerfile 里加上 HEALTHCHECK，让 orchestrator 在服务真正能接收请求时才将其加入负载均衡。

HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
  CMD wget -qO- http://localhost:8080/health || exit 1

环境变量注入的坑

Go 程序默认会在 ENV 改变时重新加载，但 Docker 层会缓存 ENV。用 ENTRYPOINT 脚本或 Viper 动态读取，比硬编码 ENV 常量更灵活。

小结

Docker 化 Go 服务的核心是：镜像要小（多阶段构建）、构建要快（BuildKit）、健康要可感知。做到这三点，生产部署就没什么大问题了。

来源：https://www.dnote.cn