Container Service for Kubernetes:ACK マネージドクラスターの作成

手順

ACK コンソールのデフォルトのクラスター構成に基づいてクラスターを作成できます。パラメーターをきめ細かく構成する方法の詳細については、「ACK マネージドクラスター ConfigMap の説明」をご参照ください。次の図は、プロセスの概要を示しています。

デバッグ

デバッグ

サンプルリクエスト

次のサンプルリクエストは、ACK マネージド Pro クラスタを作成するために使用されます。パラメーターの詳細については、「CreateCluster」をご参照ください。

POST /clusters 
<共通リクエストヘッダー>
{
    "name": "ACK managed cluster",            
    "cluster_type": "ManagedKubernetes",  // profile および cluster_spec と共にこのパラメーターを使用して、クラスタタイプを ACK マネージド Pro クラスタに設定します。 #必須
    "profile": "Default",                    
    "cluster_spec": "ack.pro.small",         
    "kubernetes_version": "1.32.1-aliyun.1",  //作成されるクラスタの Kubernetes バージョン。最新の Kubernetes バージョンを選択することをお勧めします。    
    "region_id": "cn-hongkong",   //クラスタが属するリージョンは、中国 (香港) リージョンです。 #必須
    "snat_entry": true,           // クラスタをデプロイする VPC の SNAT ルールを設定して、クラスタのインターネットアクセスを有効にします。
    "endpoint_public_access": false,  //クラスタの API サーバーのインターネットアクセスは無効になっています。
    "deletion_protection": true,  //クラスタの削除保護を有効にします。
    "proxy_mode": "ipvs", // プロキシモードを IP Virtual Server (IPVS) に設定します。これは高パフォーマンスモードです。
    "tags": [],
    "timezone": "Asia/Shanghai",
    "addons": [                  //インストールされているクラスタコンポーネント。
        {
            "name": "terway-controlplane",
            "config": "{\"ENITrunking\":\"true\"}"
        },
        {
            "name": "terway-eniip",  //クラスタのネットワークプラグインは Terway です。クラスタの作成後、このパラメーターを変更することはできません。
            "config": "{\"IPVlan\":\"false\",\"NetworkPolicy\":\"false\",\"ENITrunking\":\"true\"}"
        },
        {
            "name": "csi-plugin"
        },
        {
            "name": "managed-csiprovisioner"
        },
        {
            "name": "storage-operator",
            "config": "{\"CnfsOssEnable\":\"false\",\"CnfsNasEnable\":\"false\"}"
        },
        {
            "name": "nginx-ingress-controller",
            "disabled": true
        },
        {
            "name": "ack-node-local-dns"
        }
    ],
    "enable_rrsa": false,
    "os_type": "Linux",
    "platform": "AliyunLinux",
    "image_type": "AliyunLinux3",
    "pod_vswitch_ids": [         // クラスタに Terway がインストールされている場合は、このパラメーターを設定して、ポッドの vSwitch を指定します。クラスタ内の各ポッドは個別の IP アドレスを使用します。
        "vsw-j6cht66iul7h61x******",
        "vsw-j6c5ne6mxgnx3g5******"
    ],
    "charge_type": "PostPaid",
    "vpcid": "vpc-j6cc1ddlp4rzs7v******",   //クラスタの VPC は、ネットワーク計画中に決定する必要があります。クラスタの作成後、VPC を変更することはできません。 #必須
    "service_cidr": "192.168.xx.xx/16",     //クラスタのサービス CIDR ブロック。 #必須
    "vswitch_ids": [                        // 複数の vSwitch を選択して、クラスタの高可用性を確保します。 #必須
        "vsw-j6cht66iul7h61x******",
        "vsw-j6c5ne6mxgnx3g5******"
    ],
    "ip_stack": "ipv4",                     // IP スタックタイプを IPv4 に設定します。
    "logging_type": "SLS",
    "cpu_policy": "none",
    "service_account_issuer": "https://kubernetes.default.svc",
    "api_audiences": "https://kubernetes.default.svc",
    "is_enterprise_security_group": true,
    "maintenance_window": {    //クラスタのメンテナンスウィンドウを毎週水曜日の 01:00 から 04:00 に設定します。
        "enable": true,
        "duration": "3h",
        "weekly_period": "Thursday",
        "maintenance_time": "2025-03-03T01:00:00.000+08:00",
    },
    "operation_policy": {
        "cluster_auto_upgrade": {
            "enabled": true,
            "channel": "stable"
        }
    },
    "controlplane_log_ttl": "30",
    "controlplane_log_components": [
        "apiserver",
        "kcm",
        "scheduler",
        "ccm",
        "controlplane-events",
        "alb"
    ],
    "nodepools": [
        {
            "nodepool_info": {         //ノードプール設定。
                "name": "default-nodepool"        
            },
            "scaling_group": {
                "system_disk_category": "cloud_essd",   //ノードプールのシステムディスクとして Enterprise SSD (ESSD) を選択します。
                "system_disk_size": 120,                //システムディスクサイズを 120 GiB に設定します。
                "system_disk_performance_level": "PL0", //システムディスクの最大 IOPS は 10000 です。
                "system_disk_encrypted": false,
                "data_disks": [],
                "tags": [],
                "soc_enabled": false,
                "security_hardening_os": false,
                "vswitch_ids": [
                    "vsw-j6cht66iul7h61x******",
                    "vsw-j6c5ne6mxgnx3g5******"
                ],
                "instance_types": [
                    "ecs.c6.xlarge",
                    "ecs.c7.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 であるノードプールを作成します。
                "rds_instances": [],
                "multi_az_policy": "BALANCE"
            },
            "kubernetes_config": {
                "cpu_policy": "none",
                "cms_enabled": true,
                "unschedulable": false,
                "runtime": "containerd",    //コンテナランタイムを containerd 1.6.36 に設定します。クラスタの作成後、このパラメーターを変更することはできません。
                "runtime_version": "1.6.36"
            },
            "node_config": {
                "image_acceleration_config": {
                    "enable_image_acceleration": false
                }
            },
            "management": {
                "enable": true,
                "auto_repair": true,
                "auto_repair_policy": {
                    "restart_node": true
                },
                "auto_upgrade": true,
                "auto_upgrade_policy": {
                    "auto_upgrade_kubelet": true,
                    "auto_upgrade_os": false
                },
                "auto_vul_fix": true,
                "auto_vul_fix_policy": {
                    "vul_level": "asap",
                    "restart_node": true
                },
                "rolling_policy": {
                    "max_parallelism": 10
                }
            }
        }
    ]
}

主要なパラメーター

CreateCluster 操作を呼び出して ACK マネージドクラスタ を作成する場合は、次のパラメーターを設定します。

詳細については、「Terraform を使用して ACK マネージドクラスターを作成する」をご参照ください。

詳細については、「Java 用 ACK SDK の使用方法の例」をご参照ください。

詳細については、「クラスタを作成する」をご参照ください。