This topic shows you how to create an ACK Edge cluster in the console, enabling unified management through cloud-edge integration.
Prerequisites
You have activated ACK.
You have enabled Auto Scaling.
Limits
|
Item |
Limit |
Links for increasing quota limits/references |
|
|
Costs |
Your account must have a balance of at least CNY 100 and have completed real-name verification. Otherwise, you cannot create pay-as-you-go ECS instances and SLB instances. |
||
|
Networks |
ACK clusters support only VPCs. |
||
|
Cloud resources |
ECS |
The pay-as-you-go and subscription billing methods are supported. After an ECS instance is created, you can change its billing method from pay-as-you-go to subscription in the ECS console. |
Change the billing method of an ECS instance from pay-as-you-go to subscription |
|
VPC route entries |
By default, you can add at most 200 route entries to the VPC of an ACK cluster that runs Flannel. VPCs of ACK clusters that run Terway do not have this limit. If you want to add more route entries to the VPC of your ACK cluster, request a quota increase for the VPC. |
||
|
Security groups |
By default, you can create at most 100 security groups with each account. |
||
|
SLB instances |
By default, you can create at most 60 pay-as-you-go SLB instances with each account. |
||
|
EIP |
By default, you can create at most 20 EIPs with each account. |
||
Step 1: Log on to the console
Log on to the ACK console. In the left navigation pane, click Clusters.
In the top-left corner of the page, select the resource group and region where your target resources reside.

