Operator 必须靠 Reconcile 循环持续对齐状态,否则一次成功后即失联;常见错误包括未用 client.Get() 获取原对象就直接 Update、未走 r.Status().Update() 更新 CR 状态、漏配 Owns() 导致不监听 Deployment 变更,以及 CRD 未安装或 RBAC 权限缺失导致“no matches for kind”错误。

Operator 能自动化操作,但不是写个 client.Create() 就完事——它必须靠 Reconcile 循环持续对齐状态,否则一次成功后就彻底失联。
Reconcile 函数里为什么改了 Deployment 副本数却没生效
常见错误是只调了 client.Update() 或 client.Patch(),但没触发后续状态同步,或压根没把变更写回 API Server。
- 必须先用
client.Get()拿到当前Deployment对象,再修改其.Spec.Replicas字段,最后用client.Update()提交;直接 new 一个对象Create()会报冲突或重复创建 - 如果 Deployment 已存在,优先用
client.Patch(ctx, &dep, client.MergeFrom(&originalDep)),只提交 diff,避免resourceVersion冲突导致失败 - 别忘了更新自定义资源(CR)的
Status:必须走r.Status().Update(ctx, &mycr),用普通client.Update()会返回 404 错误 - 检查是否漏了
Owns(&appsv1.Deployment{})—— 没这句,Controller 就不会监听该 Deployment 的变化,扩缩容后状态无法反馈回 CR
kubebuilder init 后 make run 无反应或报错 “no matches for kind”
这不是代码问题,而是 CRD 没装进集群,或 RBAC 权限缺失导致 Manager 启动后无法 Watch 自定义资源。
- 必须先执行
make install:它把config/crd/bases/下的 YAML 安装到集群,否则client.Get()查不到你的 CR 类型,静默返回IsNotFound - 本地调试时加
ENABLE_WEBHOOKS=false,避免因证书未生成卡在启动阶段:make run ENABLE_WEBHOOKS=false - 确认
config/rbac/role.yaml包含对你 CR 的get、list、watch权限,resources字段必须写成redisclusters(即 CRDspec.names.plural),不能写RedisCluster或rediscluster - 用
kubectl auth can-i list redisclusters -n default快速验证权限是否就绪
如何让 Operator 响应 ConfigMap 变更并自动滚动更新 Pod
默认情况下,Controller 只监听自己管理的 CR,ConfigMap 改了它根本不知道——必须显式建立关联和事件转发。
立即学习“go语言免费学习笔记(深入)”;
- 在
SetupWithManager()中调用Watches(&source.Kind{Type: &corev1.ConfigMap{}}, handler.EnqueueRequestsFromMapFunc(r.configMapToMyApp)),把 ConfigMap 变更映射为对 CR 的 Reconcile 请求 - 实现
configMapToMyApp函数:根据 ConfigMap 的ownerReferences或 label(如app.kubernetes.io/managed-by: myoperator)反查对应 CR 名称,返回[]reconcile.Request - 更稳妥的做法是让 Operator 创建 Deployment 时,自动注入
OwnerReference指向 CR,并在 ConfigMap 上加相同 label;这样后续只需用mgr.GetCache().IndexField()建索引,再配合Owns()即可联动 - 注意:ConfigMap 更新本身不触发 Deployment 滚动,你得在
Reconcile中比对当前 ConfigMap 的ResourceVersion和上次记录值,不一致才 Patch Deployment 触发滚动
真正难的不是第一次创建资源,而是每次变更后都能准确识别“差在哪、该动谁、动完怎么验”。Operator 的健壮性,藏在 Reconcile 函数里对 IsNotFound、IsConflict、ResourceVersion 和 OwnerReference 的每一次判断中。


















