Container Service for Kubernetes:CreateCluster

Nome personalizado do cluster. Pode conter dígitos, letras, caracteres chineses ou hifens (-). O nome deve ter de 1 a 63 caracteres e não pode começar com um hífen (-).

O ID da região onde o cluster é implantado. Para mais informações, consulte Regiões compatíveis com o Container Service for Kubernetes.

• Kubernetes: Cluster ACK dedicado.

• ManagedKubernetes: Clusters ACK gerenciados, incluindo clusters ACK gerenciados (edições Pro e Basic), clusters ACK serverless (edições Pro e Basic), clusters ACK Edge (edições Pro e Basic) e clusters ACK LINGJUN (edição Pro).

• ExternalKubernetes: Cluster registrado.

Quando cluster_type é definido como ManagedKubernetes e profile é configurado, você pode especificar ainda mais a especificação do cluster. Valores válidos:

• ack.standard: Edição Basic (padrão se deixado vazio)

• ack.pro.small: Edição Pro

• ack.pro.xlarge: Pro XL

• ack.pro.2xlarge: Pro 2XL

• ack.pro.4xlarge: Pro 4XL (requer acesso à lista de permissões do atendimento ao cliente)

Pro XL, Pro 2XL e Pro 4XL são três níveis fornecidos pelo Plano de controle provisionado do ACK Pro. Esses níveis pré-alocam e dedicam recursos do plano de controle para garantir alta concorrência de API e desempenho de agendamento de pods consistentemente, sendo ideais para treinamento/inferência de IA, clusters de ultra grande escala e cargas de trabalho de missão crítica.

Para taxas de gerenciamento de cluster das edições Pro e plano de controle provisionado, consulte Taxas de gerenciamento de cluster.

Quando cluster_type é definido como ManagedKubernetes (clusters ACK gerenciados), você pode especificar ainda mais o subtipo do cluster.

• Default: Cluster ACK gerenciado, incluindo clusters ACK (edições Pro e Basic).

• Edge: Cluster ACK Edge, incluindo clusters ACK Edge (edições Pro e Basic).

• Serverless: Cluster ACK serverless, incluindo clusters ACK serverless (edições Pro e Basic).

• Lingjun: Cluster ACK LINGJUN, disponível apenas na edição Pro.

Versão do cluster, alinhada com a versão de linha de base da comunidade Kubernetes. Recomendamos selecionar a versão mais recente. Se não for especificada, a versão mais recente será usada por padrão.

Você pode criar clusters usando qualquer uma das três versões mais recentes. Use a API DescribeKubernetesVersionMetadata para consultar as versões de cluster compatíveis.

Para mais informações sobre as versões do Kubernetes compatíveis com o ACK, consulte Visão geral dos lançamentos de versões do Kubernetes.

O ID do grupo de recursos ao qual o cluster pertence, permitindo o isolamento de recursos.

A proteção contra exclusão de cluster evita a exclusão acidental via console ou API. Valores válidos:

• true: Ativa a proteção contra exclusão. O cluster não pode ser excluído através do console ou da API.

• false: Desativa a proteção contra exclusão. O cluster pode ser excluído através do console ou da API.

Valor padrão: false.

A VPC usada pelo cluster. Você deve fornecê-la ao criar o cluster.

Pilha de IP do cluster.

Bloco CIDR da rede de pods. Deve ser um bloco CIDR privado válido: 10.0.0.0/8, 172.16–31.0.0/12–16 ou 192.168.0.0/16. Não pode se sobrepor aos blocos CIDR da VPC ou de clusters Kubernetes existentes. Isso não pode ser modificado após a criação do cluster.

Para planejamento de rede do cluster, consulte Planejamento de rede para clusters ACK gerenciados.

Bloco CIDR da rede de serviços. Intervalos válidos: 10.0.0.0/16–24, 172.16–31.0.0/16–24, 192.168.0.0/16–24. Não pode se sobrepor ao bloco CIDR da VPC 10.1.0.0/21 ou a blocos CIDR de clusters Kubernetes existentes. Isso não pode ser modificado após a criação do cluster.

Valor padrão: 172.19.0.0/20.

