Docker 构建
说到底这还是一个集群项目,所以我们也是需要将整个模块构建成一个 container 才能进入集群中
所以就需要 Docker 的构建
我们的标准构建指令是:
docker build -f module/maintenance-controller/dockerfile.controller -t maintenance-controller:w45 module/maintenance-controllerpowershell其中 -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 内部