aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGary Wu <gary.i.wu@huawei.com>2018-11-28 13:00:26 -0800
committerGary Wu <gary.i.wu@huawei.com>2018-11-28 21:22:05 +0000
commitf6118ca560d20748bfe044d61d12e0bd3ab089fa (patch)
tree4217557a4567cfae6e1a196879dff2b79f11572a
parent2985eb234bbae1f6a8d88a1c5a0f95468639be33 (diff)
Integration ONAP OOM HEAT documentation updates
Change-Id: Idb83c1a87ec9d1c74ce79bca9e4abebebc23d9ba Issue-ID: INT-748 Signed-off-by: Gary Wu <gary.i.wu@huawei.com>
-rw-r--r--docs/onap-oom-heat.rst95
1 files 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<installing-onap>`.
-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