First draft of the SMO package based on the ONAP charts

2 git submodules pointing to Onap oom & MulticloudK8S
+ scripts to setup K8s node/Build charts/Installation
+ Helm override for helm config used during the installation
+ Oran charts reworked so that they can be built like in ONAP OOM
+ For the verify Job: remove smo-install from dockerfile (another verify job will be added)

Signed-off-by: sebdet <sebastien.determe@intl.att.com>
Signed-off-by: xuegao <xue.gao@intl.att.com>
Issue-ID: NONRTRIC-609
Change-Id: I93425022761bc4e7efce2bd374fb9ef101942fc0
196 files changed
tree: 8b3e2fa484cce347cc3b5982a34978efad2ef4d1
  1. .releases/
  2. bin/
  3. ci/
  4. demos/
  5. docs/
  6. nonrtric/
  7. o-du-high/
  8. RECIPE_EXAMPLE/
  9. ric-aux/
  10. ric-common/
  11. smo-install/
  12. tools/
  13. .gitignore
  14. .gitmodules
  15. .gitreview
  16. .readthedocs.yaml
  17. INFO.yaml
  18. LICENSES.txt
  19. README.md
  20. tox.ini
README.md

This is a comment, it will not be included) [comment]: <> (in the output file unless you use it in) [comment]: <> (a reference style link.)

RIC Integration

This repo contains RAN Intelligent Controller (RIC) deployments related files.

Overview

The RIC deployment scripts are designed to deploy RIC components using helm charts. A deployment recipe yaml file that contains parameter key:value pairs can be provided as a parameter for any deployment script in this repository. The deployment recipe is acting as the helm override values.yaml file. The default parameters are set up to deploy a RIC instance using Linux Foundation repositories in a self-contained environment.

Directory Structure

. ├── bin ├── ci ├── docs ├── LICENSES.txt License information ├── README.md This file ├── RECIPE_EXAMPLE Directory that contains deploy recipe examples ├── ric-aux Deployment scripts, charts and configuration files for RIC auxilary functions ├── ric-common Deployment scripts, charts and configuration files for RIC common template ├── ric-dep Deployment scripts, charts and configuration files for RIC platform components └── tools Deployment scripts, charts and configuration files for K8S deployment

The deployment scripts are designed to be modularized. Each submodule is managed independently in other Git repo and they can be deployed and undeployed separately. These submodules are coupled together throught the ric-common template which provides common references to naming convention, settings, and configurations. Currently ric-dep is the submodule for RIC platform deployment, and ric-aux is the submodule for the auxilary functions deployment (currently ric-aux is still managed by it/dep repo). In the future, more submodules can be added without changing the structure.

The one-click RIC deployment/undeployment scripts in the ./bin directory will call the deployment/undeployment scripts in the corresponding submodule directory respectively. In each of the submodule directories, ./bin contains the binary and script files and ./helm contains the helm charts. For the rest of the non-submodule directories please refer to the README.md files in them for more details.

Prerequisites

To deploy RIC, you need to have a cluster that runs kubernetes (version > v.1.16.0) and helm (version v2.14.3). Tools to install a K8S environment in an openstack cloud can be found in ./tools/k8s. Please refer to the README.md file for more details

To deploy RIC Platform

Choose a deployment recipe (e.g, ./RECIPE_EXAMPLE/PLATFORM/amber_example_recipe.yaml) Make a copy of the recipe and edit the key:value pairs in it according to your needs Make sure that you have the correct docker image registry, name, and tag spcified for all the components. Set the values of extsvcaux/ricip and extsvcaux/auxip to be the external IP addresses of VM hosting RIC cluster and VM hosting AUX cluster, respectively. Then run the following to deploy:

$ . ./deploy-ric-platform -f <PATH_TO_YOUR_MODIFIED_RECIPE>

Run the following to undeploy:

$ . ./undeploy-ric-platform 

To deploy RIC Auxiliary functions

Choose a deployment recipe (e.g, ./RECIPE_EXAMPLE/AUX/amber_example_recipe.yaml) Make a copy of the recipe and edit the key:value pairs in it according to your needs Set the values of extsvcaux/ricip and extsvcaux/auxip to be the external IP addresses of VM hosting RIC cluster and VM hosting AUX cluster, respectively.

$ . ./deploy-ric-aux -f <PATH_TO_YOUR_MODIFIED_RECIPE>

Run the following to undeploy:

$ . ./undeploy-ric-aux