Operator部署需分三步:先安装CRD(须提前生成且顺序正确),再配置RBAC(按需声明权限并匹配scope),最后启动控制器;缺一不可,否则Reconcile不触发、状态不更新、子资源不清理。

Operator 部署不是“构建镜像 + kubectl apply”就完事——它必须分三步走:先装 CRD,再配 RBAC,最后起控制器。跳过任一环,Reconcile 函数根本不会被调用。
CRD 必须在控制器启动前安装,且不能靠 make install 一次到位
很多人执行 make install 后发现自定义资源类型没注册成功,kubectl get mydatabases.database.example.com 报错 error: the server doesn't have a resource type "mydatabases"。这是因为:
-
make install默认只运行kubectl apply -f config/crd/bases/,但该目录下的 YAML 是由make manifests生成的——如果你改过api/v1alpha1/mydatabase_types.go却忘了重新跑make manifests,YAML 就是旧的,字段缺失或版本错乱 - CRD 安装有顺序依赖:如果 CRD 含
conversion或webhook,需先部署 webhook service 和 cert-manager,否则 CRD 会卡在Established=False - 本地调试时(
make run),CRD 必须已存在;集群部署时(make deploy),CRD 清单应优先于 controller Deployment 应用
RBAC 权限不是越宽越好,controller-runtime 的 client 默认走缓存
你给 Operator 的 ServiceAccount 赋了 cluster-admin,Reconcile 还是拿不到 Pod 列表?问题常出在权限粒度和 client 行为上:
-
r.Client(即注入的client.Client)默认读取的是本地缓存,不是实时 API;若 RBAC 没放开list/watch权限,缓存就拉不全,r.List()返回空或漏对象 - 不要直接写
rules: [{verbs: ["*"], apiGroups: ["*"], resources: ["*"]}]——这会让make deploy生成的 RoleBinding 失效(因 clusterrole 绑定到 namespaced SA 会报错) - 正确做法是按需声明:比如你的 Operator 要管理
Deployment、Service、Secret,就在config/rbac/role.yaml里明确列出对应apiGroups、resources和verbs,并确保scope匹配(Namespaced vs Cluster)
make deploy 生成的 Deployment 缺少 OWNERREFERENCE 绑定逻辑
Operator 部署后,它创建的子资源(如 Deployment、Service)没被自动清理,手动删 CR 后残留一堆孤儿资源——这不是 bug,是你没在 Reconcile 里显式设置 OwnerReference:
-
ctrl.SetControllerReference(&mydb, &dep, r.Scheme)必须在每次构造子资源对象时调用,且&mydb必须是刚从r.Get()加载出来的完整实例(含 UID) - 如果用
deepcopy或结构体字面量初始化mydb,UID 是空的,OwnerReference 写进去也没用 - 删除逻辑不能只靠级联:需在
mydb.DeletionTimestamp != nil分支里主动调用r.DeleteAllOf()清理关联资源,尤其当子资源跨 namespace 或用了 Finalizer 时
最易被忽略的一点:Operator 的 Status 字段更新必须用 r.Status().Update() 单独提交,不能塞进普通 r.Update()。后者只改 metadata 和 spec,status 字段会被 API Server 拒绝——这个错误不会报 panic,但会导致监控指标永远不更新。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











