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 computacionais sem interromper cargas de trabalho.

O ACK oferece 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 da instância.

Item

Modo automático

Modo manual

Redefinição do SO

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

O disco do sistema é liberado e seus dados são perdidos.
Snapshots manuais do disco do sistema são mantidos. A retenção de snapshots automáticos depende da configuração Delete Automatic Snapshots While Releasing Disk.

Para definir essa configuração, faça login no ECS console e consulte Set the 'Delete Automatic Snapshots While Releasing Disk' attribute.
O disco de dados é mantido e seus dados preservados, mas o ID do disco muda.

Preserva o sistema operacional original para maior flexibilidade.

Casos de uso

Ideal para alinhar a configuração da instância ao node pool e garantir gerenciamento padronizado.

Necessário quando se deve preservar o SO da instância ou configurações específicas.

Limitações

Verifique se seu ambiente e suas instâncias atendem aos requisitos abaixo.

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 pertencer à 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 localizada na outra extremidade de uma conexão de peering de VPC.
	Propriedade do cluster	Não é permitido adicionar uma instância que pertença a outro cluster ACK. Primeiro remova o nó do cluster original e depois adicione-o ao novo cluster.
	Propriedade do grupo de dimensionamento (ESS)	Não é possível adicionar uma instância pertencente a outro grupo de dimensionamento. É necessário primeiro removê-la do grupo de dimensionamento.
	Tipo de node pool	Não é possível adicionar nós existentes a um node pool em Modo Automático. Também não há suporte para adicionar nós existentes a um node pool com auto scaling habilitado. Após adicionar um nó existente, não será mais possível ativar o auto scaling nesse node pool.
	Sistema operacional	O swap deve estar desativado no sistema operacional. No modo manual, instâncias executando Windows ou ContainerOS não são aceitas. Consulte Operating systems.
	Tipo de instância	A instância não pode ser um tipo de instância ECS não suportado. Para instâncias GPU Bare Metal ECS (famílias de instâncias ECS ebmgn7 e ebmgn7e), a limpeza automática de Multi-Instance GPU (MIG) não é suportada. 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 constar na lista de permissões de acesso ao API Server. Caso contrário, o nó não conseguirá se comunicar com o plano de controle. Consulte Configure access control for the API Server.
	Grupo de segurança	Consistência de tipo: O tipo de grupo de segurança da instância (básico ou empresarial) deve corresponder ao do node pool. Compatibilidade de regras: O grupo de segurança da instância deve permitir acesso ao endpoint interno do API Server na porta 6443, e suas regras não podem 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 ingressar em 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 antecipadamente uma instância ao grupo de segurança do node pool, consulte Associate a security group with an instance (primary ENI). Para aumentar a cota de grupos de segurança, veja View or increase ECS quotas.
	Terway - Máximo de pods	O número máximo de pods suportado pela instância deve atender a estes requisitos: O limite máximo de pods varia conforme o modo de elastic network interface (ENI) e depende do número máximo de ENIs suportadas pelo tipo de instância. Para calcular esse limite, consulte How to calculate the pod quota for a node. No modo ENI compartilhado, o máximo de pods suportados deve ser superior a 10. No modo ENI exclusivo, o máximo de pods suportados deve ultrapassar 5. Se o requisito não for atendido, atualize ou reduza os recursos do nó ou adquira 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 de vSwitch do Terway. Caso contrário, o Terway alocará endereços IP de pods a partir do vSwitch da ENI primária, o que pode gerar erros na alocação de IPs. Consulte Modify pod vSwitches.
	Terway - ENI	Ao adicionar a instância, as ENIs vinculadas a ela são mantidas, e os endereços IP dos pods são alocados a partir dos vSwitches associados a essas ENIs. Certifique-se de que a instância possua 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 de Worker	A instância deve estar vinculada à função RAM de Worker do node pool para evitar problemas de permissão que possam causar cálculo incorreto de MaxPod. Na página Node Pools, clique em no nome de um node pool para visualizar sua função RAM de Worker na aba Basic Information. Para conceder a função RAM, consulte Grant a RAM role to an ECS instance.
	Terway - Pilha dupla IPv6	Se a pilha dupla IPv6 estiver habilitada no cluster, atribua um endereço IPv6 à ENI primária da instância. Consulte IPv6 communication.
	Flannel	As entradas de rota personalizadas na tabela de rotas do sistema da VPC do cluster não podem exceder a cota de tabelas de rotas. Para aumentar a cota, acesse o Quota Center.

Observações de uso

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

Para garantir cota de snapshots suficiente, exclua snapshots manuais e automáticos desnecessários e evite falhas na criação.
Liberação de instância e faturamento: Em node pools sem contagem esperada de nós habilitada, as instâncias adicionadas não são liberadas quando você exclui o cluster ou o node pool. É necessário 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 conforme as condições da rede, o tamanho da imagem do SO e outros fatores.

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

Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique em 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 desejado, clique em na coluna Actions e, em seguida, clique em Add Existing Node.

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

Adição manual

Obtenha um comando de instalação e execute-o na instância alvo. Só é possível adicionar uma instância ECS por vez.

