Todos os produtos
Search
Central de documentação

Container Compute Service:Create an ACS cluster

Última atualização: Oct 14, 2026

Alibaba Cloud Container Compute Service (ACS) oferece computação de contêineres serverless por meio de uma API nativa do Kubernetes. Clusters ACS dimensionam Pods em segundos e cobram conforme a CPU e memória configuradas, sendo ideais para cargas de trabalho flutuantes. Crie um cluster ACS pelo console ou OpenAPI.

Console

Etapa 1: Abrir a página de criação de cluster

  1. Faça login no console do ACS. No painel de navegação à esquerda, clique em Clusters.

  2. Na página Clusters, clique em Create Kubernetes Cluster no canto superior esquerdo.

Etapa 2: Configurar o cluster

Na página Create Kubernetes Cluster, configure as definições do cluster, rede, componentes e opções avançadas.

Configurações do cluster

Parâmetro

Descrição

Cluster Name

Insira um nome para o cluster.

Region

Selecione a região do cluster. Supported regions.

Kubernetes Version

Selecione uma versão do Kubernetes suportada pelo ACS.

Maintenance Window

Janela de manutenção do cluster.

Configurações de rede

Parâmetro

Descrição

IPv6 Dual-stack

Ative um cluster dual-stack.

Nota

Se você selecionar Select Existing VPC , ative primeiro o IPv6 para a VPC e os vSwitches. Enable IPv6 for a VPC e Enable IPv6 for a vSwitch.

Select VPC

Configure a rede do cluster. Plan networks for ACS clusters.

Clusters ACS exigem uma VPC. Crie uma nova VPC ou utilize uma existente.

  • Create VPC

    O ACS cria uma VPC na região selecionada. Selecione uma Zone e o ACS criará um vSwitch nessa zona de disponibilidade.

  • Select Existing VPC

    Utilize uma VPC e um vSwitch existentes.

Para alta disponibilidade, selecione múltiplas zonas de disponibilidade ou vSwitches. O recurso Recommended Resource Configuration recomenda zonas com recursos suficientes para seu tipo de computação.

Nota

Em clusters ACS, os nós são virtuais. O ACS cria um nó virtual para cada zona de disponibilidade selecionada.

Configure SNAT

Define se deve ser criado um gateway NAT com regras SNAT para a VPC. Necessário para acesso à internet, como baixar imagens de contêiner.

Nota
  • Você também pode configurar manualmente um gateway NAT com regras SNAT. NAT Gateway.

  • Sem acesso à internet, envie as imagens para uma instância do ACR na mesma região e faça o pull pelo endpoint interno da VPC.

Security Group

Selecione um grupo de segurança básico ou avançado. Security group overview.

API Server Access Settings

Por padrão, uma instância privada de Classic Load Balancer (CLB) com pagamento conforme o uso é criada para o servidor de API. Pay-as-you-go.

Importante

Se você excluir a instância CLB padrão, não poderá mais acessar o servidor de API.

É possível configurar a opção Expose API server with EIP. O servidor de API expõe APIs RESTful para operações CRUD e watch em recursos como Pods e Services.

  • Ao selecionar Expose, o ACS cria um EIP e o associa à instância CLB. O servidor de API fica exposto na porta 6443 do EIP, permitindo acesso via internet pelo kubeconfig.

  • Ao selecionar Do not expose, nenhum EIP é criado. O cluster torna-se acessível apenas dentro da VPC via kubeconfig.

Control public access to the API server of a cluster.

Service CIDR

O bloco Service CIDR não deve sobrepor o CIDR da VPC, o CIDR dos Pods ou blocos CIDR de outros clusters na VPC. Não pode ser alterado após a criação.

Configurações de componentes

Parâmetro

Descrição

Expose API server with EIP

Define se a descoberta de serviços será ativada. Clusters ACS suportam CoreDNS.

O CoreDNS é o servidor DNS padrão do Kubernetes para resolução de nomes de serviços dentro do cluster.

Ingress

Opcional. Instale um componente Ingress para expor Services ao tráfego externo.

Componentes Ingress suportados:

  • ALB Ingress: Baseado no Application Load Balancer (ALB). Compatível com Nginx Ingress. Suporta roteamento complexo, descoberta automática de certificados e HTTP/HTTPS/QUIC para tráfego da Camada 7. ALB Ingress quick start.

  • MSE Ingress: MSE Cloud Native Gateway para gerenciamento avançado de tráfego de entrada. MSE Ingress Management.

