XTesting/kubespray/docs/kube-ovn.md

   1 # Kube-OVN
   2
   3 Kube-OVN integrates the OVN-based Network Virtualization with Kubernetes. It offers an advanced Container Network Fabric for Enterprises.
   4
   5 For more information please check [Kube-OVN documentation](https://github.com/alauda/kube-ovn)
   6
   7 **Warning:** Kernel version (`cat /proc/version`) needs to be different than `3.10.0-862` or kube-ovn won't start and will print this message:
   8
   9 ```bash
  10 kernel version 3.10.0-862 has a nat related bug that will affect ovs function, please update to a version greater than 3.10.0-898
  11 ```
  12
  13 ## How to use it
  14
  15 Enable kube-ovn in `group_vars/k8s_cluster/k8s_cluster.yml`
  16
  17 ```yml
  18 ...
  19 kube_network_plugin: kube-ovn
  20 ...
  21 ```
  22
  23 ## Verifying kube-ovn install
  24
  25 Kube-OVN run ovn and controller in `kube-ovn` namespace
  26
  27 * Check the status of kube-ovn pods
  28
  29 ```ShellSession
  30 # From the CLI
  31 kubectl get pod -n kube-ovn
  32
  33 # Output
  34 NAME                                   READY   STATUS    RESTARTS   AGE
  35 kube-ovn-cni-49lsm                     1/1     Running   0          2d20h
  36 kube-ovn-cni-9db8f                     1/1     Running   0          2d20h
  37 kube-ovn-cni-wftdk                     1/1     Running   0          2d20h
  38 kube-ovn-controller-68d7bb48bd-7tnvg   1/1     Running   0          2d21h
  39 ovn-central-6675dbb7d9-d7z8m           1/1     Running   0          4d16h
  40 ovs-ovn-hqn8p                          1/1     Running   0          4d16h
  41 ovs-ovn-hvpl8                          1/1     Running   0          4d16h
  42 ovs-ovn-r5frh                          1/1     Running   0          4d16h
  43 ```
  44
  45 * Check the default and node subnet
  46
  47 ```ShellSession
  48 # From the CLI
  49 kubectl get subnet
  50
  51 # Output
  52 NAME          PROTOCOL   CIDR            PRIVATE   NAT
  53 join          IPv4       100.64.0.0/16   false     false
  54 ovn-default   IPv4       10.16.0.0/16    false     true
  55 ```