必须用client-go初始化配置:in-cluster环境用rest.InClusterConfig()自动读取ServiceAccount的token和ca.crt,本地调试用clientcmd.BuildConfigFromFlags()传绝对路径;需显式设置QPS/Burst防限流,资源操作须匹配对应GroupVersion client。

必须用 client-go 初始化配置,不能手写 HTTP 客户端;核心是根据运行环境选对 rest.Config 构造方式,否则 401、x509 或 watch 断连是必然结果。
in-cluster 环境下用 rest.InClusterConfig() 但 Pod 必须挂载 ServiceAccount
Pod 内运行时,rest.InClusterConfig() 会自动读取 /var/run/secrets/kubernetes.io/serviceaccount/ 下的 token 和 ca.crt。但它不会帮你解决权限问题:
- Pod 的
serviceAccountName字段必须显式设置,且该 SA 需绑定含对应 RBAC 权限的RoleBinding或ClusterRoleBinding - 若漏挂 CA 文件(比如手动改了 volume mount),
client-go会 panic 报x509: certificate signed by unknown authority,不是连接超时 - 不支持 OIDC 等外部认证插件——
InClusterConfig只认 ServiceAccount token
本地调试用 clientcmd.BuildConfigFromFlags() 但路径不能硬编码 ~/.kube/config
开发机上依赖 ~/.kube/config 是常见做法,但直接写死路径会导致 CI 或多用户环境失败:
- 传空字符串
""作为第一个参数(即master URL),第二个参数传绝对路径,例如"/home/user/.kube/config";相对路径会被忽略 - 若 kubeconfig 含多个 context,需先调用
clientcmd.NewDefaultClientConfigLoadingRules().Load()获取 config,再用clientcmd.NewNonInteractiveDeferredLoadingClientConfig()指定 context 名 - Windows 下路径分隔符要用
/或双反斜杠,单反斜杠在 Go 字符串里是转义符,容易导致文件未找到
初始化 rest.Config 后必须设 QPS 和 Burst 防限流
默认配置下,client-go 的 QPS=5、Burst=10,对轻量工具够用,但批量操作或 Watch 多资源时极易被 apiserver 限流,表现是大量 429 Too Many Requests 错误:
立即学习“go语言免费学习笔记(深入)”;
- 在拿到
config后、构造clientset前,显式设置:config.QPS = 20,config.Burst = 30 - 生产级 Watch(如 Informer)建议再降低一点,避免抢占集群控制面带宽;调试时可临时提到 50/60
- 别设
0或负数,client-go会 panic:invalid QPS value
clientset.CoreV1() 不等于所有资源,CRD 和部分内置资源要换 client
CoreV1 只覆盖 Pod、Service、ConfigMap 等核心资源。其他资源必须用对应 GroupVersion 的 client:
-
Deployment、StatefulSet属于apps/v1→ 用clientset.AppsV1() -
HorizontalPodAutoscaler是autoscaling/v2→ 用autoscalingv2.NewForConfig(config) - 自定义 CRD(如
MyApp)无法用clientset,得用dynamic.NewForConfig(config)+unstructured.Unstructured - 漏用错 client 会导致
the server could not find the requested resource,而不是权限错误
最容易被忽略的是 TLS 配置:哪怕你用 InClusterConfig,如果集群启用了 mTLS 且你的 SA 没配 client.crt/client.key,client-go 仍会静默 fallback 到单向 TLS,某些策略严格的集群会拒绝连接——此时必须手动构造 rest.Config 并填全 TLSClientConfig 字段。


















