Add existing ECS instances to a node pool as ACK worker nodes - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Adicione instâncias ECS existentes como nós de trabalho ou readicione nós removidos para reutilizar recursos de computação sem interromper as cargas de trabalho.

O ACK oferece os modos automático e manual para adicionar nós. O método de faturamento e o tipo de instância permanecem inalterados após a adição de uma instância.

Item

Modo automático

Modo manual

Redefinição do SO

Redefine e inicializa o SO com base na configuração do node pool.

O disco do sistema é liberado e seus dados são perdidos.
O sistema mantém os snapshots manuais do disco do sistema. A retenção de snapshots automáticos depende de a configuração Delete Automatic Snapshots While Releasing Disk estar ativada.

Acesse o console do ECS, ative a opção Delete Automatic Snapshots While Releasing Disk e consulte Set the 'Delete Automatic Snapshots While Releasing Disk' attribute.
O sistema mantém o disco de dados e preserva seus dados, mas o ID do disco muda.

Preserva o SO original para maior flexibilidade.

Casos de uso

Ideal para quando você deseja que a configuração da instância corresponda ao node pool, garantindo que você gerencie de forma padronizada.

Recomendado quando é necessário preservar o SO da instância ou configurações específicas.

Limitações

Certifique-se de que seu ambiente e suas instâncias atendam a estes requisitos.

Categoria	Item	Descrição
Instância e node pool	Cota de nós do cluster	Os nós do cluster não podem exceder a cota. Para aumentar a cota, acesse o Quota Center. A cota padrão de nós para um cluster ACK Basic é 10.
	Propriedade da instância	A instância e o cluster devem estar na mesma conta Alibaba Cloud, região e VPC. Caso contrário, migre a instância ou crie uma instância ou cluster que atenda aos requisitos. Não é possível adicionar uma instância ECS a partir da outra extremidade de uma conexão de peering de VPC.
	Propriedade do cluster	Não é possível adicionar uma instância que pertence a outro cluster ACK. Primeiro, remova o nó do cluster original e, em seguida, adicione-a ao novo cluster.
	Propriedade do grupo de dimensionamento (ESS)	Não é possível adicionar uma instância que pertence a outro grupo de dimensionamento. Primeiro, remova-o do grupo de dimensionamento.
	Tipo de node pool	Não é possível adicionar nós existentes a um node pool do modo automático. Não é possível adicionar nós existentes a um node pool com o Auto Scaling ativado. Após adicionar um nó existente, não é possível ativar o dimensionamento automático para esse node pool.
	Sistema operacional	O swap deve estar desativado no sistema operacional. No modo manual, não é possível adicionar instâncias que executam Windows ou ContainerOS. Consulte Sistemas operacionais.
	Tipo de instância	A instância não pode ser um tipo de instância ECS sem suporte. Para instâncias GPU ECS Bare Metal (famílias de instâncias ECS ebmgn7 e ebmgn7e), a limpeza automática de GPU de múltiplas instâncias (MIG) não tem suporte. Ao adicionar esse tipo de instância, as configurações de MIG são redefinidas. Essa redefinição pode levar muito tempo e causar falha na adição automática do nó. Para solução de problemas, consulte What do I do if I fail to add a bare metal instance node?.
