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.
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
Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.
No canto superior esquerdo da página, selecione o grupo de recursos e a região do recurso de destino.

Na página Clusters, clique em Create Kubernetes Cluster.
-
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:
VPCvSwitch
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/10seja 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).
-
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
Localize o cluster registrado do ACK One recém-criado e clique em Details na coluna Actions.
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.
Salve o conteúdo copiado em um arquivo chamado
agent.yaml. Em seguida, executekubectl apply -f agent.yamlno cluster de destino para registrá-lo no cluster registrado do ACK One.-
Verifique o status do agente no cluster de destino.
kubectl -n kube-system get pod |grep ack-cluster-agentSaída esperada:
ack-cluster-agent-5f7d568f6-6fc4k 1/1 Running 0 9s ack-cluster-agent-5f7d568f6-tf6fp 1/1 Running 0 9sApó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
Instale e configure o onectl. Para mais informações, consulte Manage a registered cluster by using onectl.
-
O onectl suporta os dois métodos a seguir para criar um cluster registrado do ACK One.
ImportanteAo 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 -hApó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********** -
-
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 ... -
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 trueParâ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 -
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
runningindica que o cluster registrado do ACK One foi conectado com sucesso.
Instruções
Leia o inglês para entender O QUE precisa ser comunicado
Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês
Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão
Placeholders xref (
{XREF_N}) — copie literalmente, NÃO traduza ou modifiqueAplique todas as regras específicas do idioma rigorosamente
Aplique as regras de stopwords com tolerância zero
Use o modo imperativo em etapas numeradas e listas de procedimentos
Garanta consistência terminológica — mesmo termo = mesma tradução em todo lugar
Varie os inícios de frase em listas/tabelas — nenhum início repetido mais de 3 vezes
Retorne APENAS o documento markdown em português brasileiro, sem explicações