Especifique um ID de grupo de segurança existente ao criar um cluster. Use este parâmetro ou is_enterprise_security_group. Os nós do cluster são adicionados automaticamente a este grupo de segurança.

Cria automaticamente um grupo de segurança corporativo quando security_group_id está vazio.

• true: Cria e usa um grupo de segurança corporativo.

• false: Usa um grupo de segurança básico.

Valor padrão: true.

Configura o SNAT para a VPC. Valores válidos:

• true: Cria automaticamente um NAT Gateway e configura regras SNAT. Defina como true se os nós ou aplicativos no cluster precisarem de acesso à rede pública.

• false: Não cria um NAT Gateway ou regras SNAT. Os nós e aplicativos no cluster não podem acessar a rede pública.

Valor padrão: false.

Ativa o acesso à rede pública. Expõe o API Server via EIP para permitir acesso público.

• true: Ativa o acesso público.

• false: Desativa o acesso público. Se desativado, você não pode acessar o API Server do cluster a partir da rede pública.

Valor padrão: false.

Especifique o ID da instância CLB para acesso ao API Server. Se especificado, nenhum novo CLB do API Server é criado automaticamente.

Ativa o login SSH público. Usado para fazer login nos nós mestre de clusters ACK dedicados. Este parâmetro não tem efeito para clusters gerenciados.

• true: Ativar.

• false: Desativar.

Valor padrão: false.

Fuso horário usado pelo cluster. Consulte Fusos horários suportados.

Número de IPs de nó, determinado pela máscara CIDR. Aplica-se apenas a clusters de rede Flannel.

Valor padrão: 26.

Modo de proxy do kube-proxy

• iptables: Modo kube-proxy maduro e estável. Usa regras iptables para descoberta de serviços e balanceamento de carga do Kubernetes. O desempenho é moderado e não escala bem com um grande número de serviços. Adequado para clusters com poucos serviços.

• ipvs: Modo kube-proxy de alto desempenho. Usa módulos IPVS do Linux para descoberta de serviços e balanceamento de carga. Ideal para clusters com muitos serviços que exigem balanceamento de carga de alto desempenho.

• nftables: Modo kube-proxy de próxima geração baseado em nftables do Linux para descoberta de serviços e balanceamento de carga. Um substituto moderno para o iptables. Oferece melhor desempenho de rede, eficiência de atualização de regras e escalabilidade para grandes contagens de serviços.
  Suportado apenas para clusters executando Kubernetes 1.35 ou posterior. A comunidade Kubernetes descontinuou o IPVS a partir da versão 1.35. Recomendamos o uso de nftables para novos clusters para garantir suporte de longo prazo da comunidade.
  

Valor padrão: ipvs.

Período de retenção (em dias) para logs de componentes do plano de controle.

Projeto do Simple Log Service para logs de componentes do plano de controle. Você pode usar um projeto existente ou deixar o sistema criar um automaticamente. Se criado automaticamente, o nome do projeto será k8s-log-{ClusterID}.

Nome de domínio local do cluster.

Regras de nomenclatura: O domínio consiste em uma ou mais partes separadas por pontos (.). Cada parte pode ter até 63 caracteres e pode conter letras minúsculas, dígitos e hifens (-). Cada parte deve começar e terminar com uma letra minúscula ou dígito.

ID da chave KMS usada para criptografar discos de dados. Para mais informações, consulte Key Management Service.

ServiceAccount é a credencial de acesso usada pelos pods para se comunicar com o API Server do cluster. O service-account-issuer é a identidade do emissor no serviceaccount token, representada pelo campo iss no token payload.

Para mais informações sobre ServiceAccount, consulte Implantar projeção de volume de token de conta de serviço.

ServiceAccount é a credencial de acesso usada pelos pods para se comunicar com o API Server do cluster. O api-audiences especifica identidades de token de solicitação válidas para o apiserver autenticar se um token de solicitação é válido. Você pode configurar vários valores de audience separados por vírgulas (,).

Para mais informações sobre ServiceAccount, consulte Implantar projeção de volume de token de conta de serviço.

Janela de manutenção do cluster.

CA personalizada do cluster.

[Descontinuado] Use o parâmetro extra_sans em vez disso.

SAN de certificado personalizado. Separe vários endereços IP ou nomes de domínio com vírgulas (,).

