直接集成需分场景:读状态用client-go,响应变更和管理CRD必须用controller-runtime+kubebuilder;本地调试用BuildConfigFromFlags,Pod内运行用InClusterConfig,二者混用必致部署失败。

能直接集成,但必须分清场景:读状态用 client-go 就够了;要自动响应变更、管理自定义资源,就得上 controller-runtime + kubebuilder。
连接集群时,BuildConfigFromFlags 和 InClusterConfig 别混用
本地调试和 Pod 内运行的认证路径完全不同,硬写死一种会导致部署即失败。
- 开发机跑脚本:用
clientcmd.BuildConfigFromFlags("", "/path/to/kubeconfig"),确保~/.kube/config可读且当前 context 有效 - Operator 或控制器跑在集群内:必须用
rest.InClusterConfig(),它会自动读/var/run/secrets/kubernetes.io/serviceaccount/下的 token 和 ca.crt - 常见错误:
open /var/run/secrets/kubernetes.io/serviceaccount/token: permission denied—— 容器以非 root 用户启动且没显式挂载 serviceaccount 目录,或挂载权限被 drop - 无论哪种方式,拿到
config后务必检查config.Host != "" && config.BearerToken != "",否则后续所有 API 调用静默失败
操作资源时,别拼 YAML,用官方 struct 构造对象
硬编码字符串 YAML 看似快,但字段错一位、缩进多一格、label 键含大写字母,都会导致 Apply 失败或行为异常。
- Deployment 必须满足:
dep.Spec.Selector.MatchLabels和dep.Spec.Template.Metadata.Labels完全一致,否则创建报错field is immutable - 镜像名必须含 registry 地址(如
ghcr.io/user/app:v1.2),不能只写app:v1.2,否则拉取失败且事件里只显示ImagePullBackOff,无具体 registry 提示 - 更新 Deployment 时优先用
Patch()(比如只改Image字段),避免Update()全量提交——会意外覆盖掉Annotations或ManagedFields - 构造 label selector 时用
labels.Set{"env": "prod"}.AsSelector(),比手写env=prod字符串更安全,自动校验 key 格式(DNS 子域规则)
等待资源就绪时,轮询不是“查一次就完事”
Kubernetes 所有变更都是异步的。Deployment 更新后,新 Pod 可能卡在 Pending(调度失败)、ContainerCreating(镜像拉取慢)、Running 但未就绪(readiness probe 失败)——这些状态不会自动抛错,得自己盯。
- 检查条件至少两个:
dep.Status.UpdatedReplicas == *dep.Spec.Replicas且dep.Status.AvailableReplicas == *dep.Spec.Replicas - 超时设 300 秒,轮询间隔 3–5 秒;超过阈值直接返回 error,方便上层触发回滚逻辑
- 可选监听事件流:
clientset.CoreV1().Events("default").Watch(),过滤Event.Type == "Warning",捕获FailedScheduling、ImagePullBackOff等关键异常 - 注意:
Status字段是 server-side 更新的,不要在 client 侧缓存旧对象反复读取,每次都要重新Get()或List()
真正容易被忽略的是 finalizer 和 ownerReference 的处理——比如删除 CRD 实例时,若 controller 没正确设置 finalizer 并在 cleanup 完成后移除,资源会一直卡在 Terminating 状态。这问题不常出现,但一旦发生,只能手动 patch 删除 finalizer,线上排障成本极高。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











