ODU Deployment via tacker¶
Initial Setup Preparation¶
Setup devstack(Openstack and Kubernetes as VIM) environment
Note
In above document Refer “Openstack and Kubernetes as VIM” section to install Kubernetes as VIM.
Setup Helm VIM
Preconditions¶
Create a directory
$ mkdir ODU_CONTAINER
Navigate to the directory
$ cd ODU_CONTAINER
Clone the ODU(high) repository
$ git clone https://gerrit.o-ran-sc.org/r/o-du/l2
Generate Docker Image
$ cd l2 $ docker build -f Dockerfile.du -t <my-image>:<tag> docker build -f Dockerfile.du -t new-du-container:v1 .
Check if the Docker images are created
$ docker images
Upload ODU image to quay.io repository
$ docker login quay.io $ docker <tag> <my-image> quay.io/<myrepository>/<my-image> $ docker push quay.io/<myrepository>/<my-image>
Note
An account is mandatory on quay.io because during ODU pod deployment image is pulled form quay.io repository.
Verify Image
$ docker pull quay.io/<myrepository>/<my-image>
Prepare Helm VNF Package for ODU Deployment using tacker¶
Prepare VNF Package. The sample VNF Package used in this guide is stored in
o2/tacker/samples/packages/odu_v2directory.$ cd /opt/stack $ git clone https://gerrit.o-ran-sc.org/r/smo/o2 $ cd o2/tacker/samples/packages/odu_v2 $ ls Definitions Files inst.json TOSCA-Metadata Scripts
Change repository value in Helm chart
Update the value of “repository” with ODU image name uploaded to quay.io repository in values.yaml file.
$ cd Files/Kubernetes/test-chart $ vi values.yaml image: repository: <myrepository>/<my-image> #change repository value here # pullPolicy: IfNotPresent # Overrides the image tag whose default is the chart appVersion. tag: v1
Compress VNF Package
$ cd /opt/stack/o2/tacker/samples/packages/odu_v2/Files/Kubernetes $ tar -cvzf test-chart-0.1.0.tgz test-chart/
Change hash value in TOSCA.meta file using below command-
$ cd /opt/stack/o2/tacker/samples/packages/odu_v2/ $ sha256sum Files/kubernetes/test-chart-0.1.0.tgz fa05dd35f45adb43ff1c6c77675ac82c477c5a55a3ad14a87a6b542c21cf4f7c Name: Files/kubernetes/test-chart-0.1.0.tgz Content-Type: test-data Algorithm: SHA-256 Hash: fa05dd35f45adb43ff1c6c77675ac82c477c5a55a3ad14a87a6b542c21cf4f7c #change hash key
Compress the VNF Package
$ zip -r cnf.zip Definitions Files TOSCA-Metadata Scripts
Create and Upload VNF Package¶
Create VNF Package
$ openstack vnf package create +-------------------+-------------------------------------------------------------------------------------------------+ | Field | Value | +-------------------+-------------------------------------------------------------------------------------------------+ | ID | cb784ab4-2d0f-46f9-a0f1-37ade6661acf | | Links | { | | | "self": { | | | "href": "/vnfpkgm/v1/vnf_packages/cb784ab4-2d0f-46f9-a0f1-37ade6661acf" | | | }, | | | "packageContent": { | | | "href": "/vnfpkgm/v1/vnf_packages/cb784ab4-2d0f-46f9-a0f1-37ade6661acf/package_content" | | | } | | | } | | Onboarding State | CREATED | | Operational State | DISABLED | | Usage State | NOT_IN_USE | | User Defined Data | {} | +-------------------+-------------------------------------------------------------------------------------------------+
Upload VNF Package
$ openstack vnf package upload --path cnf.zip cb784ab4-2d0f-46f9-a0f1-37ade6661acf Upload request for VNF package 9c9e71b2-2710-43f2-913c-3c53f056fad1 has been accepted.
Get VNFD ID
$ openstack vnf package show cb784ab4-2d0f-46f9-a0f1-37ade6661acf -c "VNFD ID" +--------------------------------------+ | ID | +--------------------------------------+ | 6fd8696a-2c3a-48e9-8f59-3cbb250844c3 | +--------------------------------------+
Create and Instantiate VNF¶
Create VNF
$ openstack vnflcm create 6fd8696a-2c3a-48e9-8f59-3cbb250844c3 --os-tacker-api 2 +-----------------------------+------------------------------------------------------------------------------------------------------------------+ | Field | Value | +-----------------------------+------------------------------------------------------------------------------------------------------------------+ | ID | f770aa83-1a9c-4c8e-9bce-fc9d1e652c25 | | Instantiation State | NOT_INSTANTIATED | | Links | { | | | "self": { | | | "href": "http://127.0.0.1:9890/vnflcm/v2/vnf_instances/f770aa83-1a9c-4c8e-9bce-fc9d1e652c25" | | | }, | | | "instantiate": { | | | "href": "http://127.0.0.1:9890/vnflcm/v2/vnf_instances/f770aa83-1a9c-4c8e-9bce-fc9d1e652c25/instantiate" | | | } | | | } | | VNF Configurable Properties | | | VNF Instance Description | | | VNF Instance Name | | | VNF Product Name | Sample CNF | | VNF Provider | Company | | VNF Software Version | 1.0 | | VNFD ID | 6fd8696a-2c3a-48e9-8f59-3cbb250844c3 | | VNFD Version | 1.0 | +-----------------------------+------------------------------------------------------------------------------------------------------------------+
Instantiate VNF
A json file which includes Helm VIM information and additionalParams should be provided for instantiating a containerized VNF.
$ cat inst.json { "flavourId": "simple", "vimConnectionInfo": { "vim1": { "vimId": "897af4d6-9340-4f81-87ca-2bb6b13ca4f7", "vimType": "kubernetes" } }, "additionalParams": { "helm_chart_path": "Files/kubernetes/test-chart-0.1.0.tgz", "helm_parameters": { "service.port": 8081, "service.type": "NodePort" }, "helm_value_names": { "VDU1": { "replica": "replicaCountVdu1" }, "odu": { "replica": "replicaCountodu" } }, "namespace": "default" } }
Instantiate VNF created in first step using the json file mentioned above.
$ openstack vnflcm instantiate f770aa83-1a9c-4c8e-9bce-fc9d1e652c25 inst.json --os-tacker-api-version 2 Instantiate request for VNF Instance f770aa83-1a9c-4c8e-9bce-fc9d1e652c25 has been accepted.
Check ODU status¶
Helm status
$ helm list NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION vnff770aa831a9c4c8e9bcefc9d1e652c25 default 1 2025-06-02 05:51:18.013317536 +0000 UTC deployed du-0.1.0 1.16.0
Pod status
$ kubectl get pods NAME READY STATUS RESTARTS AGE vnff770aa831a9c4c8e9bcefc9d1e652c25-du-d5887d5dc-gh6xg 1/1 Running 0 7d4h
VNF Status
$ openstack vnflcm list --os-tacker-api 2 | grep f770aa83-1a9c-4c8e-9bce-fc9d1e652c25 +--------------------------------------+-------------------+---------------------+--------------+----------------------+------------------+--------------------------------------+ | ID | VNF Instance Name | Instantiation State | VNF Provider | VNF Software Version | VNF Product Name | VNFD ID | +--------------------------------------+-------------------+---------------------+--------------+----------------------+------------------+--------------------------------------+ | f770aa83-1a9c-4c8e-9bce-fc9d1e652c25 | | INSTANTIATED | Company | 1.0 | Sample VNF | 6fd8696a-2c3a-48e9-8f59-3cbb250844c3 | +--------------------------------------+-------------------+---------------------+--------------+----------------------+------------------+--------------------------------------+