This wiki is meant to detail the approach and steps taken to automate the deployment and testing of the ORAN SC SMO package including validating sample use cases.
Automation is key nowadays and deployment and testing needs to be repeatable and portable.
In order to achieve a certain level of automation with the ORAN SC software we took the following steps :
The End goal is to provide the community with a mean to deploy the SMO and its test environment with a minimum set of requirements, ultimately this setup can be used on a lab to automatically validate code changes and report issues directly in code review tools.
The setup as pictured in this wiki, is by no means closed, it can be easily extended thanks to the flexibility of all the tools that were chosen.
The picture below describes the environment from a high level and the various entities that are deployed with this setup
The basis is a standard VM or node running a recent Ubuntu release where a Kubernetes cluster is setup (that cluster can also be remote if needed as long as it is accessible from the host VM)
The deployment layout is explained in the readme file of the repository but in a nutshell it is composed of :
The Jenkins instance will act as a Meta executor to orchestrate the deployment and execute the set of tests.
This layout provides all the needed configuration for the embedded Jenkins instance to interact with the cluster and connect to remote repositories
The target deployment environment is quite flexible thanks to the chart configurations and options.
The minimum setup requires :
1 VM or host with
Note : make sure your user has enough privileges to execute the commands that are listed below, some may imply to grant your user sudo privileges or manipulate users/groups so that these can be executed
Download the IT/dep repository from gerrit at the following location :
git clone --recurse-submodules https://gerrit.o-ran-sc.org/r/it/dep.git
Note that you need to add the recurse sub modules flag as some parts are git submodules pointing to existing related charts (ONAP)
The installation is quite straight forward, several utility scripts are available from the repository to allow the user to setup all/some of the components independently
Please have a look at the embedded readme file located under dep/smo-install, it provides a full description of the content and how to setup various flavors of the environment
This section describes how to access and use the setup that has been deployed, it allows the user to configure, run and analyze tests results on ORAN SC package, it can also serve as a validation tool for incoming code changes
Once the system is boot strapped, a new namespace called 'test' should appear on your Kubernetes environment.
you should be able to access the jenkins instance by opening a browser to :
http://<your k8s host>:32080/
All Jobs are auto provisioned by the deployment to be able to :
Link to be added