Operator停机逻辑不能复用Web服务方案,因其本质是长期运行的reconcile循环而非HTTP服务器,无http.Server.Shutdown();必须将SIGTERM等信号注入mgr.Start(ctx)的根context,否则manager无法退出、reconcile持续运行、CRD finalizer卡住。

为什么Operator的停机逻辑不能复用Web服务那一套
Operator本质是长期运行的控制循环(reconcile loop),不是HTTP server,http.Server.Shutdown()根本不存在。它靠mgr.Start(ctx)阻塞运行,退出信号必须传给manager的context,否则整个reconcile loop会卡在WaitForCacheSync或event handler里不动。你如果照搬Web服务里“监听SIGTERM → 调Shutdown → 关DB”的流程,会发现进程收不到信号、或收到后reconcile还在发请求、甚至CRD finalizer卡住不清理。
signal.Notify必须绑定到manager的ctx,而不是另起一个
Operator启动时调用mgr.Start(ctx),这个ctx就是整个生命周期的根上下文。停机信号必须注入这里,否则manager无法感知退出。常见错误是单独开个sigChan、后再<code>cancel()——这只会取消你自己的ctx,manager仍在用原始ctx跑。
- 正确做法:用
ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)(Go 1.16+)直接生成带信号感知的ctx,再传给mgr.Start(ctx) - 老版本Go(sigChan := make(chan os.Signal, 1) →
signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)→ 启goroutine监听sigChan并调cancel() - 别漏掉
defer cancel(),否则context泄漏,goroutine持续监听ctx.Done()不退出
Reconciler里怎么安全响应停机信号
Reconciler函数本身不接收ctx参数(除非你手动加),但所有client操作(如client.Get()、client.Update())都支持传ctx。关键在于:停机信号触发cancel()后,这些client调用会立刻返回context.Canceled错误,你得捕获它并提前return,而不是继续执行CR更新或finalizer清理。
- 每个reconcile入口第一行加
if ctx.Err() != nil { return ctrl.Result{}, ctx.Err() } - Finalizer移除逻辑必须判
ctx.Err(),否则可能卡在client.Update()里,导致CR永远带finalizer,K8s不会真正删除资源 - 长轮询或watch类操作(如
client.Watch())必须用ctx,否则停机时goroutine悬空 - 避免在reconcile里起新goroutine却不传ctx——它们不会随manager退出而终止
非K8s资源(DB、gRPC、Metrics)关闭顺序很关键
Operator常连etcd(通过client-go)、Prometheus(metrics registry)、数据库(存状态快照)。这些资源关闭顺序错了,轻则panic,重则数据不一致:比如先关DB连接池,但某个reconcile还在用db.QueryRow(),就直接panic;或者先停metrics,但shutdown日志还想打指标,就静默失败。
立即学习“go语言免费学习笔记(深入)”;
- 正确顺序:等
mgr.Start()返回(即所有controller已注册并开始reconcile)→ 收到信号 → 立即停止新reconcile入队 → 等正在跑的reconcile自然结束(靠上面的ctx判断)→ 关闭DB/gRPC → 最后注销metrics、清理临时文件 - 用
sync.WaitGroup等后台goroutine退出,但别等太久——超时后强制os.Exit(0),避免被K8s强杀 - K8s环境要配
terminationGracePeriodSeconds: 45,比你的停机总耗时多5秒,留出preStop和内核清理时间
最易被忽略的一点:Operator的“优雅”不体现在HTTP层,而在于finalizer能否干净摘除、cache是否同步完成、以及所有异步watch goroutine是否真正退出。哪怕只漏掉一个ctx传递,都可能导致CR卡在Terminating状态,后续发布全被block。


















