Kubernetes Operator Chart
Overview
The nvidia-studio-voice-h4m-operator Helm chart installs the Studio Voice Kubernetes operator. The controller watches NvidiaStudioVoiceMediaFunction custom resources and reconciles a deployment for the Studio Voice NIM, SDP ConfigMaps (/sdps), and status.
- Operator chart: Deploys only the controller and CRDs. It does not install an
NvidiaStudioVoiceMediaFunctioncustom resource or the NIM workload—apply a custom resource after installation to provision the NIM. - Operand: Each custom resource instance drives one Studio Voice NIM workload (audio in and enhanced audio out) according to the inputs, outputs, and parameters declared in that resource.
Installation
Prerequisites
Before running helm install, complete all prerequisite steps (Rivermax license, image pull and model pull secrets, GPU node, Multus attachment for SMPTE ST 2110). For more information, refer to Getting Started.
Pull the Chart
If not already done, add the Helm repository and pull the chart:
For the full repository setup, refer to Pull Helm Charts.
Helm Installation
The chart installs the operator deployment and registers the NvidiaStudioVoiceMediaFunction CRD. For all available Helm values and --set keys, refer to Operator Configuration.
The chart expects a pre-created image pull secret for nvcr.io (default name ngc-api-key). If your secret names differ, override as follows:
When the defaults match your cluster, you can use the following command:
The model pull secret and node hostname are set on the custom resource, not Helm values (spec.parameters.ngcSecret, spec.nodeSelector). Refer to Create the Custom Resource.
If helm install fails with an Apply failed with 1 conflict error citing the NvidiaStudioVoiceMediaFunction CRD, the CRD was previously applied with kubectl apply (field manager kubectl-client-side-apply) and Helm cannot take ownership of its fields. Take over the field manager once with kubectl replace, and then re-run helm install:
On Red Hat OpenShift, replace kubectl with oc.
Wait for the controller to be ready:
On Red Hat OpenShift, replace kubectl with oc.
Create the Custom Resource
After the operator controller is ready, save a manifest (for example, studio-voice-media-function.yaml) and configure the following areas:
Apply the manifest:
Applying the CR reconciles and starts the Studio Voice NIM in NMOS mode; refer to Chrome Remote Desktop for NMOS Connection Manager UI access and setup steps.
On Red Hat OpenShift, replace kubectl with oc.
Example Manifest
Reference a custom resource with a placeholder node name, ngc-api-key for model download, and audio format defaults.
Extended Parameters (Optional)
As needed, you can add optional spec.parameters fields, including resources (CPU, memory, GPU, hugepages) and nimLogs / nimModelCache PVC settings (path, pvc.enabled, pvc.size, pvc.storageClassName, pvc.claimName). For field-by-field details, refer to Operator Configuration in the configuration reference. For PVC configuration, refer to Advanced Usage. CPU affinity is set on the NIM service Helm chart (env.CPU_AFFINITY) and is not exposed on the custom resource.
Verify
After applying the custom resource:
Inspect custom resource status conditions:
Confirm the CRD is installed:
On Red Hat OpenShift, replace kubectl with oc. For log access, refer to Observability.
Uninstall
First, delete all custom resource instances so the operator can remove the managed deployments and ConfigMaps; then remove the Helm release. Delete the CRD cluster-wide only if coordinated with cluster administrators; it affects all namespaces.
On Red Hat OpenShift, replace kubectl with oc.
The *-model-cache and *-nim-logs PVCs carry helm.sh/resource-policy: keep and are not removed by helm uninstall. This preserves the cached model across reinstalls; clean them up manually when no longer needed:
For troubleshooting and known limitations, refer to Advanced Usage.
See Also
- Getting Started — NGC authentication, secrets, and prerequisites.
- Installation — Service, operator, and demo chart installation patterns.
- Configuration Reference — Helm values and operator custom resource field reference.