OS Manuals

/usr/bin/compute-domain-controller

Kubernetes Dynamic Resource Allocation (DRA) driver for NVIDIA GPUs and multi-node NVLink ComputeDomains (IMEX)

From dra-driver-nvidia-gpu 0.5.1-r2 (enterprise-packages), captured 2026-11-08 by running compute-domain-controller --help (exit 0). permalink

NAME:
   compute-domain-controller - compute-domain-controller implements a DRA driver controller for NVIDIA compute domains.

USAGE:
   compute-domain-controller [global options]

VERSION:
   v0.5.1
commit: b04b41531423b490cc01b5d196d9955b9b862878

GLOBAL OPTIONS:
   --additional-namespaces value [ --additional-namespaces value ]  Additional namespaces where the driver can manage resources. [$ADDITIONAL_NAMESPACES]
   --cd-daemon-image-pull-secret-names value                        Comma-separated imagePullSecret names for compute-domain-daemon DaemonSets (e.g. regcred,other). Empty string means none. [$CD_DAEMON_IMAGE_PULL_SECRET_NAMES]
   --cd-daemon-priority-class-name value                            PriorityClassName applied to dynamically rendered compute-domain-daemon DaemonSet pods. [$CD_DAEMON_PRIORITY_CLASS_NAME]
   --help, -h                                                       show help
   --image-name value                                               The full image name to use for rendering templates. [$IMAGE_NAME]
   --imex-config-overrides value                                    Comma-separated KEY=VALUE overrides for arbitrary nvidia-imex daemon config file settings generated in the driverManaged mode. [$IMEX_CONFIG_OVERRIDES]
   --imex-isolation value                                           IMEX isolation strategy: domain (default; all workloads in the same IMEX domain share channel 0) or channel (not yet supported). (default: "domain") [$IMEX_ISOLATION]
   --imex-mode value                                                IMEX deployment mode: driverManaged or hostManaged. (default: "driverManaged") [$IMEX_MODE]
   --log-verbosity-cd-daemon value                                  Log verbosity for dynamically launched CD daemon pods (default: 0) [$LOG_VERBOSITY_CD_DAEMON]
   --max-nodes-per-imex-domain value                                The maximum number of possible nodes per IMEX domain (default: 18) [$MAX_NODES_PER_IMEX_DOMAIN]
   --namespace value                                                The namespace of the pod this controller is running in. (default: "default") [$NAMESPACE]
   --pod-name value                                                 The name of the pod this controller is running in. [$POD_NAME]
   --version                                                        print the version

   Feature Gates:

   --feature-gates value  A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
     AllAlpha=true|false (ALPHA - default=false)
     AllBeta=true|false (BETA - default=false)
     ComputeDomainCliques=true|false (BETA - default=true)
     ConsumableShares=true|false (ALPHA - default=false)
     ContextualLogging=true|false (BETA - default=true)
     CrashOnNVLinkFabricErrors=true|false (BETA - default=true)
     DRAListTypeAttributes=true|false (ALPHA - default=false)
     DeviceMetadata=true|false (ALPHA - default=false)
     DynamicMIG=true|false (ALPHA - default=false)
     FabricManagerPartitioning=true|false (ALPHA - default=false)
     HostManagedIMEXDaemon=true|false (ALPHA - default=false)
     IMEXDaemonsWithDNSNames=true|false (BETA - default=true)
     LoggingAlphaOptions=true|false (ALPHA - default=false)
     LoggingBetaOptions=true|false (BETA - default=true)
     MPSSupport=true|false (ALPHA - default=false)
     NVMLDeviceHealthCheck=true|false (ALPHA - default=false)
     PassthroughSupport=true|false (ALPHA - default=false)
     TimeSlicingSettings=true|false (ALPHA - default=false) (default: ContextualLogging=true) [$FEATURE_GATES]

   HTTP server:

   --http-endpoint address  The TCP network address where the HTTP server for diagnostics, including pprof and metrics will listen (example: `:8080`). The default is the empty string, which means the server is disabled. [$HTTP_ENDPOINT]
   --metrics-path path      The HTTP path where Prometheus metrics will be exposed, disabled if empty. (default: "/metrics") [$METRICS_PATH]
   --pprof-path path        The HTTP path where pprof profiling will be available, disabled if empty. [$PPROF_PATH]

   Kubernetes client:

   --kube-api-burst Burst   Burst to use while communicating with the Kubernetes apiserver. (default: 10) [$KUBE_API_BURST]
   --kube-api-qps QPS       QPS to use while communicating with the Kubernetes apiserver. (default: 5) [$KUBE_API_QPS]
   --kubeconfig KUBECONFIG  Absolute path to the KUBECONFIG file. Either this flag or the KUBECONFIG env variable need to be set if the driver is being run out of cluster. [$KUBECONFIG]

   Leader election:

   --leader-election-enabled                     Start a leader election client and gain leadership before executing the main loop. Enable this when running replicated components for high availability. (default: false) [$LEADER_ELECTION_ENABLED]
   --leader-election-lease-duration value        The duration that non-leader candidates will wait to force acquire leadership. This is measured against time of last observed ack. (default: 15s) [$LEADER_ELECTION_LEASE_DURATION]
   --leader-election-lease-lock-name value       The lease lock resource name. (default: "nvidia-compute-domain-controller") [$LEADER_ELECTION_LEASE_LOCK_NAME]
   --leader-election-lease-lock-namespace value  The lease lock resource namespace. (default: "default") [$LEADER_ELECTION_LEASE_LOCK_NAMESPACE]
   --leader-election-renew-deadline value        The duration that the acting controlplane will retry refreshing leadership before giving up. (default: 10s) [$LEADER_ELECTION_RENEW_DEADLINE]
   --leader-election-retry-period value          The duration the LeaderElector clients should wait between tries of actions. (default: 2s) [$LEADER_ELECTION_RETRY_PERIOD]

   Logging:

   --log-flush-frequency value        Maximum number of seconds between log flushes (default: 5s) [$LOG_FLUSH_FREQUENCY]
   --log-json-info-buffer-size value  [Alpha] In JSON format with split output streams, the info messages can be buffered for a while to increase performance. The default value of zero bytes disables buffering. The size can be specified as number of bytes (512), multiples of 1000 (1K), multiples of 1024 (2Ki), or powers of those (3M, 4G, 5Mi, 6Gi). Enable the LoggingAlphaOptions feature gate to use this. (default: 0) [$LOG_JSON_INFO_BUFFER_SIZE]
   --log-json-split-stream value      [Alpha] In JSON format, write error messages to stderr and info messages to stdout. The default is to write a single stream to stdout. Enable the LoggingAlphaOptions feature gate to use this. (default: false) [$LOG_JSON_SPLIT_STREAM]
   --log-text-info-buffer-size value  [Alpha] In text format with split output streams, the info messages can be buffered for a while to increase performance. The default value of zero bytes disables buffering. The size can be specified as number of bytes (512), multiples of 1000 (1K), multiples of 1024 (2Ki), or powers of those (3M, 4G, 5Mi, 6Gi). Enable the LoggingAlphaOptions feature gate to use this. (default: 0) [$LOG_TEXT_INFO_BUFFER_SIZE]
   --log-text-split-stream value      [Alpha] In text format, write error messages to stderr and info messages to stdout. The default is to write a single stream to stdout. Enable the LoggingAlphaOptions feature gate to use this. (default: false) [$LOG_TEXT_SPLIT_STREAM]
   --logging-format value             Sets the log format. Permitted formats: "json" (gated by LoggingBetaOptions), "text". (default: text) [$LOGGING_FORMAT]
   --vmodule value                    comma-separated list of pattern=N settings for file-filtered logging (only works for text log format) [$VMODULE]
   -v value                           number for the log level verbosity (default: 0) [$V]
