cni是容器网络接口标准，kubelet通过读取/etc/cni/net.d/配置文件、调用/opt/cni/bin/下对应type命名的插件二进制，完成pod网络配置；它不依赖“kube-cni”组件，而是基于json协议与插件交互，执行网络命名空间设置、ip分配等操作。
Go 项目本身不“部署 kube-cni”——kube-cni 并不是一个独立可部署的组件，它只是 Kubernetes 中对 CNI 插件调用机制的统称。真正要让容器网络互通，你需要的是：一个符合 CNI 规范的插件（如 bridge、calico、cilium） + 正确的配置文件 + Go 程序在恰当位置调用它（比如作为 runtime 或测试工具）。
为什么找不到 kube-cni 这个二进制？
因为 kube-cni 不是官方发布的可执行文件。Kubernetes 的 kubelet 通过 --cni-bin-dir（默认 /opt/cni/bin/）查找插件，按 cniVersion 和 type 字段匹配配置中指定的插件名（如 "type": "bridge"），然后 exec 调用对应二进制。所谓“部署 kube-cni”，实际是部署某个具体 CNI 插件，并配好 conflist。
- 常见误操作：把
kube-cni当成一个包去go get或go build—— 它不存在 - 真实依赖路径：
kubelet → 读取 /etc/cni/net.d/*.conflist → 根据 type 字段找到 /opt/cni/bin/<type> → exec.Command 调用</type> - Go 程序若需模拟此过程（如写集成测试），应直接调用
exec.Command("/opt/cni/bin/bridge", ...)，而非试图“引入 kube-cni 库”
Go 程序如何安全调用 CNI 插件完成容器网络配置？
如果你正在写一个轻量 runtime、容器测试框架或 CNI 插件调试工具，需要用 Go 调用 CNI 插件，关键不是“部署”，而是构造合法输入并处理输出。官方 github.com/containernetworking/cni 提供了封装，但注意它只做 JSON 解析和 exec 调用，不替代插件本身。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 必须提供容器 netns 路径（如
/proc/12345/ns/net），且 Go 进程需有CAP_NET_ADMIN权限 - 配置必须含
cniVersion（如"0.4.0"）、name、type，且type值必须与/opt/cni/bin/下可执行文件名一致 - 推荐用
cni.NetworkConfigListFromBytes()解析配置，再用cni.invoke()执行，避免手拼 stdin - 错误示例：
stdin: {"type":"bridge","ipam":{"type":"host-local"}}缺少cniVersion→ 插件返回"missing cniVersion"
自研 CNI 插件时，Go 编译产物怎么被 kubelet 识别？
你用 Go 写的 CNI 插件（比如叫 mycni），编译后必须放在 /opt/cni/bin/mycni，且配置文件中 "type": "mycni"。kubelet 不关心语言，只认文件名 + 可执行权限 + stdin/stdout 协议。
- 编译命令必须静态链接：
CGO_ENABLED=0 go build -o /opt/cni/bin/mycni main.go，否则在容器或精简节点上运行失败 - 插件入口必须读取 stdin 的 JSON，输出 JSON 到 stdout，错误打到 stderr —— 这是 CNI 规范硬性要求
- 调试时可用
echo '{"cniVersion":"0.4.0","name":"mynet","type":"mycni"}' | sudo /opt/cni/bin/mycni直接验证 - 别忘了 chmod +x，否则 kubelet 报错：
failed to set up network: failed to call plugin: exec: "mycni": executable file not found in $PATH
真正卡住人的从来不是 Go 代码写得对不对，而是 /etc/cni/net.d/ 配置里 type 拼错、/opt/cni/bin/ 权限没设、netns 路径已失效，或者插件返回的 IP 结构体字段名不符合 CNI spec。调不通时，先手动 exec 测试，再查 kubelet 日志里的 exact error message。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
