This page describes how to build release J Release K version of Non-RT RIC.
| Info | ||
|---|---|---|
| ||
In general, there is no need to build the images manually. Building from scratch is error-prone, and some development experience is required. All images for the release are available in nexus image repositories. Please refer to the page Release J K - Run in Docker for running the release I Non-RT RIC. |
Details of the architecture can be found from Release JK page.
(Note: The actual docker image version numbers/tags may be different from the instructions below as development continues in the relevant repositories)
...
- Java 17 (make sure that JAVA_HOME environment variable points to correct Java version).
- Docker and docker-compose (latest).
- git (latest) - for downloading code repos.
Maven 3.6 and in some cases Maven 3.8.
- Note: There are several build-time dependencies for ONAP Maven modules.
Your Maven build settings will need to access the ONAP Maven repos, as described on this ONAP wiki page. (A sample ONAP Maven settings file is available).
- Note: There are several build-time dependencies for ONAP Maven modules.
...
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/a1policymanagementservice" -b jk-release --recursive
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/dmaapadapterrappmanager" -b jk-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/helmmanagersme" -b hk-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/informationcoordinatorservicedmaapadapter" -b hj-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/rappcataloguehelmmanager" -b hj-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/informationcoordinatorservice" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/dmaapmediatorproducer/rappcatalogue" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric" -b hj-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/rappplt/ransliceassurancedmaapmediatorproducer" -b hj-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/rapp/orufhrecoveryransliceassurance" -b h-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/pltrapp/smeorufhrecovery" -b jg-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/ranpm" -b j-release
To build docker images of a1policymanagementservice, dmaapadapter, helmmanager, informationcoordinatorservice, and rappcatalogue; go into the repo of each product and run the following command:
...
The following images need to be built manually before installation of ranpm. If remote or multi node cluster is used, then an image repo should be availbale available to push the built images to. if external repo is used, use the same repo for all built images and configure the responame reponame in 'helm/global-values.yaml' (The parameter value shall have a trailing '/' followed by the username)
...
The installation of ranpm is made by a few scripts. The main part of ranpm is installed by a single script. Then, additional parts can be added on top. All installations in kubernetes Kubernetes is made by helm charts. (NOTE: The install scipts scripts should be executed in the below order only)
- install-nrt.sh: Installs the main parts of the ranpm setup.
- install-pm-log.sh: Installs the producer for influx db
- install-pm-influx-job.sh: Sets up an alternative job to produce data stored in influx db.
- install-pm-rapp.sh: Installs
...
- an rapp that subscribe and print out received data.
If the build was successful images with following name and tag shall be built. Use the command 'docker images' to view newly built images in the local docker registry.
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ docker images o-ran-sc/nonrtric-plt-a1policymanagementservice 2.89.0 o-ran-sc/nonrtric-plt-dmaapadapter 1.4.0 o-ran-sc/nonrtric-plt-helmmanager 1.3.0 o-ran-sc/nonrtric-plt-informationcoordinatorservice 1.76.01 o-ran-sc/nonrtric-plt-rappcatalogue 1.2.0 o-ran-sc/nonrtric-plt-rappcatalogue-enhanced 1.2.0 o-ran-sc/nonrtric-plt-auth-token-fetch 1.1.1 o-ran-sc/nonrtric-plt-dmaapmediatorproducer 1.2.0 o-ran-sc/nonrtric-rapp-ransliceassurance-icsversion 1.2.0 o-ran-sc/nonrtric-rapp-ransliceassurance 1.3.0 o-ran-sc/nonrtric-rapp-orufhrecovery 1.1.0 o-ran-sc/nonrtric-plt-capifcore 1.3.1 o-ran-sc/nonrtric-plt-ranpm-datafilecollector 1.1.0 o-ran-sc/nonrtric-plt-pmlog 1.1.0 o-ran-sc/nonrtric-plt-ranpm-pm-file-converter 1.1.1 o-ran-sc/nonrtric-plt-pmproducer 1.1.0 |
...
git clone "https://gerrit.o-ran-sc.org/r/sim/a1-interface" -b jk-release
Create docker image
To create docker image A1 simulator (note that the given image name must match the name given in docker startup later):
...
git clone "https://gerrit.o-ran-sc.org/r/portal/nonrtric-controlpanel" -b i-release
Build the code and create docker images
| Code Block | ||
|---|---|---|
| ||
cd nonrtric-controlpanel cd nonrtric-gateway mvn clean install -Dmaven.test.skip=true docker build --build-arg JAR=nonrtric-gateway-1.13.0-SNAPSHOT.jar -t o-ran-sc/nonrtric-gateway:1.23.0-SNAPSHOT . cd ../webapp-frontend docker build -t o-ran-sc/nonrtric-controlpanel:2.56.0-SNAPSHOT . |
Using the command below you can check that the names below are in the list of available images.
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ docker images o-ran-sc/nonrtric-gateway 1.23.0-SNAPSHOT o-ran-sc/nonrtric-controlpanel 2.56.0-SNAPSHOT |
(Note: The actual docker image version numbers/tags may be different as development continues in the relevant repositories)