Options (34)
OptionDescriptionSource
--additional-namespaces valueAdditional namespaces where the driver can manage resources.help
--cd-daemon-image-pull-secret-names valueComma-separated imagePullSecret names for compute-domain-daemon DaemonSets (e.g. regcred,other).help
--cd-daemon-priority-class-name valuePriorityClassName applied to dynamically rendered compute-domain-daemon DaemonSet pods.help
--help, -hshow helphelp
--image-name valueThe full image name to use for rendering templates.help
--imex-config-overrides valueComma-separated KEY=VALUE overrides for arbitrary nvidia-imex daemon config file settings generated in the driverManaged mode.help
--imex-isolation valueIMEX isolation strategy: domain (default;help
--imex-mode valueIMEX deployment mode: driverManaged or hostManaged.help
--log-verbosity-cd-daemon valueLog verbosity for dynamically launched CD daemon pods (default: 0) [$LOG_VERBOSITY_CD_DAEMON]help
--max-nodes-per-imex-domain valueThe maximum number of possible nodes per IMEX domain (default: 18) [$MAX_NODES_PER_IMEX_DOMAIN]help
--namespace valueThe namespace of the pod this controller is running in.help
--pod-name valueThe name of the pod this controller is running in.help
--versionprint the versionhelp
--feature-gates valueA set of key=value pairs that describe feature gates for alpha/experimental features.help
--http-endpoint addressThe TCP network address where the HTTP server for diagnostics, including pprof and metrics will listen (example: `:8080`).help
--metrics-path pathThe HTTP path where Prometheus metrics will be exposed, disabled if empty.help
--pprof-path pathThe HTTP path where pprof profiling will be available, disabled if empty.help
--kube-api-burst BurstBurst to use while communicating with the Kubernetes apiserver.help
--kube-api-qps QPSQPS to use while communicating with the Kubernetes apiserver.help
--kubeconfig KUBECONFIGAbsolute path to the KUBECONFIG file.help
--leader-election-enabledStart a leader election client and gain leadership before executing the main loop.help
--leader-election-lease-duration valueThe duration that non-leader candidates will wait to force acquire leadership.help
--leader-election-lease-lock-name valueThe lease lock resource name.help
--leader-election-lease-lock-namespace valueThe lease lock resource namespace.help
--leader-election-renew-deadline valueThe duration that the acting controlplane will retry refreshing leadership before giving up.help
--leader-election-retry-period valueThe duration the LeaderElector clients should wait between tries of actions.help
--log-flush-frequency valueMaximum number of seconds between log flushes (default: 5s) [$LOG_FLUSH_FREQUENCY]help
--log-json-info-buffer-size value[Alpha] In JSON format with split output streams, the info messages can be buffered for a while to increase performance.help
--log-json-split-stream value[Alpha] In JSON format, write error messages to stderr and info messages to stdout.help
--log-text-info-buffer-size value[Alpha] In text format with split output streams, the info messages can be buffered for a while to increase performance.help
--log-text-split-stream value[Alpha] In text format, write error messages to stderr and info messages to stdout.help
--logging-format valueSets the log format.help
--vmodule valuecomma-separated list of pattern=N settings for file-filtered logging (only works for text log format) [$VMODULE]help
-v valuenumber for the log level verbosity (default: 0) [$V]help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.