Runtime de contêiner para o cluster. Suporta containerd, contêiner em sandbox e Docker.

Para mais informações, consulte Comparação dos runtimes de contêiner Docker, containerd e contêiner em sandbox.

[Descontinuado] Para configuração do pool de nós, use o parâmetro node_name_mode em kubernetes_config no nodepool.

[Descontinuado] Dados personalizados do nó.

[Descontinuado] Para configuração do plano de controle, use o parâmetro image_id em control_plane_config. Para configuração do pool de nós, use o parâmetro image_id em scaling_group no nodepool.

Imagem personalizada do nó. Por padrão, a imagem do sistema é usada. Quando uma imagem personalizada é selecionada, ela substitui a imagem padrão do sistema. Consulte Imagens personalizadas.

[Descontinuado] Para configuração de nó do plano de controle, use o parâmetro cloud_monitor_flags em control_plane_config. Para configuração do pool de nós, use o parâmetro cms_enabled em kubernetes_config no nodepool.

Instala o agente do CloudMonitor no cluster. Valores válidos:

• true: Instalar o agente do CloudMonitor.

• false: Não instalar o agente do CloudMonitor.

Valor padrão: false.

[Descontinuado] Para configuração do pool de nós, use o parâmetro platform em scaling_group no nodepool.

Distribuição do sistema operacional. Valores válidos:

• CentOS

• AliyunLinux

• QbootAliyunLinux

• Qboot

• Windows

• WindowsCore

Valor padrão: CentOS.

[Descontinuado] Para configuração de nó do plano de controle, use o parâmetro image_type em control_plane_config. Para configuração do pool de nós, use o parâmetro image_type em scaling_group no nodepool.

Tipo de plataforma do sistema operacional. Valores válidos:

• Windows

• Linux

Valor padrão: Linux.

[Descontinuado] Para configuração de nó do plano de controle, use o parâmetro soc_enabled em control_plane_config. Para configuração do pool de nós, use o parâmetro soc_enabled em scaling_group no nodepool.

Endurecimento de segurança MLPS 2.0. Para mais informações, consulte Instruções para uso do endurecimento de segurança MLPS 2.0 no ACK.

Valores válidos:

• true: Ativar o endurecimento de segurança MLPS 2.0.

• false: Desativar o endurecimento de segurança MLPS 2.0.

Valor padrão: false.

[Descontinuado] Para configuração do plano de controle, use o parâmetro security_hardening_os em control_plane_config. Para configuração do pool de nós, use o parâmetro security_hardening_os em scaling_group no nodepool.

Endurecimento de segurança do Alibaba Cloud OS. Valores válidos:

• true: Ativar o endurecimento de segurança do Alibaba Cloud OS.

• false: Desativar o endurecimento de segurança do Alibaba Cloud OS.

Valor padrão: false.

[Descontinuado] Para configuração do plano de controle, use o parâmetro security_hardening_os em control_plane_config. Para configuração do pool de nós, use o parâmetro security_hardening_os em scaling_group no nodepool.

[Descontinuado] Para configuração do plano de controle, use o parâmetro cpu_policy em control_plane_config. Para configuração do pool de nós, use o parâmetro cpu_policy em kubernetes_config no nodepool.

Política de gerenciamento de CPU do nó. Suportado para versões de cluster 1.12.6 e posteriores:

• static: Melhora a afinidade e exclusividade da CPU para pods com características de recursos específicas no nó.

• none: Usa o esquema de afinidade de CPU padrão.

Valor padrão: none.

Intervalo de portas de serviço do nó. Intervalo válido: \

[Deprecated] For control plane configuration, use the key_pair parameter under control_plane_config. For node pool configuration, use the key_pair parameter under scaling_group in nodepool.

Key pair name. Use either this parameter or login_password.

[Deprecated] For control plane configuration, use the login_password parameter under control_plane_config. For node pool configuration, use the login_password parameter under scaling_group in nodepool.

SSH login password. Use either this parameter or key_pair. Password rules: 8–30 characters, including at least three of the following: uppercase letters, lowercase letters, digits, and special characters.

[Deprecated] For control plane configuration, use the size parameter under control_plane_config.

Number of master nodes. Valid values: 3 or 5.

Default value: 3.

