Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Create an ACK One registered cluster

Última atualização: Oct 12, 2026

Um cluster registrado do ACK One permite conectar clusters Kubernetes de seus data centers ou de outros provedores de cloud ao console do Container Service for Kubernetes para gerenciamento unificado.

Importante

Antes de começar, leia Registered clusters para entender os conceitos principais e os casos de uso de um cluster registrado do ACK One.

Procedimento

Criar um cluster registrado do ACK One e anexar um cluster de destino no console

Criar um cluster registrado do ACK One

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

  2. No canto superior esquerdo da página, selecione o grupo de recursos e a região do recurso de destino. image

  3. Na página Clusters, clique em Create Kubernetes Cluster.

  4. Clique na aba ACK One Registered Cluster e siga as instruções na tela para configurar o cluster.

    Parâmetro

    Descrição

    Cluster Name

    Insira um nome personalizado para o cluster.

    Region

    A region onde os recursos do cluster, como instâncias ECS e discos em nuvem, estão localizados. Quanto mais próxima a região estiver dos seus usuários e da região de implantação dos recursos, menor será a latência de rede.

    IPv6 Dual-stack

    Este recurso está disponível apenas para Kubernetes 1.22 e versões posteriores e suporta somente Terway. Não pode ser usado com o elastic Remote Direct Memory Access (eRDMA) feature

    O cluster suporta os protocolos IPv4 e IPv6. No entanto, a comunicação entre os nós de trabalho e o plano de controle ainda usa endereços IPv4. Certifique-se de que:

    • A VPC do cluster suporte pilha dupla IPv6.

    • Ao usar Terway no modo ENI compartilhada, a instance type do nó deve suportar IPv6 e ter o mesmo número de endereços IPv4 e IPv6 suportados.

    VPC

    A Virtual Private Cloud (VPC) para o cluster. Para alta disponibilidade, selecione duas ou mais zonas diferentes.

    • Criação automática: O ACK cria um vSwitch correspondente em cada zona selecionada.

    • Usar existente: Selecione um vSwitch para especificar a zona do cluster. É possível criar um novo vSwitch ou usar um existente.

    Recomendamos usar blocos CIDR privados padrão para a VPC do cluster, como 10.0.0.0/8, 172.16.0.0/12 e 192.168.0.0/16. Se você tiver requisitos especiais, acesse o Quota Center para solicitar permissão para use a public CIDR block to create a cluster.

    Recursos de cloud e faturamento: imageVPC

    vSwitch

    Selecione um vSwitch existente na lista com base na zona ou clique em Create vSwitch para criar um novo. O plano de controle do cluster e o pool de nós padrão usarão o vSwitch especificado aqui. Recomendamos selecionar vSwitches em várias zonas diferentes para garantir alta disponibilidade do cluster.

    Security Group

    Ao usar uma VPC existente, você pode optar por Select Existing Security Group

    Este security group é aplicado ao plano de controle do cluster, ao pool de nós padrão e a quaisquer pools de nós que não tenham um grupo de segurança personalizado especificado.

    Em comparação com grupos de segurança básicos, os grupos de segurança avançados podem conter mais endereços IP privados, mas não suportam conectividade intra-grupo. Para mais informações, consulte Security group classification.

    • Criação automática: Todo o tráfego de saída é permitido por padrão. O tráfego de entrada é permitido com base no recommended configuration. Se você modificar as regras posteriormente, garanta que o bloco CIDR 100.64.0.0/10 seja permitido para tráfego de entrada.

      Este bloco CIDR é usado para acessar outros serviços da Alibaba Cloud para operações como baixar imagens e consultar informações básicas de ECS.
    • Usar existente: O ACK não configura regras de acesso adicionais para o grupo de segurança por padrão. Você deve gerenciar as regras do grupo de segurança por conta própria para evitar problemas de acesso. Para mais informações, consulte Configure cluster security groups.

    Access to API Server

    O ACK cria automaticamente uma instância de Classic Load Balancer (CLB) privada com pagamento conforme o uso como endpoint interno para o API Server. Esta instância CLB não pode ser reutilizada ou excluída. Se for excluída, o API Server ficará inacessível e não poderá ser recuperado.

    Para usar uma instância CLB existente, abra um ticket. Após selecionar Use Existing Gateway para VPC, você pode definir SLB Source como Use Existing Gateway.

    Você pode optar por ativar Expose API server with EIP.

    • Aberto: Vincula um EIP à instância CLB privada do API Server, permitindo que você acesse e gerencie o cluster pela rede pública.

      Isso não significa que os recursos dentro do cluster possam acessar a rede pública. Para permitir que os recursos do cluster acessem a rede pública, você deve selecionar Configure SNAT for VPC.
    • Não aberto: Você só pode se conectar e operar o cluster usando o arquivo kubeconfig de dentro da VPC.

    Para ativar isso posteriormente, consulte Access the API server over the internet.
    A partir de 1º de dezembro de 2024, novas instâncias CLB incorrerão em uma taxa de instância. Para mais informações, consulte Billing item adjustment for Classic Load Balancer (CLB).

    Recursos de cloud e faturamento: imageCLB, imageEIP

    Opções avançadas (opcional)

    Expanda Advanced Options (Optional) para configurar Proteção contra Exclusão, Grupo de Recursos e outras definições.

    Parâmetro

    Descrição

    Cluster Deletion Protection

    Recomendamos ativar este recurso para evitar a exclusão acidental do cluster pelo console ou OpenAPI.

    Resource Group

    Atribua o cluster ao resource group selecionado para facilitar o gerenciamento de permissões e a alocação de custos.

    Label

    Vincule tags chave-valor ao cluster para identificar recursos de cloud.

  5. Após concluir a configuração, clique em Create Kubernetes Cluster. O novo cluster aparece na lista de clusters.

    Depois que o cluster é criado, seu status é Waiting for Connection.

