All Products
Search

This Product

    Container Compute Service:kube-scheduler

    Document Center

    Container Compute Service:kube-scheduler

    Last Updated:Dec 01, 2025

    The kube-scheduler is a control plane component. It schedules pods to suitable nodes in a cluster based on resource requirements.

    Introduction to kube-scheduler

    The kube-scheduler schedules each pod to a suitable virtual node in an ACS cluster based on pod requirements, node resources, and other properties. For more information, see the official Kubernetes documentation about kube-scheduler.

    Note

    Starting from Kubernetes 1.32, the versioning rules for the scheduler in ACS are consistent with those for ACK. For more information, see kube-scheduler.

    Usage notes

    The kube-scheduler component is installed by default when a cluster is created. For more information about its features, see Scheduling overview.

    Component configuration

    Configure custom parameters for the kube-scheduler component as follows.

    1. Log on to the ACS console. In the left-side navigation pane, click Clusters.

    2. On the Clusters page, find the target cluster and click its ID. In the left navigation pane, choose Operations > Add-ons.

    3. On the Core Components tab, find the Kube Scheduler component. Click Configuration in the lower-right corner of the card. In the dialog box that appears, configure the parameters.

      Different scheduler versions support different features and custom parameters. For more information about the features of each version, see kube-scheduler. The following table describes the custom parameters.

      Parameter

      Description

      Type

      Value (range)

      Default value

      Enable Zone Recommendation

      ACS automatically filters out zones with high resource usage during scheduling. For more information, see Resource recommendation feature.

      Boolean

      • false

      • true

      true

      Enable custom labels and schedulers for GPU-HPN nodes

      For more information, see Use a custom scheduler and Manage node labels and taints.

      Boolean

      • false

      • true

      false

      scorePluginWeights

      The weight parameters for scheduler scoring plugins. This includes native community plugins and Alibaba Cloud proprietary plugins:

      • Community plugins include NodeAffinity, PodTopologySpread, InnerPodAffinity, and TaintToleration. For more information, see the documentation for affinity and toleration policies.

      • Alibaba Cloud proprietary plugins include the following:

        • ServerlessScheduling: For general-purpose, performance, and GPU compute classes, this plugin prioritizes zones with more available platform resources based on resource recommendations.

      The weight parameters of scoring plugins affect which nodes the scheduler prioritizes. For a detailed description of scoring weights, see the community documentation.

      Important

      ACS automatically filters out zones with high resource usage during scheduling. The filtering phase is not affected by scoring policies. When you use affinity-related scoring policies, make sure to select multiple recommended zones for the pod. This ensures that the scoring policies work effectively. For more information, see Resource recommendation feature.

      • plugin: string

      • weight: int

      • The plugin parameter supports only plugins from the list of available plugins.

      • The weight parameter is an integer. The value ranges from 1 to 10,000.

      The default weight configurations for each scoring plugin are as follows:

      • NodeAffinity: 1

      • PodTopologySpread: 1

      • InnerPodAffinity: 1

      • TaintToleration: 1

      • ServerlessScheduling: 2

    Change history

    Version 1.32

    Version

    Change time

    Description

    v1.32.0-aliyun.6.9.7.eb18a8a9

    September 22, 2025

    • Bug fixes:

      • Fixed an issue where pod scheduling was stuck in the Pending state when strong pod anti-affinity and topology spread constraints were used. This issue was introduced in version v1.32.0-aliyun.6.9.6.4e1407c2.

    v1.32.0-aliyun.6.9.6.4e1407c2

    September 17, 2025

    • New features:

      • Added a switch to enable or disable the zone resource recommendation feature.

    • Optimizations:

      • Optimized the scheduling retry efficiency for pods that use PersistentVolumeClaims (PVCs).

      • Optimized the PodTopologySpread policy. When `whenUnsatisfiable` is set to `ScheduleAnyway`, pods that are being created are now included in the topology distribution calculation.

    v1.32.0-aliyun.6.9.5.ccfc0094

    July 09, 2025

    Initial release of the component. Compatible with ACS cluster version 1.32. Includes all features from version v1.31.0-aliyun-1.4.2.

    Version 1.31

    Version

    Change time

    Description

    v1.31.0-aliyun-1.4.4

    September 22, 2025

    • Bug fixes:

      • Fixed an issue where pod scheduling was stuck in the Pending state when strong pod anti-affinity and topology spread constraints were used. This issue was introduced in version v1.31.0-aliyun-1.4.3.

    v1.31.0-aliyun-1.4.3

    September 17, 2025

    • New features:

      • Added a switch to enable or disable the zone resource recommendation feature.

    • Optimizations:

      • Optimized the scheduling retry efficiency for pods that use PVCs.

      • Optimized the PodTopologySpread policy. When `whenUnsatisfiable` is set to `ScheduleAnyway`, pods that are being created are now included in the topology distribution calculation.

    v1.31.0-aliyun-1.4.2

    July 09, 2025

    Optimized internal log printing and base image modifications.

    v1.31.0-aliyun-1.4.1

    May 19, 2025

    Added support for configuring custom weight parameters for scoring plugins. For more information, see scorePluginWeights.

    v1.31.0-aliyun-1.4.0

    April 09, 2025

    Optimized the scheduling flow for pods that use `WaitForFirstConsumer` (WFFC) PVCs.

    When a pod uses a WFFC PVC and specifies a vSwitch, also specify the corresponding zone in the pod's affinity settings. The scheduler ensures that the zone assigned to the PVC matches the vSwitch to prevent the pod from being stuck in the Pending state. For more information, see Pod Annotation features.

    v1.31.0-aliyun-1.3.1

    March 20, 2025

    GPU sharing and scheduling now supports the static policy and QoS configuration.

    Improved fault tolerance for invalid configurations in custom priority scheduling.

    v1.31.0-aliyun-1.3.0

    February 08, 2025

    Fixed a disk scheduling issue for pods that use `WaitForFirstConsumer` PVCs.

    Added support for configuring custom schedulers for GPU-HPN pods.

    v1.31.0-aliyun-1.2.0

    November 29, 2024

    Initial release of the component. Compatible with ACS cluster version 1.31.

    Version 1.30

    Version

    Change time

    Description

    v1.30.3-aliyun-1.4.4

    September 22, 2025

    • Bug fixes:

      • Fixed an issue where pod scheduling was stuck in the Pending state when strong pod anti-affinity and topology spread constraints were used. This issue was introduced in version v1.30.3-aliyun-1.4.3.

    v1.30.3-aliyun-1.4.3

    September 17, 2025

    • New features:

      • Added a switch to enable or disable the zone resource recommendation feature.

    • Optimizations:

      • Optimized the scheduling retry efficiency for pods that use PVCs.

      • Optimized the PodTopologySpread policy. When `whenUnsatisfiable` is set to `ScheduleAnyway`, pods that are being created are now included in the topology distribution calculation.

    v1.30.3-aliyun-1.4.2

    July 09, 2025

    Optimized internal log printing and base image modifications.

    v1.30.3-aliyun-1.4.1

    May 19, 2025

    Added support for configuring custom weight parameters for scoring plugins. For more information, see scorePluginWeights.

    v1.30.3-aliyun-1.4.0

    April 09, 2025

    Optimized the scheduling flow for pods that use WFFC PVCs.

    When a pod uses a WFFC PVC and specifies a vSwitch, also specify the corresponding zone in the pod's affinity settings. The scheduler ensures that the zone assigned to the PVC matches the vSwitch to prevent the pod from being stuck in the Pending state. For more information, see Pod Annotation features.

    v1.30.3-aliyun-1.3.1

    March 20, 2025

    GPU sharing and scheduling now supports the static policy and QoS configuration.

    Improved fault tolerance for invalid configurations in custom priority scheduling.

    v1.30.3-aliyun-1.3.0

    February 08, 2025

    Fixed a disk scheduling issue for pods that use `waitForFirstConsumer` PVCs.

    Added support for configuring custom schedulers for GPU-HPN pods.

    v1.30.3-aliyun-1.2.0

    November 29, 2024

    Optimized pod scheduling efficiency.

    Adapted to the new version of the acs-virtual-node component. The acs-virtual-node component must be version v2.12.0-acs.9 or later.

    v1.30.3-aliyun-1.1.1

    September 09, 2024

    Initial release of the component. Compatible with ACS cluster version 1.30.

    Version 1.28

    Version

    Change time

    Description

    v1.28.12-aliyun-1.4.4

    September 22, 2025

    • Bug fixes:

      • Fixed an issue where pod scheduling was stuck in the Pending state when strong pod anti-affinity and topology spread constraints were used. This issue was introduced in version v1.28.12-aliyun-1.4.3.

    v1.28.12-aliyun-1.4.3

    September 17, 2025

    • New features:

      • Added a switch to enable or disable the zone resource recommendation feature.

    • Optimizations:

      • Optimized the scheduling retry efficiency for pods that use PVCs.

      • Optimized the PodTopologySpread policy. When `whenUnsatisfiable` is set to `ScheduleAnyway`, pods that are being created are now included in the topology distribution calculation.

    v1.28.12-aliyun-1.4.2

    July 09, 2025

    Optimized internal log printing and base image modifications.

    v1.28.12-aliyun-1.4.1

    May 19, 2025

    Added support for configuring custom weight parameters for scoring plugins. For more information, see scorePluginWeights.

    v1.28.12-aliyun-1.4.0

    April 09, 2025

    Optimized the scheduling flow for pods that use WFFC PVCs.

    When a pod uses a WFFC PVC and specifies a vSwitch, also specify the corresponding zone in the pod's affinity settings. The scheduler ensures that the zone assigned to the PVC matches the vSwitch to prevent the pod from being stuck in the Pending state. For more information, see Pod Annotation features.

    v1.28.9-aliyun-1.3.1

    March 20, 2025

    GPU sharing and scheduling now supports the static policy and QoS configuration.

    Improved fault tolerance for invalid configurations in custom priority scheduling.

    v1.28.9-aliyun-1.3.0

    February 08, 2025

    Fixed a disk scheduling issue for pods that use `waitForFirstConsumer` PVCs.

    Added support for configuring custom schedulers for GPU-HPN pods.

    v1.28.9-aliyun-1.2.0

    November 29, 2024

    Optimized pod scheduling efficiency.

    Adapted to the new version of the acs-virtual-node component. The acs-virtual-node component must be version v2.12.0-acs.9 or later.

    v1.28.9-aliyun-1.1.1

    September 06, 2024

    Optimized event notification messages.

    v1.28.9-aliyun-1.1.0

    August 22, 2024

    Added support for custom resource priority scheduling.

    v1.28.9-aliyun-1.0.1.dfd9511f

    July 12, 2024

    Optimized internal interfaces.

    v1.28.9-aliyun-1.0.0b72f000

    June 15, 2024

    Initial release of the component. Compatible with ACS cluster version 1.28.

    Version 1.26

    Version

    Change time

    Description

    v1.26.3-aliyun-1.3.1

    March 20, 2025

    GPU sharing and scheduling now supports the static policy and QoS configuration.

    Improved fault tolerance for invalid configurations in custom priority scheduling.

    v1.26.3-aliyun-1.3.0

    February 08, 2025

    Fixed a disk scheduling issue for pods that use `waitForFirstConsumer` PVCs.

    Added support for configuring custom schedulers for GPU-HPN pods.

    v1.26.3-aliyun-1.2.0

    November 29, 2024

    Optimized pod scheduling efficiency.

    Adapted to the new version of the acs-virtual-node component. The acs-virtual-node component must be version v2.12.0-acs.9 or later.

    v1.26.3-aliyun-1.1.1

    September 06, 2024

    Optimized event notification messages.

    v1.26.3-aliyun-1.1.0

    August 22, 2024

    Added support for custom resource priority scheduling.

    v1.26.3-aliyun-1.0.1.4d326e78

    July 12, 2024

    Optimized internal interfaces.

    v1.26.3-aliyun-1.0.fa88f9ae

    June 25, 2024

    Initial release of the component. Compatible with ACS cluster version 1.26.