[Deprecated] For control plane configuration, use the system_disk_category parameter under control_plane_config.

Master node system disk type. Valid values:

• cloud_efficiency: Ultra disk.

• cloud_ssd: Standard SSD.

• cloud_essd: ESSD.

Default value: cloud_ssd. The default may vary by zone.

[Deprecated] For control plane configuration, use the system_disk_size parameter under control_plane_config.

Master node system disk size. Valid range: [40,500]. Unit: GiB.

Default value: 120.

[Deprecated] For control plane configuration, use the system_disk_performance_level parameter under control_plane_config.

Performance level of the master node system disk. Applies only to ESSD disks. Disk performance levels depend on disk size. For more information, see ESSD.

[Deprecated] For control plane configuration, use the system_disk_snapshot_policy_id parameter under control_plane_config.

Automatic snapshot policy ID for master node system disks.

[Deprecated] For control plane configuration, use the instance_charge_type parameter under control_plane_config.

Master node payment type. Valid values:

• PrePaid: Subscription.

• PostPaid: Pay-as-you-go.

Default value: PostPaid.

[Deprecated] For control plane configuration, use the period_unit parameter under control_plane_config.

Master node billing cycle. Required when master_instance_charge_type is PrePaid.

Valid value: Month. Only monthly billing is supported.

[Deprecated] For control plane configuration, use the unit parameter under control_plane_config.

Master node subscription duration in months. Required and valid only when master_instance_charge_type is PrePaid.

Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Default value: 1.

[Deprecated] For control plane configuration, use the auto_renew parameter under control_plane_config.

Enable auto-renewal for master nodes. Valid only when master_instance_charge_type is PrePaid. Valid values:

• true: Enable auto-renewal.

• false: Disable auto-renewal.

Default value: true.

[Deprecated] For control plane configuration, use the auto_renew_period parameter under control_plane_config.

Master node auto-renewal period. Required and valid only when subscription billing is selected.

Valid values: {1, 2, 3, 6, 12}.

Default value: 1.

[Deprecated] For node pool configuration, use the desired_size parameter under scaling_group in nodepool.

Number of worker nodes. Range: [0,100].

[Deprecated] For node pool configuration, use the system_disk_category parameter under scaling_group in nodepool.

Worker node system disk type. For more information, see Overview of Elastic Block Storage.

Valid values:

• cloud_efficiency: Ultra disk.

• cloud_ssd: Standard SSD.

Default value: cloud_ssd.

[Deprecated] For node pool configuration, use the system_disk_size parameter under scaling_group in nodepool.

Worker node system disk size. Unit: GiB.

Valid range: [40,500].

The value must be greater than or equal to max{40, ImageSize}.

Default value: 120.

[Deprecated] For node pool configuration, use the system_disk_snapshot_policy_id parameter under scaling_group in nodepool.

Automatic snapshot policy ID for worker node system disks.

[Deprecated] For node pool configuration, use the system_disk_performance_level parameter under scaling_group in nodepool.

When the system disk is an ESSD, you can set the performance level (PL). For more information, see ESSD.

Valid values:

• PL0

• PL1

• PL2

• PL3

[Deprecated] For node pool configuration, use the instance_charge_type parameter under scaling_group in nodepool.

Worker node payment type. Valid values:

• PrePaid: Subscription.

• PostPaid: Pay-as-you-go.

Default value: Pay-as-you-go.

[Deprecated] For node pool configuration, use the period_unit parameter under scaling_group in nodepool.

Worker node billing cycle. Required when worker_instance_charge_type is PrePaid.

Valid value: Month. Only monthly billing is supported.

[Deprecated] For node pool configuration, use the period parameter under scaling_group in nodepool.

Worker node subscription duration in months. Required and valid only when worker_instance_charge_type is PrePaid.

Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Default value: 1.

[Deprecated] For node pool configuration, use the auto_renew parameter under scaling_group in nodepool.

Enable auto-renewal for worker nodes. Valid only when worker_instance_charge_type is PrePaid. Valid values:

• true: Enable auto-renewal.

• false: Disable auto-renewal.

Default value: true.

[Deprecated] For node pool configuration, use the auto_renew_period parameter under scaling_group in nodepool.