Service Discovery

Os seguintes recursos de monitoramento são ativados por padrão:

Install metrics-server

Define se o Simple Log Service será utilizado. Crie um novo projeto ou use um existente.

Ativar este recurso também habilita cluster auditing e a coleta de logs do plano de controle.

Configurações avançadas

Clique em Log Service para definir as configurações avançadas.

Parâmetro

Descrição

Show Advanced Options

Ative a proteção contra exclusão para evitar a remoção acidental do cluster.

Deletion Protection

O ACS adiciona o cluster ao resource group selecionado. Um recurso pertence a apenas um grupo de recursos. Alinhe os grupos aos seus projetos, aplicações ou organizações.

Resource Group

Adicione uma tag ao cluster. A chave é obrigatória, deve ser única e pode ter até 64 caracteres. O valor é opcional e pode ter até 128 caracteres.

  • A chave e o valor não podem começar com aliyun, acs:, https:// ou http://. Não diferenciam maiúsculas de minúsculas.

  • As chaves de tag devem ser únicas por recurso. Uma chave duplicada sobrescreve a tag existente.

  • Máximo de 20 tags por recurso. Remova tags existentes antes de adicionar novas se o limite for atingido.

Labels

O time zone do cluster. Por padrão, o cluster utiliza o fuso horário do seu navegador.

Time Zone

Domínio local do cluster. Padrão: cluster.local. Nomes de domínio personalizados também são suportados.

O domínio do cluster é o sufixo para todos os nomes DNS de Service. Por exemplo, my-service no namespace padrão tem o nome DNS my-service.default.svc.cluster.local.

Etapa 3: Confirmar a configuração

  1. Após configurar o cluster, clique em Cluster Domain.

  2. Na caixa de diálogo, confirme a configuração e verifique se todas as verificações de dependência foram aprovadas.

  3. Leia e aceite os termos de serviço e clique em Confirm.

    Após a criação, visualize o cluster na página Create Cluster.

    Nota

    A criação de um cluster leva geralmente cerca de 10 minutos.

Operações relacionadas

  • Visualizar informações básicas do cluster

    Na página Clusters, localize o cluster e clique em Clusters na coluna Actions. Clique nas abas Details e Basic Information para ver detalhes do cluster, incluindo:

    • API server Connection Information: O endpoint público do servidor de API para gerenciar o cluster com kubectl.

      Os recursos Public Endpoint e Associate EIP estão disponíveis apenas para clusters gerenciados ACK.

      • Associar EIP: Selecione um EIP existente ou crie um novo.

        Associar um EIP reinicia brevemente o servidor de API. Evite operações no cluster durante esse período.

      • Desassociar EIP: Remove o acesso público à internet ao servidor de API.

        Desassociar um EIP reinicia brevemente o servidor de API. Evite operações no cluster durante esse período.

    • API server Unbind: O endpoint interno do servidor de API, acessível dentro da VPC do cluster. Este é o endereço do balanceador de carga.

  • Visualizar informações de log do cluster

    Clique na aba Internal Endpoint para visualizar os logs do cluster.

OpenAPI

API

O ACS é um tipo de cluster no Container Service for Kubernetes (ACK). Crie um cluster ACS chamando a API CreateCluster.

Debug

Debug CreateCluster.

Autorização

Informações de autorização para esta API. Utilize estes valores no elemento Action de uma política do RAM.

  • Action: A permissão específica.

  • Access level: O nível de acesso. Valores válidos: Write, Read e List.

  • Resource type: O tipo de recurso que suporta autorização. Detalhes abaixo:

    • Tipos de recursos obrigatórios são precedidos por um asterisco (*).

    • Para operações que não suportam autorização no nível de recurso, utilize All Resources.

  • Condition keys: As chaves de condição definidas pelo serviço cloud.

  • Dependent actions: Permissões adicionais necessárias para executar a ação.

Actions

Access level

Resource type

Condition keys

Dependent actions

cs:CreateCluster

create

*cluster

