全部产品
Search
文档中心

Container Service for Kubernetes:Buat kluster

更新时间:Jul 06, 2025

Membuat kluster Container Service for Kubernetes (ACK) dan menambahkan jumlah node yang ditentukan ke dalam kluster.

Untuk informasi lebih lanjut tentang perintah ini, lihat CreateCluster.

Format permintaan dan respons API

Format Permintaan

aliyun cs  POST /clusters --region=${regionId} --header "Content-Type=application/json" --body "$(cat create.json)"

Parameter Permintaan:

  • --region: Wilayah tempat kluster Anda di-host.

  • --header: Anda harus mengatur Content-Type menjadi application/json.

  • --body: Konten yang dikirim ke server. Konten dapat disimpan dalam file lokal dan harus dalam format JSON yang valid. File create.json berisi konten berikut:

Contoh Permintaan:

  • Kubernetes cluster

    {
        "cluster_type":"Kubernetes",
        "name":"webService",
        "region_id":"cn-beijing",
        "disable_rollback":true,
        "timeout_mins":60,
        "kubernetes_version":"1.14.8-aliyun.1",
        "snat_entry":true,
        "endpoint_public_access":true,
        "ssh_flags":true,
        "cloud_monitor_flags":true,
        "deletion_protection":false,
        "node_cidr_mask":"26",
        "proxy_mode":"ipvs",
        "tags":[],
        "addons":[{"name":"flannel"},{"name":"arms-prometheus"},{"name":"flexvolume"},{"name":"alicloud-disk-controller"},{"name":"logtail-ds","config":"{"IngressDashboardEnabled":"false"}"},{"name":"ack-node-problem-detector","config":"{"sls_project_name":""}"},{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}],
        "os_type":"Linux",
        "platform":"CentOS",
        "node_port_range":"30000-32767",
        "key_pair":"sian-sshkey",
        "cpu_policy":"none",
        "master_count":3,
        "master_vswitch_ids":["vsw-2zete8s4qocqg0mf6****","vsw-2zete8s4qocqg0mf6****","vsw-2zete8s4qocqg0mf6****"],
        "master_instance_types":["ecs.n4.large","ecs.n4.large","ecs.n4.large"],
        "master_system_disk_category":"cloud_ssd",
        "master_system_disk_size":120,
        "runtime":{"name":"docker","version":"18.09.2"},
        "worker_instance_types":["ecs.i1.xlarge"],
        "num_of_nodes":1,
        "worker_system_disk_category":"cloud_efficiency",
        "worker_system_disk_size":120,
        "vpcid":"vpc-2zecuu62b9zw7a7q****",
        "worker_vswitch_ids":["vsw-2zete8s4qocqg0mf6****"],
        "container_cidr":"172.20.0.0/16",
        "service_cidr":"172.21.0.0/20"
    }

    Deskripsi Contoh Permintaan

    Jika Anda membuat kluster yang menggunakan Plugin Terway, parameter pod_vswitch_ids diperlukan. 
    {
        "cluster_type":"Kubernetes",
        "name":"webService-terway",
        "region_id":"cn-beijing",
        "disable_rollback":true,
        "timeout_mins":60,
        "kubernetes_version":"1.14.8-aliyun.1",
        "snat_entry":true,
        "endpoint_public_access":true,
        "ssh_flags":true,"cloud_monitor_flags":true,
        "deletion_protection":false,
        "proxy_mode":"ipvs",
        "tags":[],
        "addons":[{"name":"terway-eni"},{"name":"flexvolume"},{"name":"alicloud-disk-controller"},{"name":"logtail-ds","config":"{\"IngressDashboardEnabled\":\"false\"}"},{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"\"}"},{"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"}],
        "os_type":"Linux",
        "platform":"CentOS",
        "node_port_range":"30000-32767",
        "pod_vswitch_ids":["vsw-2zete8s4qocqg0mf6****"],
        "key_pair":"sian-sshkey",
        "cpu_policy":"none",
        "master_count":3,
        "master_vswitch_ids":["vsw-2zed90q9inwtuyfzd****","vsw-2zed90q9inwtuyfzd****","vsw-2zed90q9inwtuyfzd****"],
        "master_instance_types":["ecs.i1.4xlarge","ecs.i1.4xlarge","ecs.i1.4xlarge"],
        "master_system_disk_category":"cloud_ssd",
        "master_system_disk_size":120,
        "runtime":{"name":"docker","version":"18.09.2"},
        "worker_instance_types":["ecs.i1.4xlarge"],
        "num_of_nodes":1,
        "worker_system_disk_category":"cloud_efficiency",
        "worker_system_disk_size":120,
        "vpcid":"vpc-2zecuu62b9zw7a7qnn2tv",
        "worker_vswitch_ids":["vsw-2zed90q9inwtuyfzd****"],
        "is_enterprise_security_group":true,
        "service_cidr":"172.21.0.0/20"
    }
  • Managed Kubernetes cluster

    {
        "name":"amk-cluster",
        "cluster_type":"ManagedKubernetes",
        "disable_rollback":true,
        "timeout_mins":60,
        "kubernetes_version":"1.16.9-aliyun.1",
        "region_id":"cn-beijing",
        "snat_entry":true,
        "cloud_monitor_flags":true,
        "endpoint_public_access":true,
        "deletion_protection":true,
        "node_cidr_mask":"26",
        "proxy_mode":"ipvs",
        "tags":[
            {
                "key":"tier",
                "value":"backend"
            }
        ],
        "addons":[{"name":"flannel"},{"name":"csi-plugin"},{"name":"csi-provisioner"},{"name":"logtail-ds","config":"{\"IngressDashboardEnabled\":\"true\"}"},{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"\"}"},{"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"},{"name":"arms-prometheus"}],
        "os_type":"Linux",
        "platform":"CentOS",
        "runtime":{
            "name":"docker",
            "version":"19.03.5"
        },
        "worker_instance_types":[
            "ecs.i2.2xlarge"
        ],
        "num_of_nodes":3,
        "worker_system_disk_category":"cloud_efficiency",
        "worker_system_disk_size":120,
        "worker_data_disks":[
            {
                "category":"cloud_efficiency",
                "size":"40",
                "encrypted":"true",
                "auto_snapshot_policy_id":""
            }
        ],
        "worker_instance_charge_type":"PrePaid",
        "worker_period_unit":"Month",
        "worker_period":1,
        "worker_auto_renew":true,
        "worker_auto_renew_period":1,
        "vpcid":"vpc-2zemm8mo5rmdppgqm****",
        "container_cidr":"172.20.0.0/16",
        "service_cidr":"172.21.0.0/20",
        "vswitch_ids":[
            "vsw-2zej67xyhh61oqn7i****"
        ],
        "login_password":"Hello1234",
        "logging_type":"SLS",
        "cpu_policy":"none",
        "taints":[
            {
                "key":"key1",
                "value":"value1",
                "effect":"NoSchedule"
            }
        ],
        "security_group_id":"sg-2zeg3u73kkhtixda****"
    }
  • ACK Serverless cluster

    {
        "cluster_type":"Ask",
        "name":"ask-cluster",
        "kubernetes_version":"1.16.9-aliyun.1",
        "region_id":"cn-shenzhen",
        "endpoint_public_access":true,
        "private_zone":true,
        "tags":[
            {
                "key":"tier",
                "value":"frontend"
            }
        ],
        "deletion_protection":true,
        "addons":[
            {
                "name":"logtail-ds"
            }
        ],
        "zone_id":"cn-shenzhen-a",
        "vpc_id":"vpc-wz984yvbd6lck22z3****",
        "vswitch_ids":[
            "vsw-wz9uwxhawmtzg7u9h****"
        ],
        "logging_type":"SLS",
        "security_group_id":"sg-wz9b86l4s7nthi1k****"
    }

Contoh Respons

{
    "cluster_id": "c61cf530524474386a7ab5a1c192****",
    "request_id": "348D4C9C-9105-4A1B-A86E-B58F0F875575",
    "task_id": "T-5ad724ab94a2b109e8000004"
}