Defina Method como Manual. Selecione a instância ECS a ser adicionada na lista de servidores em nuvem 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	Define se os dados de contêineres e imagens serão armazenados em um disco de dados, separando 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 esse último disco como ext4. O disco armazena dados exclusivamente em /var/lib/containerd ou /var/lib/docker (diretórios padrão de runtime de contêiner) 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 de prosseguir. Caso opte por armazenar contêineres e imagens em um disco de dados, apenas os sistemas de arquivos ext4 e xfs são suportados. Se a instância ECS não possuir nenhum disco de dados anexado, o ACK não anexará um novo disco de dados, independentemente desta opção estar selecionada ou não.
Retain Instance Name	Ativado: Utiliza o nome da instância como 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.
Faça login no ECS console. No painel de navegação à esquerda, escolha Instances & Images > Instance. Selecione a região do cluster e a instância alvo.
Clique em Connect para a instância alvo e selecione um método de conexão remota.
Insira e execute o script copiado na etapa 3 para configurar e adicionar a instância ao cluster.

Após a execução bem-sucedida do script, uma mensagem de sucesso será exibida. Na lista de nós, aguarde até que o status do novo nó mude para Ready.
```
Worker node joined successfully
+ exit_code=0
+ set +x
```

Adição automática

Adicione instâncias automaticamente pelo console.

Defina Method como Auto. Selecione as instâncias ECS a serem adicionadas na lista de servidores em nuvem 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	Define se os dados de contêineres e imagens serão armazenados em um disco de dados, separando 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 esse último disco como ext4. O disco armazena dados exclusivamente em /var/lib/containerd ou /var/lib/docker (diretórios padrão de runtime de contêiner) 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 de prosseguir. Caso opte por armazenar contêineres e imagens em um disco de dados, apenas os sistemas de arquivos ext4 e xfs são suportados. Se a instância ECS não possuir nenhum disco de dados anexado, o ACK não anexará um novo disco de dados, independentemente desta opção estar selecionada ou nã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: Utiliza o nome da instância como 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 a adição do nó, aguarde sua 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 nos modos manual ou automático não impacta as cargas de trabalho atuais do cluster.

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

Atualizar ou reduzir uma instância ECS pode alterar o tipo de instância, o método de faturamento de largura de banda pública, a própria largura de banda pública ou o método de faturamento do disco de dados. Consulte Overview of instance configuration changes. O impacto varia de acordo com o método de atualização ou redução escolhido.

Operações sem necessidade de reinicialização: O impacto depende do seu cenário específico.
Operações que exigem reinicialização da instância ECS: Ações como atualizar ou reduzir o tipo de instância causam interrupções no serviço. Antes de executar tal operação, como atualizar ou reduzir recursos do nó, verifique a carga de trabalho atual para determinar se são necessários nós redundantes para assumir os pods. Em seguida, drene o nó a ser atualizado ou reduzido e remova-o do grupo de dimensionamento e do cluster ACK. Consulte Remove nodes.

Depois que a atualização ou redução for concluída, adicione o nó de volta ao cluster seguindo as instruções deste tópico.

Posso usar tipos de instância diferentes?

Sim. O ACK permite gerenciar nós de múltiplos tipos de instância no mesmo node pool, evitando 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 do node pool. Siga estas etapas:

Edite ou crie um node pool e configure os tipos de instância de nó necessários. Consulte Create and manage a node pool.
Drene e remova o nó alvo. Não libere a instância ECS. Consulte Remove nodes.
Adicione instâncias ECS de diferentes tipos ao node pool seguindo as seções Limitações e Procedimento deste tópico.

Como mover nós entre clusters?

O ACK não suporta a movimentação direta de nós entre clusters. Em vez disso, adicione um nó existente. Siga estas etapas:

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

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

Modo manual: É possível adicionar uma instância existente executando um SO não suportado a um node pool, desde que a versão do SO da instância seja compatível com a versão atual do cluster. Consulte Operating systems.

Por exemplo, CentOS 7 e Alibaba Cloud Linux 2 são suportados apenas em clusters da versão 1,30 e anteriores.
Modo automático: O ACK inicializa a instância usando a imagem de SO especificada na configuração do node pool.

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

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

Modo automático: O ACK inicializa o disco do sistema, sobrescrevendo os dados originais do usuário da instância com os dados do usuário configurados para o node pool.
Modo manual: Os dados originais do usuário da instância não são sobrescritos. Após ingressar no node pool, a instância continua utilizando seus dados de 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, confirme 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, veja Network management FAQ.

Adicionar um nó altera a contagem esperada?

Sim. Após adicionar um nó existente, a contagem de Expected Nodes aumenta conforme 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 (Obtain the script for adding existing nodes to a node pool) ou executando um comando CLI (Add existing ECS instances).
Clusters mais antigos, criados antes do recurso de node pool, podem conter nós livres (nós que não pertencem a nenhum node pool). Migre-os para um node pool visando o gerenciamento centralizado. Consulte Migrate free nodes to a node pool.
Se um nó, pod ou outro componente não estiver funcionando conforme o esperado, solucione o problema. Consulte Troubleshoot node exceptions, Troubleshoot pod exceptions e FAQ about nodes and node pools.