This guide deploys
onos-uenib through its Helm chart assumes you have a Kubernetes cluster running
with an atomix controller deployed in a namespace.
onos-uenib Helm chart is based on Helm 3.0 version, with no need for the Tiller pod to be present.
If you don’t have a cluster running and want to try on your local machine please follow first
the Kubernetes setup steps outlined in deploy with Helm.
The following steps assume you have the setup outlined in that page, including the
micro-onos namespace configured.
To install the
onos-topo published chart in the
micro-onos namespace run:
$ helm -n micro-onos install onos-uenib sdran/onos-uenib
Note, that this assumes that
https://sdrancharts.onosproject.org was added as
sdran Helm repo.
Alternately, you can deploy your own version of the chart from the root directory of the
repo via the following:
$ helm install -n micro-onos onos-uenib onos-uenib
In either case, the output of the
helm install command should look similar to the following:
NAME: onos-uenib LAST DEPLOYED: Wed Jul 14 14:41:16 2021 NAMESPACE: micro-onos STATUS: deployed REVISION: 1 TEST SUITE: None
helm install assigns a unique name to the chart and displays all the k8s resources that were
created by it. To list the charts that are installed and view their statuses, run
$ helm -n micro-onos ls NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION onos-uenib micro-onos 1 2021-07-14 14:41:16.860966 -0700 PDT deployed onos-uenib-1.0.3 v0.0.3
onos-uenib chart also deploys a custom Atomix
PartitionSet resource to store all the
topology information in a replicated and fail-safe manner.
In the following example there is only one partition set deployed
$ kubectl -n micro-onos get pods NAME READY STATUS RESTARTS AGE onos-uenib-5d49c8d8b6-wbkl2 2/3 Running 0 3m8s onos-uenib-consensus-store-1-0 1/1 Running 0 3m6s
One can customize the number of partitions and replicas by modifying, in
the values of
partitions: 1 partitionSize: 1
To uninstall the
onos-uenib chart, run the following:
helm delete -n micro-onos onos-uenib
Helm offers two flags to help you debug your chart. This can be useful if your chart does not install, the pod is not running for some reason, or you want to trouble-shoot custom configuration values,
--dry-runcheck the chart without actually installing the pod.
--debugprints out more information about your chart
helm install -n micro-onos onos-uenib --debug --dry-run onos-uenib/