Skip to navigation

Common Helm Configuration

View as MarkdownOpen in Claude

This page covers Helm values that apply to any LipSync NIM service chart deployment. The same keys appear under nvidia-lipsync-h4m-service.<key> when the NIM is deployed as part of the End-to-End Demo Chart.


Global Overrides

Both the NIM service chart and the end-to-end sample (umbrella) chart expose a global section. When a global value is non-empty, it overrides the corresponding per-component key for all subcharts (sender, receiver, and NIM service). Leave a value as "" to use each component’s own setting instead.

ConfigurationHelm KeyOverridesComment
Node placementglobal.nodeSelector.hostname<component>.nodeSelector.hostnameSchedule all pods on the same node.
Image pull secretglobal.image.secret<component>.image.secretSingle docker-registry secret name for nvcr.io across all components.
Multus networkglobal.network.name<component>.network.nameNetworkAttachmentDefinition name; must match for ST 2110 traffic. See High-Speed Network Configuration.
Schedulerglobal.schedulerName<component>.schedulerNamePod spec.schedulerName for all components. See Scheduler Requirements for NUMA-aware Clusters.
HTTP endpoint Service typeglobal.service.type<component>.service.typeSets the Kubernetes Service type for each component endpoint (sender, receiver, NIM). Supported values: ClusterIP, NodePort, LoadBalancer. Default is NodePort. Use ClusterIP for internal access only and LoadBalancer for external access.

Use global values when deploying the umbrella chart so that node selector, pull secret, network, and scheduler need to be specified only once instead of per component.


Cluster and Workload

ConfigurationHelm KeyComment
Deploy NIM workloadenabledDefault: chart-dependent; set false to skip NIM. (For example, partial demo chart installation.)
Name prefixappNameDeployment and pod naming.
ReplicasreplicasDefault: 1 for GPU media functions.
Node placementnodeSelector.hostnameMatches kubernetes.io/hostname (or cluster labels).
SchedulerschedulerNameOften topo-aware-scheduler; confirm for your chart version. See Scheduler Requirements for NUMA-aware Clusters.
Container imageimage.repository, image.tagPublished NIM image.
Image pull secretimage.secretThe docker-registry secret name for nvcr.io.
Container securitycontainerSecurityContext.*Includes runAsUser, runAsGroup, runAsNonRoot, allowPrivilegeEscalation, and capabilities.

NGC and Model Download

ConfigurationHelm KeyComment
Model download secretngcApiKeySecret.nameSecret containing NGC_API_KEY.
Secret key namengcApiKeySecret.keyDefault: NGC_API_KEY.

Model Cache and Logs PVCs

ConfigurationHelm KeyComment
Model cache PVCnimModelCache.*Default path: /opt/nim/.cache.
Server logs PVCserverLogs.*Default path: /var/log/lipsync.

Subkeys: enabled, size, storageClassName. For configuration examples, see Advanced Usage.


NMOS

ConfigurationHelm KeyEnvironment VariableComment
NMOS discovery modenmos.enabledLIPSYNC_NMOS_ENABLEDtrue or false; false requires fixed SMPTE ST 2110 (static mode) only.
Advertised hostnamenmos.hostnameLIPSYNC_NMOS_HOSTNAMENMOS advertisement.
Descriptionnmos.descriptionLIPSYNC_NMOS_DESCRIPTIONNMOS description string.
Labelnmos.labelLIPSYNC_NMOS_LABELNMOS label string.

NMOS HTTP port 9010 and the Multus network attachment media-a-tx-net are often set in chart templates. Confirm for your chart version.


See Also