Container Compute Service:Create an ACS cluster

Step 1: Open the cluster creation page

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

2. On the Clusters page, click Create Kubernetes Cluster in the upper-left corner.

Step 2: Configure the cluster

On the Create Cluster page, configure cluster, network, component, and advanced settings.

Step 3: Confirm and create

1. Click Confirm Order.

2. In the dialog box, confirm the settings and verify that the cluster passes all dependency checks.

3. Read and select the Service Agreement, then click Create Cluster.

Cluster creation takes approximately 10 minutes.

Verify the cluster

After the cluster is created, verify it on the Clusters page:

1. Find the cluster and click Details in the Actions column.

2. Click the Basic Information tab to view cluster details, including:

   • API server Public Endpoint: The address and port for managing the cluster from the Internet by using kubectl. You can change or unbind the associated EIP. The API server briefly restarts when you associate or disassociate an EIP. Do not perform operations on the cluster during the restart.

   • API server Internal Endpoint: The address and port for managing the cluster from within the VPC. This IP address is the CLB instance address.

3. Click the Connection Information tab to view connection details.

4. Click the Cluster Logs tab to view cluster logs.

Authorization

Add the following permission to a RAM policy:

Request

POST /clusters HTTP/1.1

Required parameters

The following parameters distinguish an ACS cluster from an ACK managed cluster:

Optional parameters

Sample request

The following example creates an ACS cluster in the China (Hangzhou) region with an existing VPC and ALB Ingress:

{
    "name": "ACS Cluster",
    "cluster_type": "ManagedKubernetes",
    "profile": "Acs",
    "cluster_spec": "ack.pro.small",
    "kubernetes_version": "1.31.1-aliyun.1",
    "region_id": "cn-hangzhou",
    "vpcid": "vpc-j6cc1ddlp4rzs7v******",
    "service_cidr": "192.168.xx.xx/16",
    "vswitch_ids": [
        "vsw-j6cht66iul7h61x******",
        "vsw-j6c5ne6mxgnx3g5******"
    ],
    "addons": [
        {
            "name": "alb-ingress-controller"
        }
    ]
}

For a complete list of parameters, see CreateCluster.

Response

A successful response:

{
    "cluster_id": "c54c8e4c703834c48bda53ae7841*****",
    "request_id": "08CCB494-7A82-5D51-907C-A6BF658*****",
    "task_id": "T-68007b2164acba01060*****",
    "instanceId": "c54c8e4c703834c48bda53ae7841*****"
}

An error response (for example, an invalid cluster_type value):

{
    "code": "400",
    "message": "no ros component exists. clusterType: Kubernetes, version: ",
    "requestId": "7D99D268-F1E1-5ED8-B757-E5D38A0*****",
    "status": 400
}

Error codes

For a list of error codes, see the Error Center.