summaryrefslogtreecommitdiffstats
path: root/docs/release/userguide/multus.rst
diff options
context:
space:
mode:
authorLaura Sofia Enriquez <lsofia.enriquez@gmail.com>2017-11-22 23:25:30 -0300
committerLaura Sofia Enriquez <lsofia.enriquez@gmail.com>2017-12-12 02:29:12 -0300
commite646e381e4973a087abb5b716485021dcc54e7d4 (patch)
tree96c981d06dbdc96dc09b248939e5d71007c21b44 /docs/release/userguide/multus.rst
parent613d576521a1c1e524c3becda05a7ea5db4bc906 (diff)
Docs added to release/userguide
Docs added about: - Vagrant installation - Multus - Nginx - Ovsdpdk - Virlet Change-Id: Ib38f1239e1a4de5d87b0fe9127545a9430462d4e Signed-off-by: Laura Sofia Enriquez <lsofia.enriquez@gmail.com>
Diffstat (limited to 'docs/release/userguide/multus.rst')
-rw-r--r--docs/release/userguide/multus.rst29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/release/userguide/multus.rst b/docs/release/userguide/multus.rst
new file mode 100644
index 0000000..fbdbeb9
--- /dev/null
+++ b/docs/release/userguide/multus.rst
@@ -0,0 +1,29 @@
+Multus implementation for OPNFV
+===============================
+
+This quickstart shows you how to easily install a Kubernetes cluster on VMs running with Vagrant. The installation uses a tool called kubeadm which is part of Kubernetes.
+
+kubeadm assumes you have a set of machines (virtual or bare metal) that are up and running. In this way we can get a cluster with one master node and 2 workers (default). If you want to increase the number of workers nodes, please check the Vagrantfile inside the project.
+
+
+About Multus
+------------
+
+[Multus](https://github.com/Intel-Corp/multus-cni) is a CNI proxy and arbiter of other CNI plugins.
+
+With the help of Multus CNI plugin, multiple interfaces can be added at the same time when deploying a pod. Notably, Virtual Network Functions (VNFs) are typically requiring connectivity to multiple network interfaces.
+
+The Multus CNI has the following features:
+- It is a contact between the container runtime and other plugins, and it doesn't have any of its own net configuration, it calls other plugins like flannel/calico to do the real net conf. job.
+- Multus reuses the concept of invoking the delegates in flannel, it groups the multi plugins into delegates and invoke each other in sequential order, according to the JSON scheme in the cni configuration.
+- No. of plugins supported is dependent upon the number of delegates in the conf file.
+- Master plugin invokes "eth0" interface in the pod, rest of plugins(Mininon plugins eg: sriov,ipam) invoke interfaces as "net0", "net1".. "netn".
+- The "masterplugin" is the only net conf option of Multus cni, it identifies the primary network. The default route will point to the primary network.
+
+
+Multus example
+--------------
+
+.. image:: img/multus_pod_example.png
+ :width: 800px
+ :alt: Multus Pod example