Worker node auto-renewal period. Required and valid only when subscription billing is selected.

Valid values: {1, 2, 3, 6, 12}.

[Deprecated] Adding existing nodes during cluster creation is not supported. To add existing nodes to a cluster, first create a node pool and then call the AttachInstancesToNodePool API.

When using existing instances to create a cluster, specify whether to mount data disks. Valid values:

• true: Store containers and images on the data disk. Existing data on the data disk will be lost. Back up your data.

• false: Do not store containers and images on the data disk.

Default value: false.

Data disk mounting rules:

• If the ECS instance has a mounted data disk and the file system of the last data disk is uninitialized, the system automatically formats it as ext4 to store /var/lib/docker and /var/lib/kubelet.

• If the ECS instance has no mounted data disk, no new data disk is mounted.

[Deprecated] Adding existing nodes during cluster creation is not supported. To add existing nodes to a cluster, first create a node pool and then call the AttachInstancesToNodePool API.

When using existing instances to create a cluster, specify whether to retain the instance name.

• true: Retain.

• false: Replace with a system-generated name.

Default value: true.

[Deprecated] Use the snat_entry parameter instead.

[Deprecated] Use the zone_ids parameter instead.

The zone ID within the cluster region. This parameter applies only to ACK managed clusters.

When creating an ACK managed cluster without specifying vpc_id and vswitch_ids, specify zone_id to automatically create VPC network resources in this zone. This parameter is ignored if vpc_id and vswitch_ids are specified.

[Deprecated] Enable Simple Log Service for the cluster. Applies only to ACK Serverless clusters and must be set to SLS.

[Deprecated] By default, cluster creation failures do not trigger rollback. You must manually clean up failed clusters.

Roll back on cluster creation failure. Valid values:

• true: Roll back when cluster creation fails.

• false: Do not roll back when cluster creation fails.

Default value: true.

[Deprecated] By default, cluster creation failures do not trigger rollback. You must manually clean up failed clusters.

Cluster creation timeout in minutes.

Default value: 60.

[Deprecated] For control plane configuration, use the image_type parameter under control_plane_config. For node pool configuration, use the image_type parameter under scaling_group in nodepool.

Operating system distribution type. We recommend using this parameter to specify the node operating system. Valid values:

• CentOS

• AliyunLinux

• AliyunLinux Qboot

• AliyunLinuxUEFI

• AliyunLinux3

• Windows

• WindowsCore

• AliyunLinux3Arm64

• ContainerOS

Default value: CentOS.

[Deprecated] CLB is billed based on usage. This parameter has no effect.

Load Balancer specification. Valid values:

• slb.s1.small

• slb.s2.small

• slb.s2.medium

• slb.s3.small

• slb.s3.medium

• slb.s3.large

Default value: slb.s2.small.

[Deprecated] Use the rrsa_config parameter instead.

Enable RRSA.

• true: Enable.

• false: Disable.

[Deprecated]

Payment type for the CLB instance used by the API Server. Default value: PostPaid. Valid values:

• PostPaid: Pay-as-you-go.

• PrePaid: Subscription. New CLB instances no longer support subscription billing, but existing instances are unaffected.

[Deprecated]

Billing cycle. Required when payment type is PrePaid.

Valid value: Month. Only monthly billing is supported.

This parameter changed on October 15, 2024. For more information, see Announcement on Changes to CreateCluster API Parameters.

[Deprecated]

Subscription duration. Required and valid only when charge_type is PrePaid.

Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Default value: 1.

This parameter changed on October 15, 2024. For more information, see Announcement on Changes to CreateCluster API Parameters.

[Deprecated]

Enable auto-renewal. Valid only when charge_type is PrePaid. Valid values:

• true: Enable auto-renewal.

• false: Disable auto-renewal.

Default value: false.

This parameter changed on October 15, 2024. For more information, see Announcement on Changes to CreateCluster API Parameters.

[Deprecated]

Auto-renewal period. Valid only when prepaid and auto-renewal are enabled. When PeriodUnit=Month, valid values: {1, 2, 3, 6, 12}.

Default value: 1.

This parameter changed on October 15, 2024. For more information, see Announcement on Changes to CreateCluster API Parameters.

Cluster ID.

Request ID.

Task ID.