On the Clusters page, click Create Kubernetes Cluster.
On the Create Kubernetes Cluster page, click the ACK Edge tab.
Step 2: Configure the cluster
On the ACK Edge Cluster page, configure the basic and advanced settings for the cluster.
Basic settings
Parameter | Description |
Cluster Name | Enter a custom cluster name. |
Cluster Specification |
For a comparison of the two editions, see Cluster management. |
Region | The region where cluster resources (such as ECS instances and cloud disks) are located. The closer the region is to your location and where your resources are deployed, the lower the network latency. |
Kubernetes Version | Only the latest three minor versions are supported. We recommend using the latest available version. For details about ACK version support, see ACK version support overview. |
Maintenance Window | ACK performs automated O&M operations on managed node pools—such as automatic OS CVE vulnerability fixes—during the maintenance window. Click Set to configure specific maintenance policies. |
Network settings
VPC | The VPC for the cluster. To ensure high availability, we recommend selecting two or more zones.
We recommend using standard private CIDR blocks for the cluster VPC (for example, 10.0.0.0/8, 172.16.0.0/12, or 192.168.0.0/16). If you have special requirements, apply at the Quota Center (Create a cluster using a public CIDR block VPC). Cloud resource and billing information: |
Configure SNAT for VPC | Do not select this option when using a shared VPC. Select this option if nodes need public network access (to pull public images or access external services). ACK automatically configures a NAT Gateway and SNAT rules to enable public network access for cluster resources.
If you do not select this option, you can manually configure a NAT Gateway and SNAT rules after cluster creation. For details, see Public NAT Gateway. Cloud resource and billing information: |
vSwitch | Select an existing vSwitch by zone from the list, or click Create vSwitch to create a new one. The control plane and default node pool use the specified vSwitch. For better high availability, we recommend selecting vSwitches in multiple zones. |
Security Group | When using an existing VPC, you can select Select Existing Security Group This security group applies to the cluster control plane, default node pool, and any node pool without a custom security group. Compared with basic security groups, enterprise security groups can accommodate a larger number of private IP addresses but do not support intra-group connectivity. For more information, see Security Group Classification.
|
Access to API Server | ACK automatically creates a pay-as-you-go private CLB instance as the internal endpoint for the API Server. This CLB instance cannot be reused or deleted. If deleted, the API Server becomes inaccessible and cannot be restored. To use an existing CLB instance, submit a ticket. After selecting Use Existing Gateway for the VPC, you can set the SLB Source to Use Existing Gateway. You can optionally enable Expose API server with EIP.
To enable this later, see Enable public network access to API Server. Starting December 1, 2024, newly created CLB instances will no longer support Subscription billing, and will incur instance fees. For details, see [Product Announcement] Discontinuation of subscription billing for new cluster API Server CLB instances, Adjustment announcement for Classic Load Balancer CLB billing items. Warning
|
Network Plug-in | Select a network plug-in and configure its settings. The Flannel and Terway-edge network plug-ins are supported. For more information, see Network management and How to choose a network plug-in.
|
Pod vSwitch | This parameter is required only if you select Terway-edge as the network plug-in. You must specify the vSwitches from which to assign IP addresses to pods in the cloud node pool. Each Pod vSwitch must be in the same availability zone as the vSwitch of the corresponding worker node. |
Edge Container CIDR Block | This CIDR block provides the IP addresses for containers.
|
Number of Pods per Node | Defines the maximum number of pods allowed on a single node. |
Service CIDR | Also known as Service CIDR, this is the IP address pool for assigning IPs to internal cluster services. This CIDR block must not overlap with the VPC or any existing cluster CIDR blocks in the VPC, and must not overlap with the Container CIDR Block. |
Advanced settings
Click Advanced Options (Optional) to configure the service forwarding mode.
Parameter | Description |
Forwarding Mode | Select the kube-proxy proxy mode, which determines how cluster Services distribute requests to backend pods.
|
Click Advanced Options (Optional) to configure other advanced settings.
Step 3: Configure cloud node pool
You must configure at least two worker nodes in the cloud node pool to deploy the control plane components.
Basic node pool settings
Parameter | Description | |
Node Pool Name | Enter a custom node pool name. | |
Container Runtime | Select a Container Runtime based on the Kubernetes Version.
| |
Managed node pool settings | Managed Node Pool | Enable managed node pool to use ACK's automated O&M capabilities. If your business is sensitive to underlying node changes and cannot tolerate node restarts or application pod migrations, we do not recommend enabling this. To enable this later, you can edit the node pool. |
Auto Repair | ACK automatically monitors node status and performs self-healing tasks when nodes become abnormal. If you select Restart Faulty Node, node self-healing may involve draining nodes and replacing disks. For trigger conditions and related events, see Enable node self-healing. | |
Auto Update Rule | When a new kubelet version is available, ACK automatically upgrades. For details, see Upgrade node pools. | |
Auto CVE Patching | Fix CVE vulnerabilities in node pool OS, supporting configurable vulnerability fix levels. Cloud resource and billing information: | |
Maintenance Window | ACK performs automated O&M operations on managed node pools only during the defined maintenance window. | |
Instance and image settings
Parameter | Description | |
Billing Method | The default billing method used when scaling out nodes in the node pool.
To maintain node pool consistency, you cannot change a Pay-As-You-Go or Subscription node pool to a Preemptible Instance node pool, or vice versa. | |
Instance settings | When scaling out, nodes are allocated from the configured ECS instance families. To improve scale-out success rates, select multiple instance types across multiple zones to avoid unavailability or insufficient inventory. The specific instance type used for scaling is determined by the configured Scaling Policy. To ensure business stability and accurate resource scheduling, do not mix GPU and non-GPU instance types in the same node pool. Configure instance types for scaling in one of two ways:
Refer to the console's elasticity strength recommendations for configuration, or view node pool elasticity strength after creation. For ACK-unsupported instance types and node configuration recommendations, see ECS instance type configuration recommendations. Cloud resource and billing information: Note Enhanced features of ACK Edge clusters, such as logging, monitoring, and reverse tunneling, require components to be deployed in the cloud. Therefore, you must create at least one ECS instance as a worker node by default. | |
Operating System | Marketplace Image is in phased release.
To upgrade or change the operating system later, see Change operating system. | |
Security Hardening | When creating nodes, ACK applies the selected security baseline policy.
| |
Logon Type |
| |
Storage settings
Parameter | Description | |
System Disk | Select a cloud disk type based on your business needs, including ESSD AutoPL, ESSD, ESSD Entry, and previous-generation disks (SSD and ultra disk). Configure capacity, IOPS, and other parameters. Available system disk types depend on the selected instance family. Disk types not displayed are unsupported. Supports selecting More Disk Categories to configure disk types different from the primary System Disk, improving scale-out success rates. When creating nodes, ACK selects the first matching disk type from the specified order. Cloud resource and billing information: | |
Data Disk | Select a cloud disk type based on your business needs, including ESSD AutoPL, ESSD, ESSD Entry, and previous-generation disks (SSD and ultra disk). Configure capacity, IOPS, and other parameters. Available data disk types depend on the selected instance family. Disk types not displayed are unsupported.
Select Add Data Disk Type to configure disk types different from the primary Data Disk, improving scale-out success rates. When creating nodes, ACK selects the first matching disk type from the specified order. An ECS instance can mount up to 64 data disks. The maximum number of disks supported varies by instance type. Query the disk quantity limit for an instance type using the DescribeInstanceTypes API (DiskQuantity). Cloud resource and billing information: | |
Elastic Ephemeral Disk | Whitelist feature. Submit a ticket to apply. Elastic ephemeral disk provides high-performance, cost-effective temporary storage for ECS instances, suitable for temporary data (such as intermediate computation results, cached data, temporary files) and high-performance computing scenarios requiring high IOPS and throughput. Supported only in specific regions and ECS instance types. For details, see Region limits, Instance type limits. You can choose whether to configure initialization for the elastic ephemeral disk and customize its mount directory. Cloud resource and billing information: | |
Instance quantity
Parameter | Description | |
Expected Number of Nodes | The total number of nodes that the node pool maintains. You can scale the node pool in or out by adjusting this value. We recommend that you maintain at least two nodes in the cloud node pool. | |
Advanced node pool settings
Expand Advanced Options (Optional) to configure the node scaling policy.
Parameter | Description |
Scaling Policy | Configure how the node pool selects instances during scaling.
|
Use Pay-as-you-go Instances When Spot Instances Are Insufficient | Requires selecting spot instances as the billing method. When enabled, if sufficient spot instances cannot be created due to price or inventory reasons, ACK automatically attempts to create pay-as-you-go instances as a supplement. Cloud resource and billing information: |
Enable Supplemental Spot Instance | Requires selecting spot instances as the billing method. When enabled, upon receiving a system notification that a spot instance will be reclaimed (5 minutes before reclamation), ACK attempts to scale out new instances for compensation.
Active release of spot instances may cause business disruptions. To improve compensation success rates, we recommend also enabling Use Pay-as-you-go Instances When Spot Instances Are Insufficient. Cloud resource and billing information: |
Expand Advanced Options (Optional) to configure ECS tags, taints, and other settings.
Step 4: Component configuration
Click Next: Component Configuration to configure basic and advanced component options.
Parameter | Description |
Cloud-edge Communication Component | The Raven component builds a network tunnel over the public network to enable cross-region communication between the cloud and the edge. It enables features such as edge node monitoring and O&M. If your cluster uses an Express Connect circuit for cloud-edge network communication, you do not need to install the Raven component. For more information, see Raven: A Cross-Region O&M Communication Component. |
CloudMonitor Agent | View and monitor node and application status in the CloudMonitor console. This setting applies only to new nodes added to the node pool, not existing nodes. To enable this for existing nodes, install it in the CloudMonitor console. Cloud resource and billing information: |
Log Service | Use an existing SLS Project or create a new one to collect cluster application logs. Also enables the cluster API Server audit feature to collect requests to the Kubernetes API and their results. To enable this later, see Collect ACK cluster container logs, Use cluster API Server audit feature.
Cloud resource and billing information: |
Step 5: Confirm configuration and billing
On the Confirm Configuration page, confirm the cluster configuration, including feature configurations, resource billing, and cloud product dependency checks. Then, read the Terms of Service.
An ACK Edge cluster incurs cluster management fees (for the Pro edition only) and cloud resource costs. You can view a cost summary for the cluster at the bottom of the creation page, or refer to Billing for ACK Edge clusters.
You can also click Equivalent Code in the upper-right corner of the Confirm Configuration page to generate Terraform or SDK example parameters for the current cluster configuration.
Billing
For details about ACK Edge cluster billing, see Billing for ACK Edge clusters.