先初始化Clientset:Pod内用rest.InClusterConfig(),本地用clientcmd.BuildConfigFromFlags("",绝对路径kubeconfig);再调clientset.CoreV1().Pods(ns).List(ctx,opts),ns不可为空。

用 client-go 连上集群并列出 Pod 列表
直接连不上集群,核心是先初始化 client-go 的 Clientset。它依赖 kubeconfig 文件或 service account token,本地开发通常走 ~/.kube/config;在 Pod 里运行则要用 /var/run/secrets/kubernetes.io/serviceaccount/ 下的 token 和 ca.crt。
常见错误:no endpoints available for service "kubernetes" 多半是 config 加载失败,比如路径写错、context 不存在、或用户没权限 —— 先用 kubectl get pods 确认能通再写 Go 代码。
- 加载 config:用
rest.InClusterConfig()(Pod 内)或clientcmd.BuildConfigFromFlags("", kubeconfigPath)(本地) - 初始化 clientset:
kubernetes.NewForConfig(config),别漏掉err检查 - 调用
clientset.CoreV1().Pods(namespace).List(ctx, listOptions),namespace传"default"或具体命名空间,空字符串会报错
创建 Pod 时必须填 ObjectMeta.Name 吗?
不必须,但强烈建议不填 —— 让 API Server 自动生成名字更安全。填了反而容易冲突或被拒绝(比如名字含大写字母、下划线,或已存在同名 Pod)。
真正关键的是 ObjectMeta.GenerateName:设成 "my-pod-",API Server 就会生成类似 my-pod-jk2f9 的唯一名称。同时要确保 ObjectMeta.Namespace 明确指定,否则默认是 "default",可能不是你想要的。
-
ObjectMeta.Name非空 → 必须全局唯一,且符合 DNS-1123 标准(小写字母、数字、连字符,且不能以连字符开头或结尾) -
ObjectMeta.GenerateName非空 → 名字由 server 生成,client 只需保证前缀合法 - 忘记设
Namespace导致 Pod 被创建到default,后续清理或排查时容易遗漏
删除 Pod 怎么避免 “AlreadyExists” 或 “NotFound” 报错
删 Pod 不是“删一次就完事”,得区分场景:是等它彻底消失(同步删),还是发个删除请求就返回(异步删)。默认行为是异步,所以立刻 List 还能看到 Terminating 状态的 Pod。
常见误操作:反复调用 Delete,结果第二次就报 NotFound;或者用 Get 检查存在后再删,中间可能已被其他流程删掉,导致竞态。
- 安全做法:直接调
clientset.CoreV1().Pods(namespace).Delete(ctx, name, deleteOptions),忽略NotFound错误(用errors.IsNotFound(err)判断) - 想等 Pod 真没了?用
WaitForDelete+cache.NewInformer监听,或轮询Get直到返回NotFound -
deleteOptions.PropagationPolicy设成"Background"(默认)或"Foreground",影响关联对象(如 ownerReference)是否级联删除
Watch Pod 变化时为什么连接频繁断开
Watch 不是长连接保活协议,Kubernetes API Server 默认 5 分钟关闭空闲 Watch 连接,客户端收到 http: read on closed response body 或 i/o timeout 很正常。
不能靠单次 Watch 调用撑全场,得自己做重连和断点续传。重点不是“怎么连上”,而是“断了之后怎么接着上次的 resourceVersion 继续看”。
- 每次
Watch返回的Event对象里带Object.GetResourceVersion(),下次重连时传给ListOptions.ResourceVersion - 首次 Watch 建议用
ListOptions.ResourceVersion = "0",表示从当前最新状态开始;后续重连必须用上一次事件里的 version - 别在
for range watchResult.ResultChan()外层套无限for——watchResult本身不重连,要手动Watch新请求
实际写的时候,resourceVersion 的连续性和重连逻辑最容易被跳过,一上来就写死 "0",跑半天才发现漏事件。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











