Updated on 2026-08-13 GMT+08:00

Resizing a Cluster

Scenario

A cluster size specifies the maximum number of nodes a cluster can manage. If the current cluster size cannot meet your requirements, you can resize it.

Method

Description

Use Case

Auto master node flavor upgrade

When enabled, CCE automatically upgrades the master node flavor if the cluster control plane is overloaded or the node count exceeds the current flavor's node limit.

Small and medium-sized clusters without burst high-concurrency services, where loads change dynamically and node counts keep increasing

Manual master node flavor upgrade

Manually upgrade the master node flavor.

Scenarios where service scale is predictable and must be planned in advance

Manual master node flavor downgrade

Manually downgrade the master node flavor.

Scenarios where service scale decreases and costs must be reduced

Constraints

  • The number of master nodes cannot be changed during cluster resizing.
  • A single-master cluster supports only manual flavor upgrades. An HA cluster supports manual upgrades and downgrades, as well as auto upgrades.
  • During cluster resizing, master nodes update in rolling fashion. Cluster management functions are temporarily restricted during this process. To minimize the impact on services, resize a cluster during off-peak hours. Do not perform other operations (such as creating workloads) during this period.
  • When the master node flavor of an HA cluster is changed, a rolling update is used. Master nodes are preferentially distributed in the original AZ. If resources in the original AZ are insufficient, the nodes are scheduled to other AZs while ensuring that the DR specifications of the AZs are not degraded. If neither condition can be met, the flavor change may fail.
  • If a cluster size is changed to 1,000 nodes or more, some parameters will be adjusted accordingly to ensure cluster performance. For details, see Modifying Cluster Configurations.
  • After a cluster is resized, verify that installed add-ons have adequate resource quotas to meet workload requirements. For details, see How Do I Configure Add-on Resource Quotas Based on Cluster Scale?

Billing

Cluster management fees are adjusted according to the new flavor. For details, see CCE Price Calculator.

Increasing a Cluster Size

To increase CCE cluster size, upgrade the master node flavor manually or automatically.

Manually Upgrading the Master Node Flavor

  1. Log in to the CCE console. In the navigation pane, choose Clusters.
  2. In the cluster list on the right, locate the target cluster. Click and choose Modify Specifications from the drop-down list.

    Figure 1 Modifying specifications

  3. On the displayed page, select a larger cluster size.

    For service availability, single-master clusters are limited to fewer than 1,000 worker nodes.

  4. Click Next to confirm the specifications and click OK. Resizing a cluster takes under 30 minutes, though the exact duration depends on cluster size.

    You can click Operation Records in the upper right corner to view the cluster change history. The status changes from Executing to Successful once the cluster size has been updated.

    Figure 2 Operation records

CCE cluster auto flavor upgrade is a control plane auto scaling capability. Once enabled, CCE automatically increases the cluster size when any of the following conditions is met:

  • Triggered by control plane metrics: when load metrics indicate that the cluster control plane is at risk of overloading, or the overload level is light or higher (The overload level is a key metric for determining control plane load pressure. For details, see Enabling Overload Control for a Cluster.)

    The cluster control plane metric policy defines the following rules. If any rule is triggered, the master node flavor is automatically upgraded to mitigate overload. Custom thresholds are not supported.

    • The average CPU usage of all master nodes exceeds 70% for 5 minutes.
    • The average memory usage of all master nodes exceeds 70% for 5 minutes.
    • The overload level of any master node reaches the minor level or higher.
  • Triggered by node count: The number of worker nodes exceeds the maximum supported by the current master node flavor.
Figure 3 Trigger process of auto master node flavor upgrades
  • Auto flavor upgrades are supported only for pay-per-use clusters v1.27 or later with three master nodes. Yearly/Monthly clusters are not supported. DeC clusters do not support auto master node flavor upgrades.
  • After a flavor upgrade, automatic downgrade is disabled. If necessary, you can downgrade the flavor manually.
  • Control plane metrics trigger gradual flavor upgrades, one level at a time, never skipping levels.