Rede	Acesso ao API Server	O endereço IP da instância deve estar na lista de permissões de acesso ao API Server. Caso contrário, o nó não poderá se comunicar com o plano de controle. Consulte Configurar o controle de acesso para o API Server.
	Grupo de segurança	Consistência de tipo: o tipo de grupo de segurança da instância (básico ou corporativo) deve corresponder ao do node pool. Compatibilidade de regras: o grupo de segurança da instância deve permitir o acesso ao endpoint interno do API Server na porta 6443, e suas regras não devem entrar em conflito com as regras do grupo de segurança do cluster ou do node pool. Encontre o endpoint interno do API Server na aba Basic Information da página Cluster Information. Cota: uma instância não pode participar de mais grupos de segurança do que a cota de grupos de segurança permite. Para alterar o tipo de grupo de segurança de uma instância ou adicionar uma instância ao grupo de segurança do node pool antecipadamente, consulte Associar um grupo de segurança a uma instância (ENI primária). Para aumentar a cota de grupos de segurança, consulte Visualizar ou aumentar as cotas do ECS.
	Terway - Máximo de pods	O número máximo de pods suportados pela instância deve atender a estes requisitos: O limite de pods suportados em diferentes modos de interface de rede elástica (ENI) depende do limite de ENIs que o tipo de instância suporta. Para calcular esse limite, consulte Como calcular a cota de pods para um nó. Para o modo de ENI compartilhada, o máximo de pods suportados deve ser superior a 10. Para o modo de ENI exclusiva, o máximo de pods suportados deve ser superior a 5. Se o requisito não for atendido, faça upgrade ou downgrade dos recursos do nó ou compre uma nova instância.
	Terway - Configuração de vSwitch	Se a instância e o node pool estiverem em zonas de disponibilidade diferentes, atualize a configuração do vSwitch do Terway. Caso contrário, o Terway aloca endereços IP de pods a partir do vSwitch da ENI primária, o que pode causar erros de alocação de IP de pods. Consulte Modificar os vSwitches de pod.
	Terway - ENI	Ao adicionar a instância, o sistema mantém as ENIs vinculadas e aloca os endereços IP dos pods a partir dos vSwitches associados a essas ENIs. Certifique-se de que a instância tenha apenas uma ENI primária. Se um endereço IP de pod não pertencer a um vSwitch configurado, remova o nó do cluster, exclua todas as ENIs secundárias e adicione o nó novamente.
	Terway - Função RAM do Worker	A instância deve estar vinculada à função RAM do Worker do node pool para evitar problemas de permissão que causem cálculos incorretos de MaxPod. Na página Node Pools, clique no nome de um node pool para visualizar sua função RAM do Worker na aba Basic Information. Para conceder a função RAM, consulte Conceder uma função RAM a uma instância ECS.
	Terway - Pilha dupla IPv6	Se a pilha dupla IPv6 estiver ativada para o cluster, atribua um endereço IPv6 à ENI primária da instância. Consulte Comunicação IPv6.
	Flannel	As entradas de rota personalizadas na tabela de rotas do sistema da VPC do cluster não podem exceder a cota da tabela de rotas. Para aumentar a cota, acesse o Quota Center.

Notas de uso

Backup de dados: antes de começar, crie um snapshot manual dos discos do sistema e de dados para evitar perda de dados.

Para garantir cota de snapshots suficiente, exclua snapshots manuais e automáticos desnecessários para evitar falhas na criação.
Liberação e faturamento de instâncias: para node pools sem a contagem esperada de nós ativada, o sistema não libera as instâncias adicionadas ao node pool quando você exclui o cluster ou o node pool. Você deve remover os nós manualmente. Monitore o faturamento do ECS para evitar cobranças inesperadas.

Procedimento

Tempo necessário: a adição do nó, incluindo a substituição do disco do sistema (apenas no modo automático) e a inicialização do nó, leva cerca de 5 minutos. O tempo real varia de acordo com as condições de rede, o tamanho da imagem do SO e outros fatores.

A adição de um nó existente não afeta os nós ou aplicativos atuais no cluster. Não inicialize uma instância ECS que já executa serviços como um nó de trabalho para evitar problemas de compatibilidade.

Acesse o ACK console. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Nodes > Node Pools.
Na página Node Pools, localize o node pool de destino, clique em na coluna Actions e, em seguida, clique em Add Existing Node.

Se a instância ECS de destino não estiver na lista de servidores, ela não atende aos requisitos para adição ao cluster. Selecione Show Unavailable Instances e visualize as instâncias ECS indisponíveis e os motivos. Consulte Limitações e Notas de uso .
Leia as notas na tela e selecione um método para adicionar o nó.

Adição manual

Obtenha um comando de instalação e execute-o na instância de destino. Adicione apenas uma instância ECS por vez.

Na página, defina Method como Manual e selecione a instância ECS a ser adicionada na lista de servidores cloud existentes e clique em Next.

