kubernetes python客户端需正确配置认证、api版本与资源操作逻辑：本地用load_kube_config()读~/.kube/config，集群内用load_incluster_config()读serviceaccount；label_selector须为字符串格式；推荐手动构造v1deployment而非yaml；滚动更新应检查progressing条件而非仅ready_replicas。
kubernetes 官方 Python 客户端不是“装上就能跑”的胶水库——它依赖准确的认证配置、明确的 API 版本选择，以及对资源操作幂等性的理解。直接写 v1.list_pod_for_all_namespaces() 报错，大概率不是代码问题，而是连接或权限没对。
怎么选对 config 加载方式：本地开发 vs 集群内运行
本地调试脚本必须用 config.load_kube_config()，它默认读取 ~/.kube/config；这个文件若被 chmod 777 或含过期 token，load_kube_config() 会静默失败（不抛异常，但后续所有 API 调用返回 403）。集群内 Pod 中运行则必须用 config.load_incluster_config()，它从 /var/run/secrets/kubernetes.io/serviceaccount/ 自动加载 token 和 ca.crt —— 如果你的 Pod 没绑定 ServiceAccount 或该目录不存在，会直接报 ConfigException: Service account token file not found。
常见错误现象：
- 本地运行时提示
ValueError: Unable to load kube-config→ 检查KUBECONFIG环境变量是否指向了错误路径 - 集群内运行报
MaxRetryError或SSLError→ 很可能是 CA 证书未挂载或host配置被手动覆盖（load_incluster_config()不走 host 字段）
label_selector 怎么写才生效：字符串拼接陷阱
label_selector 参数只接受字符串，不接受 dict 或 list。写成 label_selector={"app": "nginx"} 会静默忽略条件，返回全量结果；写成 label_selector="app=nginx,env in (prod,staging)" 才是合法语法。逗号分隔多个等值条件，空格不能省略（env in(prod,staging) 会解析失败）。
使用场景：
- 批量下线测试 Pod：
label_selector="env=staging,team=frontend" - 排除特定组件：
label_selector="app!=prometheus,component!=etcd" - 集合匹配注意括号必须是英文半角，且值之间用英文逗号，
env in (prod, staging)中的空格会导致解析失败
创建 Deployment 别直接传 YAML：用 client.Model 构造更可控
虽然 utils.create_from_yaml() 支持直接加载 YAML 文件，但它会递归创建全部资源（含 Namespace、ServiceAccount），容易引发权限冲突或命名空间不存在错误。生产脚本推荐用 client.V1Deployment + client.V1PodTemplateSpec 手动构造对象。
关键差异点：
-
utils.create_from_yaml()返回None，无法获取创建后的 resource_version - 手动构造可精确控制字段，比如设置
deployment.spec.strategy.rolling_update.max_unavailable = "25%"，而 YAML 方式需确保字段嵌套层级完全匹配 - YAML 中的
!!str或注释可能被yaml.safe_load()吞掉，导致replicas: 3变成字符串"3"，触发 API Server 的类型校验失败（Invalid value: "3": replicas in body must be of type integer）
滚动更新失败时怎么定位：别只看 status.ready_replicas
调用 apps_v1.patch_namespaced_deployment() 后，status.ready_replicas 为 0 不代表失败——可能只是新 ReplicaSet 还在拉镜像。真正要轮询的是 deployment.status.conditions 中类型为 Progressing 的 condition，其 reason 字段会明确给出卡点（如 NewReplicaSetAvailable 表示就绪，ProgressDeadlineExceeded 表示超时）。
性能影响：
- 每秒轮询一次
read_namespaced_deployment()对 API Server 压力较小，但若同时监控上百个 Deployment，建议改用watch.Watch().stream(apps_v1.list_deployment_for_all_namespaces)订阅事件流 - watch 流不会自动重连，网络抖动后需捕获
urllib3.exceptions.ProtocolError并重建 watch 实例
load_incluster_config() 成功后，client.Configuration.get_default_copy() 返回的对象仍可能被其他模块意外修改 —— 建议每次创建 API 实例前，显式调用 client.Configuration.set_default(client.Configuration()) 重置全局配置。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
