kubernetes/README.md

   1 ## **Quick Start Guide**
   2
   3 > **WARNING**: This README is no longer maintained and will be deprecated.
   4 > Please refer to the official OOM guide here - [OOM Guide](https://docs.onap.org/projects/onap-oom/en/latest/sections/oom_project_description.html)
   5
   6
   7 This is a quick start guide describing how to deploy ONAP on Kubernetes using Helm.
   8
   9 Pre-requisites:
  10
  11 -  Your Kubernetes environment must be available. For more information see, [ONAP on Kubernetes](https://wiki.onap.org/display/DW/ONAP+on+Kubernetes).
  12 -  Deployment artifacts are customized for your location.
  13
  14
  15 ### **Deploy ONAP Instance**
  16
  17 Step 1. Clone the OOM repository from ONAP gerrit:
  18
  19 ```
  20 > git clone http://gerrit.onap.org/r/oom
  21 > cd oom/kubernetes
  22 ```
  23
  24 Step 2. Customize the oom/kubernetes/onap parent chart, like the values.yaml file, to suit your deployment. You may want to selectively enable or disable ONAP components by changing the subchart **enabled** flags to *true* or *false*.  The .yaml file for OpenStackEncryptedPassword should be the MSO ecnrypted value of the openstack tenant password
  25 ```
  26 Example:
  27 ...
  28 robot: # Robot Health Check
  29   enabled: true
  30 sdc:
  31   enabled: false
  32 sdnc:
  33   enabled: false
  34 so: # Service Orchestrator
  35   enabled: true
  36 ...
  37 ```
  38 Step 3. To setup a local Helm repository to serve up the local ONAP charts:
  39         [Note: ensure helm init has been executed on the node, or run helm init --client-only]
  40 ```
  41 > helm serve &
  42 ```
  43 Note the port number that is listed and use it in the Helm repo add as follows:
  44 ```
  45 > helm repo add local http://127.0.0.1:8879
  46 ```
  47
  48 Step 4. Build a local Helm repository (from the kubernetes directory):
  49 ```
  50 > make all
  51 ```
  52
  53 Step 5. Display the charts that are available to be deployed:
  54 ```
  55 > helm search -l
  56 NAME                    VERSION    DESCRIPTION
  57 local/clamp             2.0.0      ONAP Clamp
  58 local/onap              2.0.0      Open Network Automation Platform (ONAP)
  59 local/robot             2.0.0      A helm Chart for kubernetes-ONAP Robot
  60 local/so                2.0.0      ONAP Service Orchestrator
  61 ...
  62 ```
  63
  64 **Note:**
  65 Setup of this Helm repository is a one time activity. If you make changes to your deployment charts or values be sure to use **make** to update your local Helm repository.
  66
  67 Step 6. Once the repo is setup, installation of ONAP can be done with a single command:
  68 ```
  69 > helm install local/onap --name dev --namespace onap
  70 ```
  71 **Note:** the **--namespace onap** is currently required while all onap helm charts are migrated to version 2.0. After this activity is complete, namespaces will be optional.
  72
  73 Use the following to monitor your deployment and determine when ONAP is ready for use:
  74 ```
  75 > kubectl get pods --all-namespaces -o=wide
  76 ```
  77
  78
  79 #### **Cleanup deployed ONAP instance**
  80
  81 To delete a deployed instance, use the following command:
  82 ```
  83 > helm del dev --purge
  84 ```
  85
  86
  87
  88 For more information on OOM project documentation, refer to:
  89
  90  -  [Quick Start Guide on Wiki](https://wiki.onap.org/display/DW/ONAP+Operations+Manager+Project#ONAPOperationsManagerProject-QuickStartGuide)
  91  -  [Quick Start Guide on readthedocs](http://onap.readthedocs.io/en/latest/submodules/oom.git/docs/OOM%20Project%20Description/oom_project_description.html#quick-start-guide)