imicola Docker 构建
Docker 构建

Docker 构建

319 字 · 约 1 分钟

说到底这还是一个集群项目,所以我们也是需要将整个模块构建成一个 container 才能进入集群中

所以就需要 Docker 的构建

我们的标准构建指令是:

docker build -f module/maintenance-controller/dockerfile.controller -t maintenance-controller:w45 module/maintenance-controller
powershell

其中 -f 指定的是构建规则文件的具体位置,最后的参数中的 module/maintenance-controller 是真正的构建上下文

在 Dockerfile 中写 COPY go.mod go.sun ./ 时,Docker 引擎是以这个上下文根目录为基准去寻找文件的。所以在打构建命令的时候不能将上下文给弄混了

两阶段构建

我们的 dockerfile.controller 采用两阶段构建:

  • 构建阶段 (builder): 基于完整的 golang:1.24-alpine 镜像构建出完全静态的纯 Linux 二进制可执行文件
  • 运行阶段 (runtime): 丢弃所有的 Go 编译工具链,直接基于极简的 distroless/static:nonroot 镜像,以非 root 用户启动

显式双入口设计

在 main.go 中,我们提供了两种运行模式,通过启动参数 --mode 显式区分:

  • --mode local: 开发测试阶段的本地运行,控制器跑在本地主机,直接调试代码
  • --mode in-cluster: 生产部署阶段,控制器打包为容器跑在 Pod 内部