From 354555638c6c3b62ac5c595861be1d092e84fb66 Mon Sep 17 00:00:00 2001 From: Gary Wu Date: Wed, 28 Nov 2018 13:00:26 -0800 Subject: Integration ONAP OOM HEAT documentation updates Change-Id: Idb83c1a87ec9d1c74ce79bca9e4abebebc23d9ba Issue-ID: INT-748 Signed-off-by: Gary Wu --- docs/onap-oom-heat.rst | 95 ++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 76 insertions(+), 19 deletions(-) diff --git a/docs/onap-oom-heat.rst b/docs/onap-oom-heat.rst index a49daa3dd..cc9ceb7ba 100644 --- a/docs/onap-oom-heat.rst +++ b/docs/onap-oom-heat.rst @@ -1,5 +1,8 @@ +.. _onap-oom-heat: + ONAP OOM HEAT Template ------------------- +---------------------- + Source files ~~~~~~~~~~~~ @@ -9,16 +12,17 @@ Source files - Sample environment file: https://git.onap.org/integration/tree/deployment/heat/onap-oom/env/windriver/onap-oom.env?h=casablanca - Deployment script: https://git.onap.org/integration/tree/deployment/heat/onap-oom/scripts/deploy.sh?h=casablanca + Description ~~~~~~~~~~~ The ONAP Integration Project provides a sample HEAT template that fully automates the deployment of ONAP using OOM as described in -:ref:`ONAP Operations Manager (OOM) over Kubernetes`. +:ref:`ONAP Operations Manager (OOM) over Kubernetes`. -The ONAP OOM HEAT template deploys up the entire ONAP platform. It -spins up an HA-enabled Kubernetes cluster, and deploys ONAP using OOM -onto this cluster. +The ONAP OOM HEAT template deploys the entire ONAP platform. It spins +up an HA-enabled Kubernetes cluster, and deploys ONAP using OOM onto +this cluster. - 1 Rancher VM that also serves as a shared NFS server - 3 etcd VMs for the Kubernetes HA etcd plane - 2 orch VMs for the Kubernetes HA orchestration plane @@ -26,17 +30,17 @@ onto this cluster. Quick Start -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~ Using the Wind River lab configuration as an example, here is what you need to do to deploy ONAP: :: - git clone https://git.onap.org/integration - cd integration/deployment/heat/onap-oom/ - source ./env/windriver/Integration-SB-00-openrc - ./scripts/deploy.sh ./env/windriver/onap-oom.env + git clone https://git.onap.org/integration + cd integration/deployment/heat/onap-oom/ + source ./env/windriver/Integration-SB-00-openrc + ./scripts/deploy.sh ./env/windriver/onap-oom.env Environment and RC files @@ -57,17 +61,18 @@ OpenStack environment as well. **Notes on select parameters** :: - apt_proxy: 10.12.5.2:8000 - docker_proxy: 10.12.5.2:5000 - rancher_vm_flavor: m1.large - k8s_vm_flavor: m1.xlarge - etcd_vm_flavor: m1.medium - orch_vm_flavor: m1.medium + apt_proxy: 10.12.5.2:8000 + docker_proxy: 10.12.5.2:5000 + + rancher_vm_flavor: m1.large + k8s_vm_flavor: m1.xlarge + etcd_vm_flavor: m1.medium + orch_vm_flavor: m1.medium - key_name: onap_key + key_name: onap_key - helm_deploy_delay: 2.5m + helm_deploy_delay: 2.5m It is recommended that you set up an apt proxy and a docker proxy local to your lab. If you do not wish to use such proxies, you can @@ -83,9 +88,61 @@ keypair named "onap_key" into your OpenStack environment. If the desired keypair has a different name, change the key_name parameter. The helm_deploy_delay parameter introduces a delay in-between the -deployment of each ONAP helm subchart to help alleviate system load or +deployments of each ONAP helm subchart to help alleviate system load or contention issues caused by trying to spin up too many pods simultaneously. The value of this parameter is passed to the Linux "sleep" command. Adjust this parameter based on the performance and load characteristics of your OpenStack environment. + +Exploring the Rancher VM +~~~~~~~~~~~~~~~~~~~~~~~~ + +The Rancher VM that is spun up by this HEAT template serves the +following key roles: +- Installaion of the Rancher server +- Hosts the /dockerdata-nfs/ NFS export shared by all the k8s VMs for persistent volumes +- git clones the oom repo into /root/oom +- git clones the integration repo into /root/integration +- Creates the helm override file at /root/integration-override.yaml +- Deploys ONAP using helm and OOM + + + +.. _deploy-updated-manifest: + +Deploying an Updated Docker Manifest +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some late changes in the ONAP docker images did not make it in time +for the Casablanca release. Depending on the Use Case you are trying +deploy, you may need to update the docker image manifest with certain +newer docker image versions than what was shipped with ONAP Casablanca +release. + +The ONAP integration repo contains a script that will apply the docker +versions specified in a given manifest into the OOM helm chart +definitions. + +To apply an updated manifest (on the Rancher VM): + +:: + + cd /root/integration/version-manifest/src/main/resources + cp docker-manifest.csv docker-manifest-custom.csv + + # customize docker-manifest-custom.csv per your requirements + + ../scripts/update-oom-image-versions.sh ./docker-manifest-custom.csv /root/oom/ + + cd /root/oom/kubernetes/ + git diff # verify that the desired docker image changes are applied successfully + make all # recompile the helm charts + +After that you can update or redeploy ONAP OOM as described here: + +.. toctree:: + :maxdepth: 1 + :titlesonly: + + ../../../../submodules/oom.git/docs/oom_quickstart_guide.rst -- cgit 1.2.3-korg