acs:cs:{#regionId}:{#accountId}:cluster/*

  • cs:ClusterType

  • cs:ClusterSpec

  • cs:ClusterProfile

  • cs:AddonNames

None

Sintaxe da requisição

POST /clusters HTTP/1.1

Parâmetros principais

Os parâmetros a seguir diferem de um cluster gerenciado ACK ao criar um cluster ACS:

Parâmetro

Descrição

Obrigatório

Combinação de parâmetros

region_id

Região do cluster. Supported regions.

Sim

Criar um cluster ACS

  • "region_id": "cn-hangzhou"

  • "cluster_type": "ManagedKubernetes"

  • "profile": "Acs"

  • "cluster_spec": "ack.pro.small"

  • "service_cidr": "192.168.xx.xx/16"

  • "kubernetes_version": "1.31.1-aliyun.1"

  • "vpcid": "vpc-j6cc1ddlp4rzs7v"

  • "vswitch_ids": ["vsw-j6cht66iul7h61x","vsw-j6c5ne6mxgnx3g5"]

  • "addons": [{"name": "alb-ingress-controller"}]

cluster_type

Tipo de cluster. Defina como ManagedKubernetes para clusters ACS.

Sim

profile

Subtipo de cluster. Defina como Acs para clusters ACS.

Sim

cluster_spec

Especificação do cluster. Defina como ack.pro.small para clusters ACS.

Sim

service_cidr

Bloco Service CIDR do cluster. Os blocos CIDR válidos são: 10.0.0.0/16-24, 172.16-31.0.0/16-24 ou 192.168.0.0/16-24.

Não deve sobrepor o CIDR da VPC ou blocos CIDR de clusters existentes na VPC. Não pode ser alterado após a criação. Plan networks for ACS clusters.

Sim

kubernetes_version

Versão do Kubernetes. Assume a versão mais recente se não especificada.

O console do ACS oferece as três versões mais recentes. Kubernetes version overview and mechanism.

Não

vpcid

VPC do cluster. Se omitido, o ACS cria uma VPC com três vSwitches em zonas recomendadas. Garanta cota de VPC suficiente na região.

Não

vswitch_ids

vSwitches do cluster. IPs dos Pods são alocados a partir dos vSwitches. Para alta disponibilidade, selecione vSwitches em zonas diferentes. Se nenhuma VPC for especificada, os vSwitches serão criados automaticamente.

Não

addons

Componentes a instalar com o parâmetro addons. Se omitido, apenas componentes principais e obrigatórios serão instalados.

Não

Exemplo de requisição

POST /clusters HTTP/1.1
<Common request headers>
{
    "name": "ACS-cluster",                     // Required. The cluster name.
    "cluster_type": "ManagedKubernetes",      // Required. The cluster type. 
    "profile": "Acs",                         // Required. The cluster subtype.       
    "cluster_spec": "ack.pro.small",          // Required. The cluster specification.
    "kubernetes_version": "1.31.1-aliyun.1",  // The cluster version. We recommend using the latest version.   
    "region_id": "cn-hangzhou",               // Required. The region of the cluster. This example uses China (Hangzhou).
    "vpcid": "vpc-j6cc1ddlp4rzs7v******",     // The VPC ID. It cannot be changed after the cluster is created.
    "service_cidr": "192.168.xx.xx/16",       // Required. The Service CIDR block for the cluster.
    "vswitch_ids": [                          // Select multiple vSwitches to ensure high availability.
        "vsw-j6cht66iul7h61x******",
        "vsw-j6c5ne6mxgnx3g5******"
    ],
    "addons": [                               // User components to install. 
    {
        "name": "alb-ingress-controller"
    }
}

Exemplo de requisição para criar um cluster ACS. CreateCluster.

Exemplos de resposta

Resposta bem-sucedida

{
  "cluster_id": "c54c8e4c703834c48bda53ae7841*****",
  "request_id": "08CCB494-7A82-5D51-907C-A6BF658*****",
  "task_id": "T-68007b2164acba01060*****",
  "instanceId": "c54c8e4c703834c48bda53ae7841*****"
}

Resposta de erro

{
  "code": "400",
  "message": "no ros component exists. clusterType: Kubernetes, version: ",
  "requestId": "7D99D268-F1E1-5ED8-B757-E5D38A0*****",
  "status": 400
}

Erro retornado devido a um parâmetro cluster_type incorreto:

Códigos de erro

Visite o Error Center para visualizar mais códigos de erro.

Referências

Cluster API reference.