To enable or disable auto master node flavor upgrades, perform the following operations:

  1. Log in to the CCE console. In the navigation pane, choose Clusters.
  2. Click the cluster name. The Overview page is displayed.
  3. In the navigation pane, choose Settings. Then click the Dashboard tab. In Cluster Settings, enable or disable Auto Master Node Flavor Upgrade. In the displayed dialog box, confirm the operation.

    After this function is enabled or disabled, changes take effect in the next synchronization cycle.
    Figure 4 Enabling automatic master node flavor upgrade

Manually Downgrading the Master Node Flavor

  • Manual flavor downgrades are supported only for clusters v1.27 or later with three master nodes. DeC clusters do not support manual master node flavor downgrades.
  • After a flavor downgrade, the cluster's maximum worker node count and control plane capacity are reduced accordingly. Evaluate overload risks using master node monitoring data on the Overview page. For details, see Protecting a CCE Cluster Against Overload.
  1. Log in to the CCE console. In the navigation pane, choose Clusters.
  2. In the cluster list on the right, locate the target cluster. Click and choose Modify Specifications from the drop-down list.
  3. On the page displayed, select a smaller cluster scale.
  4. Click Next to confirm the specifications and click OK. Resizing a cluster takes under 30 minutes, though the exact duration depends on cluster size.

    You can click Operation Records in the upper right corner to view the cluster change history. The status changes from Executing to Successful once the cluster size has been updated.

    • If coupons were applied to the original purchase, that portion is non-refundable. Only cash payments are eligible for refund. For details, see Pricing of a Changed Specification.
    • When downgrading resources originally purchased with cash coupons, discount coupons, or promotional discounts, the remaining value may be insufficient, resulting in a zero refund.

FAQs

  • Will enabling auto flavor upgrade immediately increase cluster size?

    No. Enabling this function activates monitoring only. The master node flavor is upgraded automatically only when trigger conditions are met.

  • What is the service impact during a master node flavor upgrade?

    Master nodes are updated in rolling fashion. Cluster management operations, such as workload creation or updates, are temporarily restricted. Suspend these during the upgrade. Running workloads are not affected.

  • Why does a flavor upgrade fail? How do I resolve it?
    • The system validates ingress and ELB configuration consistency before upgrading to prevent service interruption. If this check fails, the upgrade is blocked. Refer to the cluster upgrade documentation to resolve configuration issues proactively. For details, see Ingress and ELB Configuration Consistency.
    • Upgrades may also fail due to insufficient underlying resources. The system automatically retries with backoff. If failure persists, contact technical support.
  • Can auto flavor upgrade be disabled?

    Yes. Disable it by updating the cluster. Once disabled, automatic upgrades stop, but the current flavor is not automatically downgraded.

  • Does auto flavor upgrade guarantee SLA in AI and large-scale high-concurrency scenarios?

    No. Auto upgrades incur response delays due to metric collection cycles and upgrade execution time. In AI, high-concurrency, short-duration, strong-state, and large-scale scenarios, auto upgrade alone may not meet strict SLA requirements. Manually upgrade to an appropriately higher flavor in advance, reserve capacity headroom, and use auto upgrade as a fallback rather than the sole method.

  • How do auto upgrades differ from manual upgrades and downgrades?

    Category

    Auto Upgrade

    Manual Upgrade/Downgrade

    Trigger

    Automatic detection

    User-initiated

    Downgrade

    Not supported

    Supported

    Metric-driven upgrade step

    One level at a time

    Cross-level supported

    Capacity-driven upgrade step

    Upgraded to the minimum flavor meeting node count requirements

    Cross-level adjustment supported

    Use case

    Dynamic load changes requiring automatic response

    Clear service planning requiring deterministic specifications

    Fee impact

    Unchanged

    Unchanged

  • Will the two auto-upgrade trigger mechanisms conflict?

    No. Both triggers are coordinated through a cluster-level lock, ensuring only one flavor upgrade operation runs at a time.

  • What capabilities do yearly/monthly clusters support?

    Yearly/monthly clusters support manual flavor upgrades and downgrades, but not auto upgrades. All flavor changes must comply with yearly/monthly resource modification rules. For details, see Pricing of Changed Specifications.

Helpful Links

When a cluster scales to 1,000 or more worker nodes, certain parameters are automatically tuned for optimal performance. For details, see Modifying Cluster Configurations.