summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarco Platania <platania@research.att.com>2018-11-28 21:42:52 +0000
committerGerrit Code Review <gerrit@onap.org>2018-11-28 21:42:52 +0000
commitec746e068a0afd52240278034640c09785a63b8a (patch)
tree0e6519099e0977fb206564ba944ddfcbabbc76d7
parent75281dafce62c3a90b0e2e3cc44047b27feb1d56 (diff)
parent354555638c6c3b62ac5c595861be1d092e84fb66 (diff)
Merge "Integration ONAP OOM HEAT documentation updates" into casablanca3.0.0-ONAP3.0.0
-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