Container Service for Kubernetes：建立ACK專有叢集

調試入口

CreateCluster調試入口

請求樣本

建立一個ACK專有叢集的請求樣本如下，完整的參數說明請參見建立叢集。

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,               //叢集不安裝CloudMonitor組件。
    "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叢集。