Na página Specify Instance Information, confirme os detalhes do cluster e da instância, configure o disco de dados e o nome da instância e clique em Next.

Parâmetro	Descrição
Data Disk	Para o disco de dados, especifique se os dados de contêineres e imagens devem ser armazenados em um disco de dados, o que separa o disco do sistema dos discos de dados para melhorar a estabilidade. Se a instância ECS tiver um disco de dados anexado e o sistema de arquivos do último disco de dados não estiver inicializado, o ACK formata automaticamente o último disco de dados como ext4. O disco armazena dados exclusivamente em /var/lib/containerd ou /var/lib/docker (diretórios padrão de runtime de contêineres) e /var/lib/kubelet (diretório padrão do kubelet). Importante A formatação apaga os dados existentes no disco de dados. Crie um snapshot para fazer backup dos seus dados antes. Se você armazenar contêineres e imagens em um disco de dados, há suporte apenas para os sistemas de arquivos ext4 e xfs. Se a instância ECS não tiver um disco de dados anexado, o ACK não anexa um novo disco de dados, independentemente de você selecionar esta opção.
Retain Instance Name	Ativado: usa o nome da instância como o nome do nó. Desativado: o ACK renomeia o nó com base em regras personalizadas de nomenclatura de nós.

Na página Complete, copie o comando de ingresso do nó gerado pelo ACK e clique em Finish.
Acesse o console do ECS. No painel de navegação à esquerda, escolha Instances & Images > Instance e selecione a região do cluster e a instância de destino.
Clique em Connect para a instância de destino e selecione um método de conexão remota.
Insira e execute o script que você copiou na etapa 3 para configurar e adicionar a instância ao cluster.

Após a execução bem-sucedida do script, o sistema exibe uma mensagem de sucesso. Na lista de nós, aguarde o status do novo nó mudar para Ready.
```
Worker node joined successfully
+ exit_code=0
+ set +x
```

Adição automática

Adicione instâncias automaticamente pelo console.

Na página, defina Method como Auto e selecione as instâncias ECS a serem adicionadas na lista de servidores cloud existentes e clique em Next.

Na página Specify Instance Information, confirme os detalhes do cluster e da instância, configure o disco de dados e o nome da instância e clique em Next.

Parâmetro	Descrição
Data Disk	Para o disco de dados, especifique se os dados de contêineres e imagens devem ser armazenados em um disco de dados, o que separa o disco do sistema dos discos de dados para melhorar a estabilidade. Se a instância ECS tiver um disco de dados anexado e o sistema de arquivos do último disco de dados não estiver inicializado, o ACK formata automaticamente o último disco de dados como ext4. O disco armazena dados exclusivamente em /var/lib/containerd ou /var/lib/docker (diretórios padrão de runtime de contêineres) e /var/lib/kubelet (diretório padrão do kubelet). Importante A formatação apaga os dados existentes no disco de dados. Crie um snapshot para fazer backup dos seus dados antes. Se você armazenar contêineres e imagens em um disco de dados, há suporte apenas para os sistemas de arquivos ext4 e xfs. Se a instância ECS não tiver um disco de dados anexado, o ACK não anexa um novo disco de dados, independentemente de você selecionar esta opção.
Método de login e senha	Se o Logon Type do node pool estiver definido como Password, redefina a senha da instância.
Retain Instance Name	Ativado: usa o nome da instância como o nome do nó. Desativado: o ACK renomeia o nó com base em regras personalizadas de nomenclatura de nós.

Na caixa de diálogo, leia as notas e clique em OK.

Após adicionar o nó, aguarde a inicialização na lista de nós até que o status mude para Ready.

Perguntas frequentes

A adição de nós afeta as cargas de trabalho?

Adicionar um nó existente no modo manual ou automático não afeta as cargas de trabalho existentes no cluster.

Como o dimensionamento de instâncias afeta as cargas de trabalho?

Fazer upgrade ou downgrade de uma instância ECS pode alterar o tipo de instância, o método de faturamento de largura de banda pública, a largura de banda pública ou o método de faturamento do disco de dados. Consulte Visão geral das alterações de configuração da instância. O impacto varia de acordo com o método de upgrade ou downgrade.

