NGC Catalog
CLASSIC
Welcome Guest
Helm Charts
NMOS Registry Helm Chart

NMOS Registry Helm Chart

For versions and more information, please view on a desktop device.
Logo for NMOS Registry Helm Chart
Description
This is a Helm chart package to manage NMOS Registry deployment on your Kubernetes cluster.
Publisher
NVIDIA
Latest Version
0.1.6
Compressed Size
29.64 KB
Modified
December 11, 2024
NMOS logo

NMOS Registry Helm Chart

Basic Introduction

This is a Helm chart package to manage NMOS Registry deployment on your Kubernetes cluster.

Prerequisites

  • Image pull secret
    • Create a secret to pull images from the NGC registry in the same namespace as the pod that uses it:
      kubectl create secret docker-registry <secret-name> --docker-server=nvcr.io '--docker-username=$oauthtoken' --docker-password=<API-KEY> --docker-email=<your-email> -n <your-namespace>
      
      where:
      • <secret-name> is a short name like alice-ngc-secret to be used on your local system when deploying applications
      • <API-KEY> is your NGC API Key
      • <your-email> is the e-mail address you used to sign up for NGC
      • <your-namespace> is the Kubernetes namespace in which you are going to deploy applications, often just default when you're getting started
  • Prometheus Log Exporter
    • If prometheusExporter is enabled, ensure Monitoring Stack Helm Chart is installed in order to collect and visualise the exported logs.

Installation

Using NGC CLI and NGC Web UI

Please see the NGC Helm Charts documentation for general guidance.

Using Helm Dashboard

This Helm chart can be installed on your Kubernetes cluster using the Helm Dashboard UI once the Helm Dashboard Helm Chart is installed.

Using Helm

  1. Login to the NGC registry

    helm registry login nvcr.io
    
  2. Add repo on your local system

    helm repo add <your-repo-name> https://helm.ngc.nvidia.com/nvidia/holoscan-for-media/ '--username=$oauthtoken' --password=<API-KEY>
    

    where:

    • <your-repo-name> is a short name like holoscan-for-media to be used on your local system to indicate the chart repository on NGC specified by the URL
    • <API-KEY> is your NGC API Key
  3. Update the repo or fetch particular chart

    helm repo update
    

    or

    helm pull <your-repo-name>/nmos-cpp-registry
    

    where:

    • <your-repo-name> is the short name you used in the helm repo add command above
  4. Now you can see all the charts available

    helm search repo
    
  5. You are ready to install NMOS Registry using its Helm chart

    Install using below command if the image pull secret was created beforehand as mentioned in prerequisites

    helm install --set imagePullSecrets[0].name=<secret-name>,highSpeedNetwork.name=media-a-rx-net-static,highSpeedNetwork.ip=<ip-address>,prometheusExporter.enabled=<prom-enabled> <release-name> <your-repo-name>/nmos-cpp-registry
    

    else

    helm install --set imageCredentials.password=<API-KEY>,highSpeedNetwork.name=media-a-rx-net-static,highSpeedNetwork.ip=<ip-address>,prometheusExporter.enabled=<true-or-false> <release-name> <your-repo-name>/nmos-cpp-registry
    

    where:

    • <secret-name> is the short name you used in the kubectl create secret command above
    • <API-KEY> is your NGC API Key
    • <ip-address> is a static IP address on the high-speed secondary network of your cluster you want to allocate to this particular installation of this application
    • <prom-enabled> is true or false depending on whether you want to collect logs from the application
    • <release-name> is a short name, like helm-dashboard, which should be unique on your local system, to indicate this particular installation of this application
    • <your-repo-name> is the short name you used in the helm repo add command above
  6. After installation you can check the status

    kubectl get all -o wide
    
  7. Once the pod is running you can use the NMOS Registry

    Access it via the high-speed secondary network, at http://<ip-address>:<http_port>/ where:

    • <ip-address> is the IP address specified in the helm install command above
    • <http_port> is 8010 by default; it can be overridden in the RegistryConfig in the helm install command (see the values.yaml file)
  8. Other commands to manage the installed application

    helm status <release-name>
    helm get all <release-name>
    helm uninstall <release-name>
    

    where:

    • <release-name> is the short name you used in the helm install command above

Additional Open-Source Software

This Helm chart will download and install additional third-party open-source container images. Review the license terms of these open source projects before use.

Security Considerations

Helm chart requires Vector sidecar to be run as privileged. This is so that Vector can write checkpoints for reading log files. In default configuration Vector sidecar is not enabled.