From 65e5f084cf550af9c33fa28b53763346983694e6 Mon Sep 17 00:00:00 2001 From: Sylvain Desbureaux Date: Mon, 9 Mar 2020 12:06:03 +0100 Subject: [DOC] Update Kubernetes RKE installation doc Issue-ID: OOM-2204 Signed-off-by: Sylvain Desbureaux Change-Id: I1d17f027f81c2abc3fbf97973dd5076776b8499e --- docs/images/network/network_1.png | Bin 0 -> 127009 bytes docs/images/network/network_2.png | Bin 0 -> 133842 bytes docs/images/network/network_3.png | Bin 0 -> 105085 bytes docs/images/network/network_4.png | Bin 0 -> 97405 bytes docs/images/sg/sg_1.png | Bin 0 -> 108229 bytes docs/images/sg/sg_2.png | Bin 0 -> 153078 bytes docs/oom_setup_kubernetes_rancher.rst | 48 +++++++++++++++++++++++++++++++--- 7 files changed, 44 insertions(+), 4 deletions(-) create mode 100644 docs/images/network/network_1.png create mode 100644 docs/images/network/network_2.png create mode 100644 docs/images/network/network_3.png create mode 100644 docs/images/network/network_4.png create mode 100644 docs/images/sg/sg_1.png create mode 100644 docs/images/sg/sg_2.png diff --git a/docs/images/network/network_1.png b/docs/images/network/network_1.png new file mode 100644 index 0000000000..d51cb1280b Binary files /dev/null and b/docs/images/network/network_1.png differ diff --git a/docs/images/network/network_2.png b/docs/images/network/network_2.png new file mode 100644 index 0000000000..9498a460d3 Binary files /dev/null and b/docs/images/network/network_2.png differ diff --git a/docs/images/network/network_3.png b/docs/images/network/network_3.png new file mode 100644 index 0000000000..c729405aef Binary files /dev/null and b/docs/images/network/network_3.png differ diff --git a/docs/images/network/network_4.png b/docs/images/network/network_4.png new file mode 100644 index 0000000000..cc8f96fac0 Binary files /dev/null and b/docs/images/network/network_4.png differ diff --git a/docs/images/sg/sg_1.png b/docs/images/sg/sg_1.png new file mode 100644 index 0000000000..ff5264d3c4 Binary files /dev/null and b/docs/images/sg/sg_1.png differ diff --git a/docs/images/sg/sg_2.png b/docs/images/sg/sg_2.png new file mode 100644 index 0000000000..395057fc97 Binary files /dev/null and b/docs/images/sg/sg_2.png differ diff --git a/docs/oom_setup_kubernetes_rancher.rst b/docs/oom_setup_kubernetes_rancher.rst index 6dcc3c72cb..19ac52b9b8 100644 --- a/docs/oom_setup_kubernetes_rancher.rst +++ b/docs/oom_setup_kubernetes_rancher.rst @@ -69,6 +69,42 @@ Example:: > chmod 600 ~/.ssh/onap-key +Create Network +============== + +An internal network is required in order to deploy our VMs that will host +Kubernetes. + +.. image:: images/network/network_1.png + +.. image:: images/network/network_2.png + +.. image:: images/network/network_3.png + +.. Note:: + It's better to have one network per deployment and obviously the name of this + network should be unique. + +Now we need to create a router to attach this network to outside: + +.. image:: images/network/network_4.png + +Create Security Group +===================== + +A specific security group is also required + +.. image:: images/sg/sg_1.png + +then click on `manage rules` of the newly created security group. +And finally click on `Add Rule` and create the following one: + +.. image:: images/sg/sg_2.png + +.. Note:: + the security is clearly not good here and the right SG will be proposed in a + future version + Create Kubernetes Control Plane VMs =================================== @@ -96,11 +132,15 @@ The recommended flavor is at least 4 vCPU and 8GB ram. Networking ---------- +Use the created network: + .. image:: images/cp_vms/control_plane_4.png Security Groups --------------- +Use the created security group: + .. image:: images/cp_vms/control_plane_5.png Key Pair @@ -112,7 +152,7 @@ Assign the key pair that was created/selected previously (e.g. onap_key). Apply customization script for Control Plane VMs ------------------------------------------------ -Click :download:`openstack-k8s-controlnode.sh ` +Click :download:`openstack-k8s-controlnode.sh ` to download the script. .. literalinclude:: openstack-k8s-controlnode.sh @@ -140,10 +180,10 @@ Highly-Available Kubernetes Workers. ONAP workloads will only be scheduled on th Launch new VM instances ----------------------- -The number and size of Worker VMs is depenedent on the size of the ONAP deployment. -By default, all ONAP applications are deployed. It's possible to customize the deployment +The number and size of Worker VMs is depenedent on the size of the ONAP deployment. +By default, all ONAP applications are deployed. It's possible to customize the deployment and enable a subset of the ONAP applications. For the purpose of this guide, however, -we will deploy 12 Kubernetes Workers that have been sized to handle the entire ONAP +we will deploy 12 Kubernetes Workers that have been sized to handle the entire ONAP application workload. .. image:: images/wk_vms/worker_1.png -- cgit 1.2.3-korg