OpenCNI故障排查手册

1. 概述

OpenCNI是CNI（Container Network Interface）的一个实现，它允许用户在网络层面配置容器。在使用OpenCNI时，可能会遇到各种网络相关的问题和错误，本手册将帮助你快速定位并解决这些常见问题。

2. 常见故障及排查方法

2.1 Pod未正常启动或启动失败

症状描述：

• kubectl get pods 显示Pod处于“ContainerCreating”状态。
• kubectl logs <pod-name> 输出无信息或者错误信息。

排查步骤：

1. 检查网络策略：
   • 确认是否有网络策略阻止了Pod的正常启动，可以使用cilium policy或calicoctl policy命令查看。
2. 检查CNI日志：
   • 查看OpenCNI的日志文件（通常在/var/log/cni目录下），寻找错误信息。
3. 检查Pod网络配置：
   • 检查pod.spec.volumes和pod.spec.containers配置，确保正确的网络插件被使用。

2.2 Pod间通信失败

症状描述：

• 容器间的网络连通性问题，例如ping不通或无法通过服务名相互访问。

排查步骤：

1. 检查CNI配置：
   • 确认所有节点上的cniconfig.json配置文件一致。
2. 检查Pod网络设置：
   • 使用kubectl exec <pod-name> -- ip a查看容器内的IP地址是否正确分配。
3. 检查服务发现机制：
   • 如果使用了DNS服务，确保服务名称解析正常。

2.3 Pod网络流量异常

症状描述：

• 网络带宽受限或丢包严重，影响应用程序性能。

排查步骤：

1. 检查CNI插件版本：
   • 升级到最新稳定版的CNI插件可能解决一些已知问题。
2. 检查网络策略限制：
   • 使用cilium policy list或calicoctl policy get all查看当前网络策略，确保没有不必要的限制。
3. 监控网络流量：
   • 利用tcpdump等工具抓包分析具体流量情况。

2.4 OpenCNI节点级问题

症状描述：

• 节点无法正常加入集群或Pod启动失败。

排查步骤：

1. 检查OpenCNI部署状态：
   • 使用kubectl get pods -n kube-system | grep cni确认所有相关的CNICorePods运行正常。
2. 节点日志分析：
   • 查看节点的日志，寻找与网络相关的信息（如/var/log/kubelet.log）。

2.5 其他问题

对于其他未列出的故障，可以根据以下通用步骤排查：

1. 检查系统资源使用情况：
   • 使用top, htop等工具查看CPU、内存使用率。
2. 网络连接性测试：
   • 在节点之间执行简单的网络命令（如ping）进行基本诊断。
3. 更新OpenCNI组件：
   • 确认所有相关组件处于最新版本，避免因版本兼容问题导致的问题。

3. 结论

通过本手册提供的排查步骤和方法，可以帮助你更有效地定位并解决在使用OpenCNI过程中遇到的各种网络故障。如果你仍然无法解决问题，请参考官方文档或寻求社区支持。