This page describes how to build 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 K - Run in Docker for running the release I Non-RT RIC. |
Details of the architecture can be found from Release K page.
...
Build NONRTRIC Docker containers
Coming soon.
...
Download the following repos:
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/a1policymanagementservice" -b k-release --recursive
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/rappmanager" -b k-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/sme" -b k-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/dmaapadapter" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/helmmanager" -b j-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/rappcatalogue" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/dmaapmediatorproducer" -b j-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/rapp/ransliceassurance" -b h-release
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/rapp/orufhrecovery" -b g-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:
| Code Block | ||
|---|---|---|
| ||
mvn clean install -Dmaven.test.skip=true |
To build docker image of nonrtric, go into the repo run the commands below. Use the version found in the file container-tag.yaml.
| Code Block | ||
|---|---|---|
| ||
cd auth-token-fetch
docker build -t o-ran-sc/nonrtric-plt-auth-token-fetch:<image-version> . |
To build docker image of the enhanced rappcatalogue, go into the repo rappcatalogue run the commands below. Use the version found in the file container-tag.yaml.
| Code Block | ||
|---|---|---|
| ||
cd catalogue-enhanced
docker build -t o-ran-sc/nonrtric-plt-rappcatalogue-enhanced:<image-version> . |
To build docker image of dmaapmediatorproducer, go into the repo run the command below. Use the version found in the file container-tag.yaml.
| Code Block | ||
|---|---|---|
| ||
docker build -t o-ran-sc/nonrtric-plt-dmaapmediatorproducer:<image-version> . |
To build docker images of the use cases for ransliceassurance, go into the repo for and run the command below. Note! The use case have two implementations, in subfolders. Choose the version needed and perform the build in the corresponding subfolder. Use the version found in the file container-tag.yaml in each subfolder.
| Code Block | ||
|---|---|---|
| ||
cd icsversion
docker build -t o-ran-sc/nonrtric-rapp-ransliceassurance-icsversion:<image-version> .
cd smoversion
docker build -t o-ran-sc/nonrtric-rapp-ransliceassurance:<image-version> . |
To build docker images of the use cases for orufhrecovery, go into the repo for and run the command below. Use the version found in the file container-tag.yaml.
| Code Block | ||
|---|---|---|
| ||
cd goversion
docker build -t o-ran-sc/nonrtric-o-ru-closed-loop-recovery:<image-version> . |
To build docker images sme, go into the repo for and run the command below. Use the version found in the file container-tag.yaml.
| Code Block | ||
|---|---|---|
| ||
cd capifcore
docker build -t o-ran-sc/nonrtric-plt-capifcore:<image-version> . |
To build docker images for ranpm, go into the repo and follow the steps below:
| Code Block | ||
|---|---|---|
| ||
cd ranpm/install |
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 available to push the built images to. if external repo is used, use the same repo for all built images and configure the reponame in 'helm/global-values.yaml' (The parameter value shall have a trailing '/' followed by the username)
- ranpm/https-server
- pm-rapp
| Code Block | ||
|---|---|---|
| ||
Build for internal kubernetes, execute the script below:
./build.sh no-push
Build for remote kubernetes, execute the script below:[Externally accessible image repo(E.x: docker hub) is needed]
./build.sh <external-image-repo>
|
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 is made by helm charts. (NOTE: The install 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.9.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.6.1
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 |
(Note: The actual docker image version numbers/tags may be different as development continues in the relevant repositories. Use the latest version numbers in the instructions below)
Build A1 simulator (previously called Near-RT RIC A1 Interface) container
Download the A1 simulator repo (defaults to master branch - the simulator supports all available A1 versions):
git clone "https://gerrit.o-ran-sc.org/r/sim/a1-interface" -b k-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):
| Code Block | ||
|---|---|---|
| ||
cd a1-interface/near-rt-ric-simulator
docker build -t near-rt-ric-simulator:latest . |
Using the command below you can check that the name below is in the list of available images.
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ docker images
near-rt-ric-simulator latest |
Build NONRTRIC Control panel and gateway containers
Download the nonrtric repo:
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.1.0-SNAPSHOT.jar -t o-ran-sc/nonrtric-gateway:1.2.0-SNAPSHOT .
cd ../webapp-frontend
docker build -t o-ran-sc/nonrtric-controlpanel:2.5.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.2.0-SNAPSHOT
o-ran-sc/nonrtric-controlpanel 2.5.0-SNAPSHOT |
(Note: The actual docker image version numbers/tags may be different as development continues in the relevant repositories)