OS Manuals

/usr/bin/vc-scheduler

subpackage for volcano scheduler

From vc-scheduler-fips 1.16.0-r3 (enterprise-packages), captured 2026-11-08 by running vc-scheduler --help (exit 0). permalink

Usage of /usr/bin/vc-scheduler:
      --add-dir-header                                       If true, adds the file directory to the header of the log messages
      --alsologtostderr                                      log to standard error as well as files (no effect when -logtostderr=true)
      --alsologtostderrthreshold severity                    logs at or above this threshold go to stderr when -alsologtostderr=true (no effect when -logtostderr=true)
      --ca-cert-file string                                  File containing the x509 Certificate for HTTPS.
      --cache-dump-dir string                                The target dir where the json file put at when dump cache info to json file (default "/tmp")
      --cache-dumper                                         Enable the cache dumper, it's true by default (default true)
      --csi-storage                                          When true (default), register CSIDriver and CSIStorageCapacity informers on the scheduler cache; set false to reduce API watches. Does not disable kube VolumeBinding capacity checks. (default true)
      --default-queue string                                 The default queue name of the job (default "default")
      --disable-default-scheduler-config                     The flag indicates whether the scheduler should avoid using the default configuration if the provided scheduler configuration is invalid.
      --enable-healthz                                       Enable the health check; it is false by default
      --enable-metrics                                       Enable the metrics function; it is false by default
      --enable-pprof                                         Enable the pprof endpoint; it is false by default
      --feature-gates mapStringBool                          A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
                                                             APIResponseCompression=true|false (BETA - default=true)
                                                             APIServerIdentity=true|false (BETA - default=true)
                                                             APIServingWithRoutine=true|false (ALPHA - default=false)
                                                             AllAlpha=true|false (ALPHA - default=false)
                                                             AllBeta=true|false (BETA - default=false)
                                                             AllowParsingUserUIDFromCertAuth=true|false (BETA - default=true)
                                                             AllowUnsafeMalformedObjectDeletion=true|false (ALPHA - default=false)
                                                             AtomicFIFO=true|false (BETA - default=true)
                                                             AuthorizePodWebsocketUpgradeCreatePermission=true|false (BETA - default=true)
                                                             CBORServingAndStorage=true|false (ALPHA - default=false)
                                                             CPUManagerPolicyAlphaOptions=true|false (ALPHA - default=false)
                                                             CPUManagerPolicyBetaOptions=true|false (BETA - default=true)
                                                             CRDObservedGenerationTracking=true|false (BETA - default=true)
                                                             CRIListStreaming=true|false (ALPHA - default=false)
                                                             CSIStorage=true|false (ALPHA - default=false)
                                                             CSIVolumeHealth=true|false (ALPHA - default=false)
                                                             ClearingNominatedNodeNameAfterBinding=true|false (BETA - default=true)
                                                             ClientsAllowCARotation=true|false (BETA - default=true)
                                                             ClientsAllowCBOR=true|false (ALPHA - default=false)
                                                             ClientsAllowTLSCacheGC=true|false (BETA - default=true)
                                                             ClientsPreferCBOR=true|false (ALPHA - default=false)
                                                             CloudControllerManagerWatchBasedRoutesReconciliation=true|false (ALPHA - default=false)
                                                             CloudControllerManagerWebhook=true|false (ALPHA - default=false)
                                                             ClusterTrustBundle=true|false (BETA - default=false)
                                                             ClusterTrustBundleProjection=true|false (BETA - default=false)
                                                             ComponentFlagz=true|false (BETA - default=true)
                                                             ComponentStatusz=true|false (BETA - default=true)
                                                             ConcurrentWatchObjectDecode=true|false (BETA - default=false)
                                                             ConstrainedImpersonation=true|false (BETA - default=true)
                                                             ContainerCheckpoint=true|false (BETA - default=true)
                                                             ContainerRestartRules=true|false (BETA - default=true)
                                                             ContainerStopSignals=true|false (ALPHA - default=false)
                                                             CoordinatedLeaderElection=true|false (BETA - default=false)
                                                             CronVolcanoJobSupport=true|false (ALPHA - default=true)
                                                             CrossNamespaceVolumeDataSource=true|false (ALPHA - default=false)
                                                             DRAConsumableCapacity=true|false (BETA - default=true)
                                                             DRADeviceBindingConditions=true|false (BETA - default=true)
                                                             DRADeviceTaintRules=true|false (BETA - default=false)
                                                             DRADeviceTaints=true|false (BETA - default=true)
                                                             DRAExtendedResource=true|false (BETA - default=true)
                                                             DRAListTypeAttributes=true|false (ALPHA - default=false)
                                                             DRANodeAllocatableResources=true|false (ALPHA - default=false)
                                                             DRAPartitionableDevices=true|false (BETA - default=true)
                                                             DRAResourceClaimDeviceStatus=true|false (BETA - default=true)
                                                             DRAResourceClaimGranularStatusAuthorization=true|false (BETA - default=true)
                                                             DRAResourcePoolStatus=true|false (ALPHA - default=false)
                                                             DRASchedulerFilterTimeout=true|false (BETA - default=true)
                                                             DRAWorkloadResourceClaims=true|false (ALPHA - default=false)
                                                             DeclarativeValidationBeta=true|false (BETA - default=true)
                                                             DeploymentReplicaSetTerminatingReplicas=true|false (BETA - default=true)
                                                             DetectCacheInconsistency=true|false (BETA - default=true)
                                                             EnvFiles=true|false (BETA - default=true)
                                                             EventedPLEG=true|false (ALPHA - default=false)
                                                             ExtendWebSocketsToKubelet=true|false (BETA - default=true)
                                                             GangScheduling=true|false (ALPHA - default=false)
                                                             GenericWorkload=true|false (ALPHA - default=false)
                                                             GracefulNodeShutdown=true|false (BETA - default=true)
                                                             GracefulNodeShutdownBasedOnPodPriority=true|false (BETA - default=true)
                                                             HPAConfigurableTolerance=true|false (BETA - default=true)
                                                             HPAScaleToZero=true|false (ALPHA - default=false)
                                                             HostnameOverride=true|false (BETA - default=true)
                                                             ImageVolumeWithDigest=true|false (ALPHA - default=false)
                                                             InOrderInformersBatchProcess=true|false (BETA - default=true)
                                                             InPlacePodLevelResourcesVerticalScaling=true|false (BETA - default=true)
                                                             InPlacePodVerticalScalingExclusiveCPUs=true|false (ALPHA - default=false)
                                                             InPlacePodVerticalScalingExclusiveMemory=true|false (ALPHA - default=false)
                                                             InPlacePodVerticalScalingInitContainers=true|false (BETA - default=true)
                                                             KubeletCrashLoopBackOffMax=true|false (BETA - default=true)
                                                             KubeletEnsureSecretPulledImages=true|false (BETA - default=true)
                                                             KubeletInUserNamespace=true|false (ALPHA - default=false)
                                                             KubeletSeparateDiskGC=true|false (BETA - default=true)
                                                             KubeletServiceAccountTokenForCredentialProviders=true|false (BETA - default=true)
                                                             ListFromCacheSnapshot=true|false (BETA - default=true)
                                                             LocalStorageCapacityIsolationFSQuotaMonitoring=true|false (BETA - default=false)
                                                             ManifestBasedAdmissionControlConfig=true|false (ALPHA - default=false)
                                                             MatchLabelKeysInPodTopologySpread=true|false (BETA - default=true)
                                                             MatchLabelKeysInPodTopologySpreadSelectorMerge=true|false (BETA - default=true)
                                                             MaxUnavailableStatefulSet=true|false (BETA - default=false)
                                                             MemoryQoS=true|false (ALPHA - default=false)
                                                             MutablePVNodeAffinity=true|false (ALPHA - default=false)
                                                             MutablePodResourcesForSuspendedJobs=true|false (BETA - default=true)
                                                             MutableSchedulingDirectivesForSuspendedJobs=true|false (BETA - default=true)
                                                             NamespaceQueue=true|false (ALPHA - default=false)
                                                             NodeDeclaredFeatures=true|false (BETA - default=true)
                                                             NominatedNodeNameForExpectation=true|false (BETA - default=true)
                                                             OpenAPIEnums=true|false (BETA - default=true)
                                                             OpportunisticBatching=true|false (BETA - default=true)
                                                             PLEGOnDemandRelist=true|false (BETA - default=true)
                                                             PersistentVolumeClaimUnusedSinceTime=true|false (ALPHA - default=false)
                                                             PodAndContainerStatsFromCRI=true|false (ALPHA - default=false)
                                                             PodCertificateRequest=true|false (BETA - default=false)
                                                             PodDeletionCost=true|false (BETA - default=true)
                                                             PodDisruptionBudgetsSupport=true|false (ALPHA - default=true)
                                                             PodLevelResourceManagers=true|false (ALPHA - default=false)
                                                             PodLevelResources=true|false (BETA - default=true)
                                                             PodLogsQuerySplitStreams=true|false (ALPHA - default=false)
                                                             PodReadyToStartContainersCondition=true|false (BETA - default=true)
                                                             PodTopologyLabelsAdmission=true|false (BETA - default=true)
                                                             PodsAPI=true|false (ALPHA - default=false)
                                                             PortForwardWebsockets=true|false (BETA - default=true)
                                                             PreventStaticPodAPIReferences=true|false (BETA - default=true)
                                                             PriorityClass=true|false (ALPHA - default=true)
                                                             QOSReserved=true|false (ALPHA - default=false)
                                                             QueueCommandSync=true|false (ALPHA - default=true)
                                                             ReduceDefaultCrashLoopBackOffDecay=true|false (ALPHA - default=false)
                                                             RelaxedServiceNameValidation=true|false (BETA - default=true)
                                                             ReloadKubeletClientCAFile=true|false (BETA - default=true)
                                                             ReloadKubeletServerCertificateFile=true|false (BETA - default=true)
                                                             RemoteRequestHeaderUID=true|false (BETA - default=true)
                                                             ResourceHealthStatus=true|false (BETA - default=true)
                                                             ResourceHealthStatusMessage=true|false (BETA - default=true)
                                                             ResourceTopology=true|false (ALPHA - default=true)
                                                             RestartAllContainersOnContainerExits=true|false (BETA - default=true)
                                                             RotateKubeletServerCertificate=true|false (BETA - default=true)
                                                             RuntimeClassInImageCriApi=true|false (ALPHA - default=false)
                                                             SELinuxMount=true|false (BETA - default=false)
                                                             SchedulerAsyncAPICalls=true|false (BETA - default=false)
                                                             SchedulerAsyncPreemption=true|false (BETA - default=true)
                                                             SchedulerPopFromBackoffQ=true|false (BETA - default=true)
                                                             SchedulingGatesQueueAdmission=true|false (ALPHA - default=false)
                                                             ServiceAccountNodeAudienceRestriction=true|false (BETA - default=true)
                                                             ShardedListAndWatch=true|false (ALPHA - default=false)
                                                             SizeBasedListCostEstimate=true|false (BETA - default=true)
                                                             StaleControllerConsistencyDaemonSet=true|false (BETA - default=true)
                                                             StaleControllerConsistencyJob=true|false (BETA - default=true)
                                                             StaleControllerConsistencyReplicaSet=true|false (BETA - default=true)
                                                             StaleControllerConsistencyStatefulSet=true|false (BETA - default=true)
                                                             StatefulSetSemanticRevisionComparison=true|false (BETA - default=true)
                                                             StorageCapacityScoring=true|false (ALPHA - default=false)
                                                             StorageVersionAPI=true|false (ALPHA - default=false)
                                                             StorageVersionHash=true|false (BETA - default=true)
                                                             StorageVersionMigrator=true|false (BETA - default=false)
                                                             StrictIPCIDRValidation=true|false (BETA - default=true)
                                                             StructuredAuthenticationConfigurationEgressSelector=true|false (BETA - default=true)
                                                             StructuredAuthenticationConfigurationJWKSMetrics=true|false (BETA - default=true)
                                                             TaintTolerationComparisonOperators=true|false (ALPHA - default=false)
                                                             TokenRequestServiceAccountUIDValidation=true|false (BETA - default=true)
                                                             TopologyAwareWorkloadScheduling=true|false (ALPHA - default=false)
                                                             TopologyManagerPolicyAlphaOptions=true|false (ALPHA - default=false)
                                                             TopologyManagerPolicyBetaOptions=true|false (BETA - default=true)
                                                             TranslateStreamCloseWebsocketRequests=true|false (BETA - default=true)
                                                             UnauthenticatedHTTP2DOSMitigation=true|false (BETA - default=true)
                                                             UnknownVersionInteroperabilityProxy=true|false (BETA - default=true)
                                                             UnlockWhileProcessingFIFO=true|false (BETA - default=true)
                                                             UnschedulableJobCache=true|false (ALPHA - default=false)
                                                             UserNamespacesHostNetworkSupport=true|false (ALPHA - default=false)
                                                             VolcanoJobSupport=true|false (ALPHA - default=true)
                                                             VolumeLimitScaling=true|false (ALPHA - default=false)
                                                             WatchCacheInitializationPostStartHook=true|false (BETA - default=true)
                                                             WatchList=true|false (BETA - default=true)
                                                             WatchListClient=true|false (BETA - default=true)
                                                             WindowsCPUAndMemoryAffinity=true|false (ALPHA - default=false)
                                                             WindowsGracefulNodeShutdown=true|false (BETA - default=true)
                                                             WorkLoadSupport=true|false (ALPHA - default=true)
                                                             WorkloadAwarePreemption=true|false (ALPHA - default=false)
                                                             WorkloadWithJob=true|false (ALPHA - default=false)
      --gate-removal-worker-num int                          The number of async workers for scheduling gate removal (used when SchedulingGatesQueueAdmission is enabled). (default 5)
      --healthz-address string                               The address to listen on for the health check server. (default ":11251")
      --ignored-provisioners strings                         The provisioners that will be ignored during pod pvc request computation and preemption.
      --job-updater-worker-num int                           The number of workers updating jobs concurrently. (default 16)
      --kube-api-burst int                                   Burst to use while talking with kubernetes apiserver (default 2000)
      --kube-api-qps float32                                 QPS to use while talking with kubernetes apiserver (default 2000)
      --kubeconfig string                                    Path to kubeconfig file with authorization and master location information
      --leader-elect                                         Start a leader election client and gain leadership before executing the main loop. Enable this when running replicated components for high availability. (default true)
      --leader-elect-lease-duration duration                 The duration that non-leader candidates will wait after observing a leadership renewal until attempting to acquire leadership of a led but unrenewed leader slot. This is effectively the maximum duration that a leader can be stopped before it is replaced by another candidate. This is only applicable if leader election is enabled. (default 15s)
      --leader-elect-renew-deadline duration                 The interval between attempts by the acting master to renew a leadership slot before it stops leading. This must be less than the lease duration. This is only applicable if leader election is enabled. (default 10s)
      --leader-elect-resource-lock string                    The type of resource object that is used for locking during leader election. Supported options are 'leases'. (default "leases")
      --leader-elect-resource-name string                    The name of resource object that is used for locking during leader election. (default "volcano")
      --leader-elect-resource-namespace string               The namespace of resource object that is used for locking during leader election. (default "volcano-system")
      --leader-elect-retry-period duration                   The duration the clients should wait between attempting acquisition and renewal of a leadership. This is only applicable if leader election is enabled. (default 2s)
      --legacy-stderr-threshold-behavior                     If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). If false, stderrthreshold is honored even when logtostderr=true
      --listen-address string                                The address to listen on for HTTP requests. (default ":8080")
      --log-backtrace-at traceLocation                       when logging hits line file:N, emit a stack trace (default :0)
      --log-dir string                                       If non-empty, write log files in this directory (no effect when -logtostderr=true)
      --log-file string                                      If non-empty, use this log file (no effect when -logtostderr=true)
      --log-file-max-size uint                               Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
      --log-flush-frequency duration                         Maximum number of seconds between log flushes (default 5s)
      --logtostderr                                          log to standard error instead of files (default true)
      --master string                                        The address of the Kubernetes API server (overrides any value in kubeconfig)
      --minimum-feasible-nodes int32                         The minimum number of feasible nodes to find and score (default 100)
      --minimum-percentage-nodes-to-find int32               The minimum percentage of nodes to find and score (default 5)
      --node-selector strings                                volcano only work with the labeled node, like: --node-selector=volcano.sh/role:train --node-selector=volcano.sh/role:serving
      --node-worker-threads uint32                           The number of threads syncing node operations. (default 20)
      --one-output                                           If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
      --percentage-nodes-to-find int32                       The percentage of nodes to find and score, if <=0 will be calculated based on the cluster size
      --plugins-dir string                                   vc-scheduler will load custom plugins which are in this directory
      --priority-class                                       Enable PriorityClass to provide the capacity of preemption at pod group level; to disable it, set it false (default true)
      --resource-sync-timeout duration                       timeout on waiting for handler handling initial resources synchronization before starting scheduler, default is 60s, 0 skip waiting (default 1m0s)
      --resync-period duration                               The default resync period for k8s native informer factory
      --schedule-period duration                             The period between each scheduling cycle (default 1s)
      --scheduler-conf string                                The absolute path of scheduler configuration file
      --scheduler-name stringArray                           vc-scheduler will handle pods whose .spec.SchedulerName is same as scheduler-name (default [volcano])
      --scheduler-sharding-mode string                       The node sharding mode for scheduling, none(default)|hard|soft mode is supported (default "none")
      --scheduler-sharding-name string                       The name of shard used for this scheduler (default "volcano")
      --skip-headers                                         If true, avoid header prefixes in the log messages
      --skip-log-headers                                     If true, avoid headers when opening log files (no effect when -logtostderr=true)
      --stderrthreshold severity                             logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true unless -legacy_stderr_threshold_behavior=false)
      --task-updater-worker-num int                          The number of workers updating tasks concurrently for each job. (default 16)
      --tls-cert-file string                                 File containing the default x509 Certificate for HTTPS. (CA cert, if any, concatenated after server cert).
      --tls-private-key-file string                          File containing the default x509 private key matching --tls-cert-file.
      --unschedulable-job-cache-debug-metrics                Enable per-Job unschedulable-job cache metrics for debugging
      --unschedulable-job-cache-max-skip-duration duration   Maximum duration a Job may remain in the unschedulable-job cache without a matching event (default 5m0s)
  -v, --v Level                                              number for the log level verbosity
      --version                                              Show version and quit
      --vmodule moduleSpec                                   comma-separated list of pattern=N settings for file-filtered logging
