Skip to main content

CNI

  • 是什么？
    • 抽象容器网络接口规范
    • cni-plugins 提供了大量实现
  • containernetworking/cni - 规范
  • containernetworking/plugins - 参考实现
  • alpine 默认安装路径 /usr/libexec/cni/
  • 默认网络配置目录 /etc/cni/net.d
  • CNI 包含了启动脚本 - cni/scripts
    • 操作 netns - ip netns
    • exec-plugins add|del CNI_CONTAINERID CNI_NETNS
      • CNI_CONTAINERID - 容器 ID
        • 唯一标示目的，可以随机生成
        • docker 可直接使用 容器 ID
        • 例如 printf '%x%x%x%x' $RANDOM $RANDOM $RANDOM $RANDOM
      • CNI_NETNS - 网络命名空间路径
        • /proc/<pid>/ns/net
  • flannel-io/flannel
warning
TypeDesc
Main: 网口创建
bridge创建桥接，添加宿主机和容器网络到桥接
ipvlan添加 ipvlan 到容器
loopbackip li set lo1 up
macvlan创建 macvlan 给容器，转发 mac 流量
ptpveth 对
vlan创建 vlan
host-device透传已存在设备
Windows
win-bridge
win-overlay
IPAM: IP 地址申请
dhcpDHCP 申请
host-local管理本地申请到的 IP
static使用静态地址
Meta: 其他插件
flannel基于 flannel 生成网口
tuning通过 sysctl 修改网口配置
portmap基于 iptables 的端口映射 - 主机地址端口到容器
bandwidth进出带宽限制
sbr基于来源的路由
firewall基于 iptables 或 firewalld 的防火墙控制

spec​

  • add,delete,version
  • stdin, stdout
  • CNI_ARGS, CAP_ARGS
cat <<CONF > bridge.conf
{
  "name": "mynet",
  "type": "bridge",
  "ipam": {
    "type":"host-local",
    "subnet": "10.10.1.0/24"
  }
}
CONF
ip netns add ns1

CNI_COMMAND=ADD CNI_CONTAINERID=ns1 CNI_NETNS=/var/run/netns/ns1 CNI_IFNAME=eth2 CNI_PATH="$PWD" \
bridge < bridge.conf

bridge​

{
  "cniVersion": "0.3.1",
  // 网络名字
  "name": "mynet",
  // 网络类型 - 对应 /usr/libexec/cni/
  "type": "bridge",

  // 桥接名字 - 默认 cni0
  "bridge": "cni0",
  // 设置的 IP 作为默认路由
  "isDefaultGateway": false,
  // 设否设置新的 IP 地址
  "forceAddress": false,
  // 是否配置 masquerade
  "ipMasq": false,
  // MTU 默认取决于 内核
  "mtu": 0,
  // hairpin 模式
  "hairpinMode": false,
  // IP 地址管理 - L2 网络
  "ipam": {
    "type": "host-local",
    "subnet": "10.10.0.0/16"
  },
  // promiscuous 模式
  "promiscMode": false
  // 是否设置 VLAN tag
  // "vlan":0
}

Windows​

  • win-overlay
  • win-bridge
  • host-local
  • flannel
cat <<CONF > overlay.conf
{
	"name": "mynet",
	"type": "win-overlay",
	"ipMasq": true,
	"endpointMacPrefix": "0E-2A",
	"ipam": {
		"type": "host-local",
		"subnet": "10.10.0.0/16"
	},
  "loopbackDSR": true,
  "capabilites": {
      "dns": true
  }
}
CONF

CNI_COMMAND=ADD CNI_CONTAINERID=ns1 CNI_NETNS=/var/run/netns/ns1 CNI_IFNAME=eth2 CNI_PATH="$PWD" \
./win-overlay < overlay.conf

error while GETHNSNewtorkByName(mynet): hnsCall failed in Win32: The specified module could not be found. (0x7e)​

failed to find plugin flannel in path /usr/libexec/cni​

cni-plugins v1 后没有 flannel