Installation

Prerequisites

Prerequisites for using ncm-issuer:

• NCM release 21 or later,
• Kubernetes version 1.24 - 1.29,
• cert-manager version 1.0.0 or later,
• Docker version 20.10.0 or later,
• Helm v3.

Note

Install docker-re instead of default if you are using CentOS, RedHat or Fedora!

Installing with Helm

The easiest way to install ncm-issuer in Kubernetes cluster is to use Helm. The image will be automatically downloaded from public repository.

Add the Helm repository:

helm repo add nokia https://nokia.github.io/ncm-issuer/charts

Update your local Helm chart repository cache:

helm repo update

Install ncm-issuer using the command:

helm install \
ncm-issuer nokia/ncm-issuer \
--create-namespace --namespace ncm-issuer 

On the other hand, if you did not add Helm repository, but downloaded the packaged version of ncm-issuer use:

helm install \
ncm-issuer \
--create-namespace --namespace ncm-issuer \
ncm-issuer/charts/ncm-issuer

Using own (local or remote) registry

In case you want to use your own registry, just change the value pointing to a specific registry in the values.yaml file in directory that contains Helm files. Then just repeat the steps mentioned above.

sed -i "s|docker.io/misiektoja|<your-registry>|g" values.yaml

Note

Using this command will also change the registry pointing to the image location of sidecar. Bear this in mind if you want to use sidecar as well.

However, if you do not know where to get image from, because you cloned the repository just use the command:

make docker-build

or (if you also want to save image)

make docker-save

Saved image should appear in the path ./builds/ncm-issuer-images/.