Go语言Operator开发入门_Golang K8s自定义控制器编程-Golang-PHP中文网

reconcile函数写完控制器仍不能运行，必须严格按序完成四步：注册scheme（含client-go和apiextensionsv1）、自动生成crd yaml、status更新用status().update、watch范围与cache命名空间匹配。

go语言operator开发入门_golang k8s自定义控制器编程

Reconcile 函数写完就以为控制器能跑？不行。controller-runtime 的启动、资源注册、CRD 识别、状态更新这四步里，任意一步漏掉或顺序错，都会在 mgr.Start() 阶段 panic 或 reconcile 时静默失败。

controller-runtime 启动前必须完成 scheme 注册

没注册 scheme 就调 mgr.GetClient()，后续所有 Get/List 都会报 no kind "MyApp" is registered for version "example.com/v1"——不是 CRD 没 apply，是 Go 程序根本“不认识”这个类型。

必须按顺序做三件事：

用 runtime.NewSchemeBuilder 收集你的 CR struct（如 &MyApp{}、&MyAppList{}）
显式调 clientgoscheme.AddToScheme(scheme) 和 apiextensionsv1.AddToScheme(scheme)，否则连 CRD 自身都解析不了
确保 MyApp struct 嵌入了 metav1.TypeMeta 和 metav1.ObjectMeta，并实现 runtime.Object 接口

CRD YAML 必须由 controller-gen 自动生成

手写 CRD 容易拼错 spec.group、spec.versions[0].name 或 spec.names.kind，导致 client-go 创建实例时 API Server 返回 404 Not Found 或 400 Bad Request。

正确做法是：

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

在 CR struct 上加 // +kubebuilder:object:root=true 和 // +kubebuilder:subresource:status 注释
运行 make manifests（依赖 controller-gen），它会校验 group/version/kind 对齐关系
生成的 YAML 中 metadata.name 格式必须是 <plural>.<group></group></plural>，比如 myapps.example.com

Reconcile 里更新 status 必须用 `Status().Update`

直接改 struct 的 Status 字段再调 Update()，API Server 会拒绝并返回 Invalid: status.subresources.status 错误——因为 spec 和 status 是两个独立子资源。

安全写法只有这一种：

先 r.Client.Get(ctx, req.NamespacedName, instance) 拿到最新对象
修改 instance.Status.Ready = true 等字段
调 r.Client.Status().Update(ctx, instance) 单独提交 status
如果同时要更新 spec，必须分两步：先 Update() spec，再 Status().Update()，顺序不能反

监听范围不匹配会导致事件收不到

你以为 Watch 了 &MyApp{} 就能收到所有命名空间的变更？默认 cache 是集群级的，但如果你在 manager.Options{Cache: cache.Options{Namespace: "my-ns"}} 里限制了命名空间，而 ctrl.Watch(source.Kind(...)) 没加 predicates.NamespacePredicate，就会出现“CR 创建了但 reconcile 根本不触发”的现象。

检查点有三个：

manager.New(..., manager.Options{Cache: cache.Options{Namespace: "my-ns"}}) 设了命名空间，则所有 Watch 默认只生效于该 ns
若需跨 ns，删掉 Cache.Namespace，或显式传 cache.Options{Namespace: ""}
Watch 时用 ctrl.Watch(source.Kind(mgr.GetCache(), &MyApp{}), predicates.GenerationChangedPredicate{})，避免低频变更被跳过

真正卡住人的从来不是逻辑，而是 scheme 加载时机、Status().Update 的强制分离、以及命名空间过滤和 Watch 范围之间那层看不见的耦合。这些地方一错，日志里既没 panic 也没 error，只有 reconcile 彻底失联。