在部署 Kubernetes 集群时，CNI 插件是一个非常重要的组成部分。它负责将容器的网络与物理网络进行连接，从而实现容器之间的通信和跨主机网络访问。然而，由于 CNI 插件的复杂性和多样性，在使用过程中可能会出现各种错误和问题。接下来将介绍如何排查 CNI 插件相关的错误，并提供一些实用的技巧和建议。
为了避免 CNI 插件相关的错误，需要验证正在使用或升级到一个经过测试的容器运行时， 该容器运行时能够在 Kubernetes 版本上正常工作。
一、常见错误
关于 “Incompatible CNI versions” 和 “Failed to destroy network for sandbox” 错误：
在 containerd v1.6.0-v1.6.3 中，当配置或清除 Pod CNI 网络时，如果 CNI 插件没有升级和/或 CNI 配置文件中没有声明 CNI 配置版本时，会出现服务问题。containerd 团队报告说： “这些问题在 containerd v1.6.4 中得到了解决。”
在使用 containerd v1.6.0-v1.6.3 时，如果不升级 CNI 插件和/或声明 CNI 配置版本， 可能会遇到以下 “Incompatible CNI versions” 或 “Failed to destroy network for sandbox” 错误状况。
1、Incompatible CNI versions 错误
如果因为配置版本比插件版本新，导致 CNI 插件版本与配置中的插件版本无法正确匹配时， 在启动 Pod 时，containerd 日志可能会显示类似的错误信息：
incompatible CNI versions; config is \"1.0.0\", plugin supports [\"0.1.0\" \"0.2.0\" \"0.3.0\" \"0.3.1\" \"0.4.0\"]"
为了解决这个问题，需要更新 CNI 插件和 CNI 配置文件。
2、Failed to destroy network for sandbox 错误
如果 CNI 插件配置中未给出插件的版本， Pod 可能可以运行。但是，停止 Pod 时会产生类似于以下错误：
ERRO[2022-04-26T00:43:24.518165483Z] StopPodSandbox for "b" failed error="failed to destroy network for sandbox \"bbc85f891eaf060c5a879e27bba9b6b06450210161dfdecfbb2732959fb6500a\": invalid version \"\": the version is empty"
此错误使 Pod 处于未就绪状态，且仍然挂接到某网络名字空间上。 为修复这一问题，编辑 CNI 配置文件以添加缺失的版本信息。 下一次尝试停止 Pod 应该会成功。
二、更新CNI插件和CNI配置文件
如果使用 containerd v1.6.0-v1.6.3 并遇到 “Incompatible CNI versions” 或者 “Failed to destroy network for sandbox” 错误，考虑更新 CNI 插件并编辑 CNI 配置文件。
以下是针对各节点要执行的典型步骤的概述：
1、安全地腾空并隔离节点。
2、停止容器运行时和 kubelet 服务后，执行以下升级操作：
- 如果正在运行 CNI 插件，请将它们升级到最新版本；
- 如果使用的是非 CNI 插件，请将它们替换为 CNI 插件，并使用最新版本的插件；
- 更新插件配置文件以指定或匹配 CNI 规范支持的插件版本；
- 对于 containerd，请确保已安装 CNI loopback 插件的最新版本（v1.0.0 或更高版本）；
- 将节点组件（例如 kubelet）升级到 Kubernetes v1.24；
- 升级到或安装最新版本的容器运行时。
3、通过重新启动容器运行时和 kubelet 将节点重新加入到集群。取消节点隔离（kubectl uncordon <nodename>）。
三、containerd配置文件示例
以下示例显示了 containerd 运行时 v1.6.x 的配置， 它支持最新版本的 CNI 规范（v1.0.0）。
在 Kubernetes 中，作为其默认行为，containerd 运行时为 Pod 添加一个本地回路接口，lo。 containerd 运行时通过 CNI 插件 loopback 配置本地回路接口。
loopback 插件作为 containerd 发布包的一部分，扮演 cni 角色。 containerd v1.6.0 及更高版本包括与 CNI v1.0.0 兼容的 loopback 插件以及其他默认 CNI 插件。 loopback 插件的配置由 containerd 内部完成， 并被设置为使用 CNI v1.0.0。 这也意味着当这个更新版本的 containerd 启动时，loopback 插件的版本必然是 v1.0.0 或更高版本。
以下 Bash 命令生成一个 CNI 配置示例。这里，cniVersion 字段被设置为配置版本值 1.0.0， 以供 containerd 调用 CNI 桥接插件时使用。
cat << EOF | tee /etc/cni/net.d/10-containerd-net.conflist
{
"cniVersion": "1.0.0",
"name": "containerd-net",
"plugins": [
{
"type": "bridge",
"bridge": "cni0",
"isGateway": true,
"ipMasq": true,
"promiscMode": true,
"ipam": {
"type": "host-local",
"ranges": [
[{
"subnet": "10.88.0.0/16"
}],
[{
"subnet": "2001:db8:4860::/64"
}]
],
"routes": [
{ "dst": "0.0.0.0/0" },
{ "dst": "::/0" }
]
}
},
{
"type": "portmap",
"capabilities": {"portMappings": true},
"externalSetMarkChain": "KUBE-MARK-MASQ"
}
]
}
EOF
基于用例和网络地址规划，将前面示例中的 IP 地址范围更新为合适的值。
