kube-ovn

Kube-OVN 网络插件

补充说明

Kube-OVN 基于 OVN/OVS 提供 Kubernetes 网络、子网、VPC、静态 IP、QoS、网络策略和双栈。它适合需要固定 IP、租户隔离和传统网络对接的场景。

核心概念：ProviderNetwork、VPC、Subnet、IPPool、NetworkAttachmentDefinition 和 OVN 逻辑网络。

语法

安装：

helm repo add kubeovn https://kubeovn.github.io/kube-ovn/
helm install kube-ovn kubeovn/kube-ovn \
  --namespace kube-system \
  --set networking.podSubnet=10.16.0.0/16
kubectl -n kube-system get pods -l app=kube-ovn

创建子网：

kubectl apply -f - <<'EOF'
apiVersion: kubeovn.io/v1
kind: Subnet
metadata:
  name: demo-subnet
spec:
  protocol: IPv4
  cidrBlock: 10.20.0.0/24
  gateway: 10.20.0.1
  vpc: demo-vpc
  namespaces:
  - demo
EOF

创建 VPC：

kubectl apply -f - <<'EOF'
apiVersion: kubeovn.io/v1
kind: Vpc
metadata:
  name: demo-vpc
spec:
  namespaces:
  - demo
EOF

固定 IP：

kubectl apply -f - <<'EOF'
apiVersion: v1
kind: Pod
metadata:
  name: fixed-ip
  namespace: demo
  annotations:
    ovn.kubernetes.io/ip_address: 10.20.0.10
spec:
  containers:
  - name: app
    image: nginx
EOF

查看网络资源：

kubectl get subnet
kubectl get vpc
kubectl get ippool
kubectl get pod -n demo -o wide

注意

• Pod CIDR、Service CIDR 和现有网络不能重叠。
• 安装前要清理其他 CNI，避免多个 CNI 同时接管流量。
• 子网绑定命名空间后，Pod 必须使用对应子网，否则无法分配 IP。
• 静态 IP 超出子网范围或已被占用，Pod 一直 Pending。
• VPC 之间的默认隔离需要显式配置路由或对等连接。
• OVN 数据库和控制器需要高可用，单点故障会影响网络。
• 升级 Kube-OVN 前备份 OVN NB/SB 数据库。
• 大规模集群要监控 OVS 流表、隧道和 IPAM 使用率。

相关命令

• kubectl get subnet,vpc,ippool — 查看网络资源
• kubectl get pods -n kube-system -l app=kube-ovn — 查看组件
• kubectl describe pod — 查看 IP 分配事件
• kubectl ko — Kube-OVN 诊断脚本（如已安装）
• ovn-nbctl / ovs-vsctl — 底层 OVN/OVS 排查

参考链接

• https://kubeovn.github.io/
• https://github.com/kubeovn/kube-ovn
• https://kubeovn.github.io/docs/