调试集群中的 Pod
调试流程概览
下图展示了调试 Kubernetes 集群中 Pod 的完整流程图：
基础状态检查
获取 Pod 状态
首先使用以下命令获取 Pod 的基本状态信息：
kubectl get pods -o wide
查看详细信息
针对有问题的 Pod，查看其详细描述信息：
kubectl describe pod <pod-name>
Pending 状态问题排查
当 Pod 处于 Pending 状态时，通常表示调度或资源分配存在问题。
节点状态检查
检查集群节点的健康状态：
kubectl get nodes
kubectl describe node <node-name>
如果节点状态为 NotReady，需要解决以下可能的问题：
- 磁盘压力（DiskPressure）
- 内存压力（MemoryPressure）
- PID 压力（PIDPressure）
- 网络连接问题
资源配额验证
检查命名空间的资源配额限制：
kubectl describe quota -n <namespace>
kubectl describe limitrange -n <namespace>
调度约束检查
验证以下调度相关配置：
- 节点选择器：检查 nodeSelector 配置
- Taints 与 Tolerations：确认节点污点与 Pod 容忍度匹配
- 亲和性规则：验证节点亲和性和 Pod 亲和性规则
- 资源请求：确认 CPU 和内存请求是否合理
存储问题排查
检查 PVC（持久卷声明）状态：
kubectl get pvc
kubectl describe pvc <pvc-name>
运行时问题诊断
应用日志分析
查看 Pod 内应用程序的日志：
kubectl logs <pod-name> -c <container-name>
kubectl logs <pod-name> --previous # 查看上一次重启前的日志
容器状态检查
检查容器的运行状态和重启历史：
kubectl get pods <pod-name> -o jsonpath='{.status.containerStatuses[*].restartCount}'
网络连接排障
服务配置验证
检查 Service 配置和端点：
kubectl get svc
kubectl describe svc <service-name>
kubectl get endpoints <service-name>
Ingress 配置检查
验证 Ingress 规则配置：
kubectl get ingress
kubectl describe ingress <ingress-name>
网络策略分析
检查是否有网络策略影响 Pod 通信：
kubectl get networkpolicy
kubectl describe networkpolicy <policy-name>
网络连通性测试
使用工具 Pod 进行网络连通性测试：
kubectl run debug-pod --image=nicolaka/netshoot -it --rm -- /bin/bash
高级调试技巧
进入容器调试
直接进入 Pod 容器进行调试：
kubectl exec -it <pod-name> -- /bin/bash
端口转发
将本地端口转发到 Pod 端口进行调试：
kubectl port-forward <pod-name> 8080:80
资源使用监控
实时监控 Pod 资源使用情况：
kubectl top pods
kubectl top nodes
最佳实践建议
- 系统化排查：按照流程图逐步检查，避免遗漏关键环节
- 日志集中化：建议使用日志聚合工具进行集中管理
- 监控告警：设置完善的监控和告警机制
- 文档记录：记录常见问题和解决方案，建立知识库
- 定期检查：定期检查集群健康状态，预防问题发生
通过这套系统化的故障排除指南，集群管理员可以快速定位和解决 Kubernetes 环境中的 Pod 相关问题，提高运维效率和系统稳定性。