Options (62)
OptionDescriptionSource
--add-dir-headerIf true, adds the file directory to the header of the log messageshelp
--alsologtostderrlog to standard error as well as files (no effect when -logtostderr=true)help
--alsologtostderrthreshold severitylogs at or above this threshold go to stderr when -alsologtostderr=true (no effect when -logtostderr=true)help
--ca-cert-file stringFile containing the x509 Certificate for HTTPS.help
--cache-dump-dir stringThe target dir where the json file put at when dump cache info to json file (default "/tmp")help
--cache-dumperEnable the cache dumper, it's true by default (default true)help
--csi-storageWhen true (default), register CSIDriver and CSIStorageCapacity informers on the scheduler cache;help
--default-queue stringThe default queue name of the job (default "default")help
--disable-default-scheduler-configThe flag indicates whether the scheduler should avoid using the default configuration if the provided scheduler configuration is invalid.help
--enable-healthzEnable the health check;help
--enable-metricsEnable the metrics function;help
--enable-pprofEnable the pprof endpoint;help
--feature-gates mapStringBoolA set of key=value pairs that describe feature gates for alpha/experimental features.help
--gate-removal-worker-num intThe number of async workers for scheduling gate removal (used when SchedulingGatesQueueAdmission is enabled).help
--healthz-address stringThe address to listen on for the health check server.help
--ignored-provisioners stringsThe provisioners that will be ignored during pod pvc request computation and preemption.help
--job-updater-worker-num intThe number of workers updating jobs concurrently.help
--kube-api-burst intBurst to use while talking with kubernetes apiserver (default 2000)help
--kube-api-qps float32QPS to use while talking with kubernetes apiserver (default 2000)help
--kubeconfig stringPath to kubeconfig file with authorization and master location informationhelp
--leader-electStart a leader election client and gain leadership before executing the main loop.help
--leader-elect-lease-duration durationThe duration that non-leader candidates will wait after observing a leadership renewal until attempting to acquire leadership of a led but unrenewed leader slot.help
--leader-elect-renew-deadline durationThe interval between attempts by the acting master to renew a leadership slot before it stops leading.help
--leader-elect-resource-lock stringThe type of resource object that is used for locking during leader election.help
--leader-elect-resource-name stringThe name of resource object that is used for locking during leader election.help
--leader-elect-resource-namespace stringThe namespace of resource object that is used for locking during leader election.help
--leader-elect-retry-period durationThe duration the clients should wait between attempting acquisition and renewal of a leadership.help
--legacy-stderr-threshold-behaviorIf true, stderrthreshold is ignored when logtostderr=true (legacy behavior).help
--listen-address stringThe address to listen on for HTTP requests.help
--log-backtrace-at traceLocationwhen logging hits line file:N, emit a stack trace (default :0)help
--log-dir stringIf non-empty, write log files in this directory (no effect when -logtostderr=true)help
--log-file stringIf non-empty, use this log file (no effect when -logtostderr=true)help
--log-file-max-size uintDefines the maximum size a log file can grow to (no effect when -logtostderr=true).help
--log-flush-frequency durationMaximum number of seconds between log flushes (default 5s)help
--logtostderrlog to standard error instead of files (default true)help
--master stringThe address of the Kubernetes API server (overrides any value in kubeconfig)help
--minimum-feasible-nodes int32The minimum number of feasible nodes to find and score (default 100)help
--minimum-percentage-nodes-to-find int32The minimum percentage of nodes to find and score (default 5)help
--node-selector stringsvolcano only work with the labeled node, like: --node-selector=volcano.sh/role:train --node-selector=volcano.sh/role:servinghelp
--node-worker-threads uint32The number of threads syncing node operations.help
--one-outputIf true, only write logs to their native severity level (vs also writing to each lower severity level;help
--percentage-nodes-to-find int32The percentage of nodes to find and score, if <=0 will be calculated based on the cluster sizehelp
--plugins-dir stringvc-scheduler will load custom plugins which are in this directoryhelp
--priority-classEnable PriorityClass to provide the capacity of preemption at pod group level;help
--resource-sync-timeout durationtimeout on waiting for handler handling initial resources synchronization before starting scheduler, default is 60s, 0 skip waiting (default 1m0s)help
--resync-period durationThe default resync period for k8s native informer factoryhelp
--schedule-period durationThe period between each scheduling cycle (default 1s)help
--scheduler-conf stringThe absolute path of scheduler configuration filehelp
--scheduler-name stringArrayvc-scheduler will handle pods whose .spec.SchedulerName is same as scheduler-name (default [volcano])help
--scheduler-sharding-mode stringThe node sharding mode for scheduling, none(default)|hard|soft mode is supported (default "none")help
--scheduler-sharding-name stringThe name of shard used for this scheduler (default "volcano")help
--skip-headersIf true, avoid header prefixes in the log messageshelp
--skip-log-headersIf true, avoid headers when opening log files (no effect when -logtostderr=true)help
--stderrthreshold severitylogs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true unless -legacy_stderr_threshold_behavior=false)help
--task-updater-worker-num intThe number of workers updating tasks concurrently for each job.help
--tls-cert-file stringFile containing the default x509 Certificate for HTTPS.help
--tls-private-key-file stringFile containing the default x509 private key matching --tls-cert-file.help
--unschedulable-job-cache-debug-metricsEnable per-Job unschedulable-job cache metrics for debugginghelp
--unschedulable-job-cache-max-skip-duration durationMaximum duration a Job may remain in the unschedulable-job cache without a matching event (default 5m0s)help
-v, --v Levelnumber for the log level verbosityhelp
--versionShow version and quithelp
--vmodule moduleSpeccomma-separated list of pattern=N settings for file-filtered logginghelp

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