X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=README.md;h=02860d78d240dc137712e1b0c9c6123851c92e0a;hb=refs%2Fchanges%2F34%2F1234%2F9;hp=6b84be252f6acea11b119577308f31cec81fc5d0;hpb=2df61c2fcf64b32ecf7f064ef9cbbe6b54a15bc0;p=it%2Fdep.git diff --git a/README.md b/README.md index 6b84be25..02860d78 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ This repo contains RAN Intelligent Controller (RIC) deployments related files. 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 value.yaml file. If no deployment recipe is provided, defaul parameters +deployment recipe is acting as the helm override values.yaml file. If no deployment recipe is provided, default parameters are used. The default parameters are set up to deploy a RIC instance using Linux Foundation repositories in a self-contained environment. @@ -15,19 +15,21 @@ self-contained environment. ### Directory Structure . ├── bin +├── ci ├── etc ├── 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 auxiliry functions +├── 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-infra Deployment scripts, charts and configuration files for infrastructure support ├── ric-platform Deployment scripts, charts and configuration files for RIC platform components └── ric-xapps xApp related scripts, charts and configuration files ### Directory Naming Convention -The root directories are orgainzed according to the deployment plans. Each directory contains subdirectories for -different deployable components. The prefix of these subdirectories represents the deployment order. The smaller the +The root directories are organized according to the deployment plans. Each directory contains subdirectories for +different deployable components. The prefixes of these subdirectories represent the deployment order. The smaller the prefix number the eariler the corresponding component will be deployed. Consider the following example, ├── ric-aux │   ├── 80-Auxiliary-Functions @@ -37,23 +39,76 @@ prefix number the eariler the corresponding component will be deployed. Conside │   ├── 00-Kubernetes │   ├── 10-Nexus │   ├── 20-Monitoring +│   ├── 30-Kong │   ├── 40-Credential +│   ├── 45-Tiller │   └── README.md ├── ric-platform │   ├── 50-RIC-Platform │   ├── 55-Ext-Services │   └── README.md +├── ric-aux +│   ├── 80-Auxiliary-Functions +│   ├── 85-Ext-Services +│   └── README.md └── ric-xapps ├── 90-xApps └── README.md -when deploys the ric-platform, the credential is deployed before RIC-Platform. -In each of the component directory, ./etc contains the configuration file, ./bin contains the binary and script files, -./helm contains the helm charts, and ./docker contains docker related files for building the docker images. Please refer -to the README.md files in individual directory for more details. +when deploying the ric-platform, the credential is deployed before RIC-Platform. + +In each of the component directories, ./bin contains the binary and script files and ./helm contains the helm charts, + +Some components contain an ./etc directory with configuration files and some contain a ./docker directory with docker related files for building the docker images. + +Please refer to the README.md files in individual directory for more details. + +Within ric-infra, ric-platform and ric-aux, each of the components above can be deployed and undeployed separately. +There are also scripts for deploying the ric-infra, ric-platform or ric-aux in its entirety. + +The ./bin directory contains these scripts + +The following sections discuss one-script deployment for each + +### To deploy RIC Infrastructure + +Edit ./RECIPE_EXAMPLE/RIC_INFRA_RECIPE_EXAMPLE +You can choose whether to enable Kubernetes deployment, Helm Chart museum and ELFKP stack +You can specify the Helm release prefix and namespaces used +You must specify username and password for Docker repo +Then run the following to deploy: +```sh +$ . ./deploy-ric-infra -f ../RECIPE_EXAMPLE/RIC_INFRA_RECIPE_EXAMPLE +``` +Run the following to undeploy: +```sh +$ . ./undeploy-ric-infra +``` + +### To deploy RIC Platform + +Edit ./RECIPE_EXAMPLE/RIC_PLATFORM_RECIPE_EXAMPLE +You can specify the Helm release prefix and namespaces used +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. +These values should be set in both the override file and the local values.yaml file +```sh +$ . ./deploy-ric-platform -f ../RECIPE_EXAMPLE/RIC_PLATFORM_RECIPE_EXAMPLE +``` +Run the following to undeploy: +```sh +$ . ./undeploy-ric-platform +``` -### To deploy RIC -TBD will update when we have the root installer. +### To deploy RIC Auxiliary functions -### Configure the RIC deployment -TBD will update when we have the root installer. +Edit ./RECIPE_EXAMPLE/RIC_PLATFORM_RECIPE_EXAMPLE +You can specify the Helm release prefix and namespaces used +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. +These values should be set in both the override file and the local values.yaml file +```sh +$ . ./deploy-ric-aux -f ../RECIPE_EXAMPLE/RIC_AUX_RECIPE_EXAMPLE +``` +Run the following to undeploy: +```sh +$ . ./undeploy-ric-aux +```