创建ACK专有集群

调试入口

CreateCluster调试入口

请求示例

创建一个ACK专有集群的请求示例如下，完整的参数说明请参见CreateCluster - 创建集群。

POST /clusters 
<公共请求头>
{
    "cluster_type": "Kubernetes",    //指定集群的类型为ACK专有集群。#required
    "name": "ACK专有集群",
    "region_id": "cn-hongkong",      //集群所属地域为香港地域。#required
    "kubernetes_version": "1.32.1-aliyun.1",    //创建的集群版本，建议选择最新版本。 
    "snat_entry": true,                         // 为专有网络配置SNAT规则，以开启集群公网访问。
    "endpoint_public_access": false,            //集群不开启API server公网访问。
    "cloud_monitor_flags": false,               //集群不安装云监控组件。
    "deletion_protection": false,               //未开启集群删除保护。
    "proxy_mode": "ipvs",                       //选择高性能的kube-proxy代理模式IPVS。
    "timezone": "Asia/Shanghai",
    "tags": [],
    "addons": [                                 //安装的集群组件。
        {
            "name": "terway-eniip",             //集群的网络类型为Terway方式。集群创建后不可修改。
            "config": "{\"IPVlan\":\"false\",\"NetworkPolicy\":\"false\",\"ENITrunking\":\"false\"}"
        },
        {
            "name": "csi-plugin"
        },
        {
            "name": "csi-provisioner"
        },
        {
            "name": "storage-operator",
            "config": "{\"CnfsOssEnable\":\"false\",\"CnfsNasEnable\":\"false\"}"
        },
        {
            "name": "nginx-ingress-controller",
            "disabled": true
        }
    ],
    "node_port_range": "30000-32767",
    "pod_vswitch_ids": [                         //Terway网络类型的集群，需要指定Pod所在的虚拟交换，因为Pod独占一个机器IP。
        "vsw-j6cwz95vspl56gl******",
        "vsw-j6c1tgut51ude2v******"
    ],
    "login_password": "******",
    "charge_type": "PostPaid",
    "master_instance_charge_type": "PostPaid",
    "cpu_policy": "none",
    "service_account_issuer": "https://kubernetes.default.svc",
    "api_audiences": "https://kubernetes.default.svc",
    "master_count": 3,                         //设置Master节点数量为3。
    "master_vswitch_ids": [                    //设置Master节点的交换机列表。
        "vsw-j6cwz95vspl56gl******",
        "vsw-j6c1tgut51ude2v******",
        "vsw-j6c1tgut51ude2v******"
    ],
    "master_instance_types": [                 //设置Master节点的实例规格。
        "ecs.u1-c1m2.xlarge",
        "ecs.c7.xlarge",
        "ecs.c7.xlarge"
    ],
    "master_system_disk_category": "cloud_essd",      //Master节点系统盘选择ESSD云盘。
    "master_system_disk_size": 120,                   //设置系统盘大小为120 GiB。
    "master_system_disk_performance_level": "PL1",    //系统盘单盘IOPS性能上限为5万。
    "vpcid": "vpc-j6c6njo385se80n******",             //集群的专有网络ID须在网络规划时确定，创建后不可修改。#required
    "worker_vswitch_ids": [
        "vsw-j6cwz95vspl56gl******",
        "vsw-j6c1tgut51ude2v******"
    ],
    "is_enterprise_security_group": true,
    "ip_stack": "ipv4",
    "service_cidr": "172.16.xx.xx/16",
    "nodepools": [                                                 
        {
            "nodepool_info": {
                "name": "default-nodepool"
            },
            "scaling_group": {
                "system_disk_category": "cloud_essd",
                "system_disk_size": 120,
                "system_disk_performance_level": "PL0",
                "system_disk_encrypted": false,
                "data_disks": [         
                    {
                        "category": "cloud_auto",
                        "size": 200,
                        "encrypted": "false",
                        "bursting_enabled": false
                    }
                ],
                "tags": [],
                "soc_enabled": false,
                "security_hardening_os": false,
                "vswitch_ids": [
                    "vsw-j6cwz95vspl56gl******",
                    "vsw-j6c1tgut51ude2v******"
                ],
                "instance_types": [
                    "ecs.g6.xlarge"
                ],
                "instance_patterns": [],
                "login_password": "******",
                "instance_charge_type": "PostPaid",
                "security_group_ids": [],
                "platform": "AliyunLinux",
                "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
                "image_type": "AliyunLinux3",
                "desired_size": 3,               //创建一个期望节点数为3的节点池。
                "multi_az_policy": "BALANCE"
            },
            "kubernetes_config": {
                "cpu_policy": "none",
                "cms_enabled": false,
                "unschedulable": false,
                "runtime": "containerd",        //设置容器运行时为containerd 1.6.36。集群创建后不可修改。
                "runtime_version": "1.6.36"
            }
        }
    ]
}

重点参数说明

在调用CreateCluster接口创建ACK专有集群时，您需要重点关注如下参数的差异化配置：

具体操作，请参见通过Terraform创建ACK专有集群。

具体操作，请参见Java SDK调用示例。

具体操作，请参见通过CLI创建ACK集群。