Operações que não exigem reinicialização: o impacto depende do seu cenário.
Operações que exigem reinicialização da instância ECS: operações como upgrade ou downgrade do tipo de instância causam interrupções no serviço. Antes de realizar essa operação, como fazer upgrade ou downgrade dos recursos do nó, verifique a carga de trabalho atual para determinar se você precisa de nós redundantes para assumir os pods. Em seguida, drene o nó para fazer o upgrade ou downgrade e remova-o do grupo de dimensionamento e do cluster ACK. Consulte Remover nós.

Após a conclusão do upgrade ou downgrade, adicione o nó de volta ao cluster seguindo este tópico.

Posso usar tipos de instância diferentes?

Sim. O ACK permite gerenciar nós de vários tipos de instância no mesmo node pool, o que evita falhas de scale-out causadas por indisponibilidade de tipo de instância ou estoque insuficiente. Antes de adicionar uma instância ECS, certifique-se de que seu tipo de instância esteja na lista de tipos de instância do node pool. Siga estas etapas:

Edite ou crie um node pool e configure os tipos de instância de nó necessários. Consulte Crie e gerencie um node pool.
Drene e remova o nó de destino. Não libere a instância ECS. Consulte Remover nós.
Adicione instâncias ECS de tipos de instância diferentes ao node pool seguindo as seções Limitações e Procedimento neste tópico.

Como mover nós entre clusters?

O ACK não oferece suporte para mover nós diretamente entre clusters. Em vez disso, adicione um nó existente. Siga estas etapas:

Drene e remova o nó de destino do cluster de origem. Não libere a instância ECS. Consulte Remover nós.
Adicione a instância ECS de destino a um node pool no cluster de destino seguindo as seções Limitações e Procedimento neste tópico.

Posso adicionar um nó com um SO em fim de vida útil (EOL)?

Modo manual: você pode adicionar uma instância existente que executa um SO sem suporte a um node pool, mas certifique-se de que a versão do SO da instância seja compatível com a versão atual do cluster. Consulte Sistemas operacionais.

Por exemplo, o CentOS 7 e o Alibaba Cloud Linux 2 têm suporte apenas em clusters da versão 1.30 e anteriores.
Modo automático: o ACK inicializa a instância usando a imagem do SO especificada na configuração do node pool.

Os dados do usuário são sobrescritos ao adicionar nós?

A sobrescrita dos dados do usuário originais da instância depende do método de adição.

Modo automático: o ACK inicializa o disco do sistema, sobrescrevendo os dados do usuário originais da instância com os dados do usuário configurados para o node pool.
Modo manual: o sistema não sobrescreve os dados do usuário originais da instância. Após a instância ingressar no node pool, ela continua a usar seus dados do usuário originais.

Como corrigir tempos limite na adição de nós?

Verifique a conectividade de rede entre o nó e o API Server CLB. Primeiro, verifique se o grupo de segurança atende aos requisitos. Para limitações de grupos de segurança ao adicionar um nó existente, consulte Limitações. Para outros problemas de conectividade de rede, consulte Perguntas frequentes sobre gerenciamento de rede.

A adição de um nó altera a contagem esperada?

Sim. Após adicionar um nó existente, a contagem de Expected Nodes aumenta de acordo com o número de nós adicionados. Por exemplo, se Expected Nodes estiver definido como 5 e você adicionar uma instância ECS, a contagem passará a ser 6.

Referências

Além do console, adicione instâncias ECS a um cluster ACK chamando uma operação de API (Obter o script para adicionar nós existentes a um node pool) ou executando um comando CLI (Adicionar instâncias ECS existentes).
Clusters mais antigos, criados antes do recurso de node pool, podem conter nós livres (nós que não estão em nenhum node pool). Migre-os para um node pool para gerenciamento centralizado. Consulte Migrar nós livres para um node pool.
Se um nó, pod ou outro componente não estiver funcionando conforme o esperado, solucione o problema. Consulte Solucionar problemas de exceções de nó, Solucionar problemas de exceções de pod e Perguntas frequentes sobre nós e node pools.