Anexar o cluster de destino a um cluster registrado do ACK One

  1. Localize o cluster registrado do ACK One recém-criado e clique em Details na coluna Actions.

  2. Na página Cluster Information, clique na aba Connection Information. Na aba Connection Information, selecione Internet ou Private Network e, em seguida, clique em Copy à direita.

  3. Salve o conteúdo copiado em um arquivo chamado agent.yaml. Em seguida, execute kubectl apply -f agent.yaml no cluster de destino para registrá-lo no cluster registrado do ACK One.

  4. Verifique o status do agente no cluster de destino.

    kubectl -n kube-system get pod |grep ack-cluster-agent

    Saída esperada:

    ack-cluster-agent-5f7d568f6-6fc4k              1/1     Running   0          9s
    ack-cluster-agent-5f7d568f6-tf6fp              1/1     Running   0          9s

    Após o registro ser bem-sucedido, o status do cluster muda para Running na página Clusters do console do Container Service for Kubernetes.

Resultados

Na página Clusters, localize o cluster registrado do ACK One correspondente e clique em Details na coluna Actions para visualizar as Basic Information e as Connection Information do novo cluster.

Use este kubeconfig para se conectar ao cluster de destino e implantar cargas de trabalho de aplicativos. Para mais informações sobre como se conectar a um cluster, consulte Connect to a Kubernetes cluster by using kubectl.

Usar onectl para criar um cluster registrado do ACK One e anexar um cluster de destino

  1. Instale e configure o onectl. Para mais informações, consulte Manage a registered cluster by using onectl.

  2. O onectl suporta os dois métodos a seguir para criar um cluster registrado do ACK One.

    Importante

    Ao criar um cluster registrado do ACK One, você deve especificar parâmetros como VPC, vSwitch e região.

    • Criação não interativa:

      onectl cluster create --region **** --vpc **** --vswitch ****
    • Criação interativa:

      onectl cluster create -i

    Execute o comando a seguir para visualizar descrições detalhadas dos parâmetros:

    onectl cluster create -h

    Após a criação do cluster, ele é inicializado e entra no estado initial. A saída esperada é a seguinte:

    Registered cluster test-registered-cluster created successfully, information of the cluster:
    name         = test-registered-cluster
    state        = initial
    cluster id   = c3c277f2fc10f45c1b86473**********
    region id    = cn-zhangjiakou
    node numbers = 0
    vpc id       = vpc-8vb95w2o172**********
    vswitch id   = vsw-8vbv8bxhput**********
  3. Depois que o cluster é inicializado, ele entra no estado waiting. Execute o comando a seguir para visualizar o estado do cluster:

    onectl cluster describe --cluster-id ****

    Saída esperada:

    name  = test-registered-cluster
    state = waiting
    ...
  4. Quando o cluster estiver no estado waiting, execute o comando a seguir para conectar o cluster de destino ao cluster registrado do ACK One.

    onectl cluster connect --cluster-id **** --kubeconfig ~/.kube/config --restricted true

    Parâmetro

    Obrigatório

    Descrição

    cluster-id

    Sim

    O ID do cluster registrado do ACK One criado em Step 2.

    kubeconfig

    Não

    O caminho para o arquivo kubeconfig do cluster de destino. Se você não especificar este parâmetro, o arquivo de configuração definido pela variável de ambiente KUBECONFIG será usado.

    restricted

    Não

    Especifica se deve se conectar ao cluster registrado do ACK One no modo restrito. Para mais informações, consulte RBAC permissions for the ack-cluster-agent component of a registered cluster.

    Você também pode executar o comando a seguir para visualizar descrições detalhadas dos parâmetros:

    onectl cluster connect -h
  5. Execute o comando a seguir para verificar se o cluster de destino está conectado:

    onectl cluster describe --cluster-id ****

    Saída esperada:

    name  = test-registered-cluster
    state = running
    ...

    Um estado running indica que o cluster registrado do ACK One foi conectado com sucesso.

Instruções

  1. Leia o inglês para entender O QUE precisa ser comunicado

  2. Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês

  3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

  4. Placeholders xref ({XREF_N}) — copie literalmente, NÃO traduza ou modifique

  5. Aplique todas as regras específicas do idioma rigorosamente

  6. Aplique as regras de stopwords com tolerância zero

  7. Use o modo imperativo em etapas numeradas e listas de procedimentos

  8. Garanta consistência terminológica — mesmo termo = mesma tradução em todo lugar

  9. Varie os inícios de frase em listas/tabelas — nenhum início repetido mais de 3 vezes

  10. Retorne APENAS o documento markdown em português brasileiro, sem explicações