Crie e gerencie pools de nós - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Um pool de nós agrupa nós que compartilham a mesma configuração, como tipos de instância, zonas, sistemas operacionais, rótulos e taints, permitindo que você os gerencie de uma só vez. Um cluster pode ter vários pools de nós com diferentes configurações e tipos, e a alteração em um nunca afeta os nós ou aplicações em outro.

Antes de criar um pool de nós, leia Connect to cloud-based ECS computing resources para entender os conceitos básicos, casos de uso, recursos relacionados e faturamento.

Limitações

Os seguintes parâmetros não podem ser modificados após a criação de um pool de nós:

Parâmetro	Restrição
Region	Fixada na região do cluster
VPC	Fixada na virtual private cloud (VPC) do cluster
Security hardening	Não pode ser alterado após a criação do cluster
Billing method	Não é possível alternar entre instâncias spot e pagamento conforme o uso ou assinatura
Custom security group	O tipo (básico ou avançado) não pode ser alterado após a criação

Pré-requisitos

Antes de começar, certifique-se de ter:

Um ACK One registered cluster com um cluster Kubernetes externo (implantado em um data center on-premises) conectado a ele
Conectividade de rede entre o cluster Kubernetes externo e a VPC do cluster registrado do ACK One (consulte Scenario-based networking for VPC connections)
Configuração de proxy do cluster Kubernetes externo importada para o cluster registrado do ACK One no modo de rede privada (consulte Associate an external Kubernetes cluster with an ACK One registered cluster)
O componente cloud-node-controller instalado
Um cluster Kubernetes autogerenciado criado com kubeadm, executando a versão 1.26, 1.28, 1.30, 1.31 ou superior

Se a versão do seu cluster não atender ao requisito acima, crie um script personalizado para o pool de nós antes de prosseguir.

Acesse os pools de nós

Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique em o nome do cluster de destino. No painel de navegação à esquerda, escolha Nodes > Node Pools.

Crie um pool de nós

Configure o pool de nós no ACK console, incluindo as configurações básicas, de rede, de instância, de imagem, de armazenamento e de dimensionamento.

Nas tabelas a seguir, a coluna Changeable indica se um parâmetro pode ser modificado após a criação do pool de nós: Supported indica que o parâmetro pode ser modificado, e Not supported indica que não pode.

Na página Node Pools, clique em Create Node Pool.
Na caixa de diálogo Create Node Pool, configure os parâmetros descritos nas seções a seguir.
Clique em Confirm.

Após clicar em Confirm, a lista de pools de nós exibe o novo pool com o status Initializing enquanto ele está sendo criado. Quando a criação é bem-sucedida, o status muda para Active.

Na página de confirmação, clique em Console-to-Code no canto inferior esquerdo para obter o código de exemplo do Terraform ou SDK correspondente à configuração do seu pool de nós.

Configurações básicas

Configurações de rede

Parâmetro	Descrição	Alterável
Node pool name	Um nome para o pool de nós.
Region	Pré-selecionada com base na região do cluster. Não pode ser alterada.
Scaling mode	Manual ou Auto. Os dois modos permitem ajustar os recursos de computação para atender aos requisitos e políticas de negócios, o que reduz os custos do cluster. - Manual: mantém o número exato de nós que você especifica em Expected number of nodes. Consulte Manually scale a node pool.- Auto: dimensiona quando a demanda de agendamento de pods excede a capacidade do cluster, com base nas contagens mínima e máxima de instâncias configuradas. Clusters executando Kubernetes 1.24 ou posterior usam dimensionamento instantâneo de nós por padrão; versões anteriores usam dimensionamento automático de nós. Consulte Node scaling.

Parâmetro	Descrição	Alterável
VPC	Pré-selecionada como a VPC do cluster. Não pode ser alterada.
vSwitch	Determina as zonas onde os novos nós são criados durante o scale-out, com base na Scaling policy que você escolha. Selecione vSwitches nas zonas de destino. Se nenhum vSwitch estiver disponível, clique em Create vSwitch. Consulte Crie e gerencie vSwitches.

Configurações de instância e imagem

Configurações de armazenamento

Parâmetro	Descrição	Alterável
Billing method	O método de faturamento para instâncias ECS adicionadas ao pool de nós: Pay-As-You-Go, Subscription ou Spot Instance. - Subscription: configure Duration e, opcionalmente, ative Auto renewal. - Spot Instance: Apenas instâncias spot com período de proteção são suportadas. Você também deve configurar Upper Price Limit of Current Instance Spec. Após o período de proteção (1 hora), o sistema verifica o preço spot e a disponibilidade de recursos a cada 5 minutos. Se o preço em tempo real exceder seu lance ou o estoque for insuficiente, a instância é liberada. Consulte Best practices for spot instance-based node pools. Importante As alterações no método de faturamento aplicam-se apenas aos nós recém-adicionados. Os nós existentes mantêm seu método de faturamento original. Para alterar o método de faturamento de um nó existente, consulte Change the billing method from pay-as-you-go to subscription. Você não pode alternar entre instâncias spot e faturamento por uso ou assinatura. Os pools de nós com imagem de contêiner habilitada para Trusted Execution Environment (TEE) (usando instâncias da série ecs.g7t) não suportam alterações no método de faturamento. Essas alterações retornam o erro `InvalidImageType.TEE.NotSupported`. Para usar o faturamento Subscription, crie um novo pool de nós Subscription que não use uma imagem habilitada para TEE.
Instance type	Selecione um ou mais tipos de instância ECS para nós de trabalho. Filtre por vCPU, memória, família de instâncias e arquitetura. Selecionar vários tipos de instância melhora as taxas de sucesso do scale-out. Se o scale-out falhar devido a tipos de instância indisponíveis, adicione mais tipos ao pool. Consulte ECS specification recommendations for ACK clusters e check the scalability of the node pool.
Operating system	Public image ou Custom image. - Public image: Imagem otimizada para contêineres do Alibaba Cloud Linux 3, ContainerOS, Alibaba Cloud Linux 3 ou Ubuntu. Consulte Operating systems. - Custom image: use uma imagem de sistema operacional personalizada. Consulte Como crie uma imagem personalizada com base em uma instância ECS existente e a use para crie nós? A Imagem do Alibaba Cloud Marketplace está em lançamento gradual. Para atualize ou alterar o sistema operacional, consulte Change the OS.
Security hardening	Escolha uma das seguintes opções. Não pode ser alterado após a criação do cluster. Disable: nenhum hardening de segurança aplicado. MLPS security hardening: aplica as linhas de base de nível 3 do Multi-Level Protection Scheme (MLPS) 2.0 às imagens do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3. Importante Quando o hardening de segurança MLPS está ativado, o login SSH como root é proibido. Use o VNC para fazer login a partir do ECS console e crie usuários regulares para acesso SSH. Consulte Connect to an instance by using VNC. OS security hardening : disponível apenas para imagens do Alibaba Cloud Linux 2 ou Alibaba Cloud Linux 3.
Logon method	Set key pair ou Set password. - Set key pair: autenticação por par de chaves SSH, suportada apenas para instâncias Linux. Especifique o Username (root ou ecs-user) e o par de chaves. - Set password: a senha deve ter de 8 a 30 caracteres e incluir letras maiúsculas, minúsculas, dígitos e caracteres especiais. Especifique o Username (root ou ecs-user) e a senha. Nota Quando o hardening de segurança MLPS é selecionado, apenas Set password é suportado.
Username	Se você definir o Logon method como Set key pair ou Set password, especifique se deseja fazer login como root ou ecs-user.

Número de instâncias

Parâmetro	Descrição	Alterável
System disk	Tipos suportados: ESSD AutoPL, Enterprise SSD (ESSD), ESSD Entry, Standard SSD e Ultra Disk. Os tipos disponíveis dependem das famílias de instâncias selecionadas. Para Enterprise SSD (ESSD), defina o nível de desempenho (PL). PLs mais altos exigem maior capacidade: PL2 requer mais de 460 GiB; PL3 requer mais de 1.260 GiB. Consulte Capacity and PLs. A criptografia está disponível apenas para Enterprise SSD (ESSD). O CMK de service padrão é usado por padrão; você também pode usar um CMK BYOK existente do KMS. Selecione More system disk types para especifique tipos de disco diferentes do tipo de disco do sistema e melhorar as taxas de sucesso do scale-out. Quando o ACK cria um nó, ele usa o primeiro tipo de disco que corresponde, na ordem especificada.
Data disk	Tipos suportados: ESSD AutoPL, Enterprise SSD (ESSD), ESSD Entry, SSD e Ultra Disk. ESSD AutoPL suporta provisionamento de desempenho (para desempenho sustentado acima da linha de base) e burst de desempenho (para picos de leitura/gravação). Enterprise SSD (ESSD): configure um PL personalizado. PL2 requer mais de 460 GiB; PL3 requer mais de 1.260 GiB. A criptografia está disponível para todos os tipos de disco de dados. Crie discos de dados a partir de snapshots para acelerar o carregamento de imagens de contêiner e a inicialização de modelos de linguagem grandes (LLM). Durante a criação do nó, o último disco de dados é formatado automaticamente. O sistema monta `/var/lib/container` neste disco e monta `/var/lib/kubelet` e `/var/lib/containerd` em `/var/lib/container`. Para personalizar os pontos de montagem, modifique a configuração de inicialização do disco de dados. Selecione no máximo um disco de dados como o diretório ocupado pelo tempo de execução do contêiner. Consulte Can I mount a data disk to a custom directory in an ACK node pool? Selecione Add Data Disk Type para especifique tipos de disco diferentes do tipo de disco de dados e melhorar as taxas de sucesso do scale-out. Quando o ACK cria um nó, ele usa o primeiro tipo de disco que corresponde, na ordem especificada. Nota Até 64 discos de dados podem ser anexados a uma instância ECS, dependendo do tipo de instância. Para verificar o limite de um tipo específico, chame a operação DescribeInstanceTypes e verifique o parâmetro `DiskQuantity`.

Parâmetro	Descrição	Alterável
Expected number of nodes	O número total de nós que o pool de nós mantém. Defina como pelo menos 2 para garantir que os componentes do cluster sejam executados corretamente. Defina como 0 se você não precisar de nós no momento da criação. Consulte Manually scale a node pool.

Configurações avançadas

Expanda Advanced options (optional) para configurar os seguintes parâmetros.

Edite um pool de nós

Atualize alguns parâmetros do pool de nós após a criação, incluindo vSwitches, método de faturamento, tipo de instância, disco do sistema e configurações de auto scaling. Para a lista completa de parâmetros editáveis, consulte a coluna Changeable nas tabelas de parâmetros acima.

Importante

A modificação de um pool de nós não afeta os nós ou aplicações em outros pools de nós do cluster.
Na maioria dos casos, as configurações atualizadas aplicam-se apenas aos nós recém-adicionados. Exceções: ECS tags, node labels e taints (as alterações nestes também se aplicam aos nós existentes).
Se você modificou nós fora da configuração do pool de nós (por exemplo, diretamente na instância ECS), essas alterações serão sobrescritas quando você atualize o pool de nós.

Ao alternar o Scaling mode:

Manual to Auto: ativa o auto scaling e requer a configuração das contagens mínima e máxima de instâncias.
Auto to Manual: desativa o auto scaling, define o mínimo de instâncias como 0 e o máximo como 2.000, e define o Expected number of nodes para a contagem atual de nós.

Passos:

Na página Node Pools, localize o pool de nós e clique em Edit na coluna Actions.
Na caixa de diálogo, modifique os parâmetros e siga as instruções na tela.

O status do pool de nós mostra Updating durante a atualização e retorna para Active quando concluída.

Visualize um pool de nós

Clique em um pool de nós para visualize seus detalhes em quatro abas:

Basic information: detalhes de configuração do cluster, pool de nós e nós. Se o auto scaling estiver ativado, as configurações de dimensionamento elástico também são mostradas aqui.
Monitoring: uso de CPU, uso de memória, uso de disco e média de CPU/memória por nó, fornecido pelo Alibaba Cloud Prometheus.
Gerencie nós: lista todos os nós no pool. Remova, drene, agende ou execute operações e manutenção (OM) em nós individuais. Clique em Export para baixe a lista de nós como um arquivo CSV.
Scaling activities: registros de eventos de dimensionamento recentes, incluindo a contagem de instâncias após cada atividade e a descrição da atividade. Se uma atividade falhar, você poderá visualize o motivo da falha. Para códigos de erro comuns, consulte Error codes and solutions for scaling failures.

Exclua um pool de nós

Importante

Revise as regras de liberação de nós abaixo antes de exclua o pool de nós.

O comportamento de liberação de nós depende se o Expected number of nodes está configurado para o pool e o método de faturamento de cada nó.

Pool de nós com Expected number of nodes configurado:

Parâmetro	Descrição	Alterável
Resource group	Atribua o pool de nós ao resource group selecionado. Os grupos de recursos ajudam a gerencie permissões e alocar custos. Cada recurso pode pertencer a apenas um grupo de recursos.
Scaling mode	Aplica-se apenas quando o pool de nós usa o modo de dimensionamento Auto. - Standard: dimensiona criando e liberando instâncias ECS. - Swift: dimensiona criando, parando e reiniciando instâncias ECS. Quando o pool de nós faz scale-out novamente, o ACK reinicia as instâncias paradas diretamente, o que melhora a velocidade de dimensionamento. As instâncias ECS paradas incorrem apenas em custos de armazenamento, não em custos de computação. Este modo não se aplica a famílias de instâncias que fornecem armazenamento local, como famílias de instâncias de big data e famílias de instâncias com SSD local. Para detalhes de faturamento e precauções sobre o modo de parada de instância ECS, consulte Economical mode.
Scaling policy	Determina como os novos nós são distribuídos entre as zonas durante o scale-out. - Priority: dimensiona na ordem de prioridade dos vSwitches selecionados. Se uma zona estiver indisponível, a próxima zona é tentada. - Cost optimization: cria instâncias do menor para o maior preço unitário de vCPU. Se o pool de nós usar Spot Instance , as instâncias spot são priorizadas. Configure a Percentage of pay-as-you-go instances (%) . Se um tipo de instância spot não puder ser criado devido a estoque insuficiente ou outros motivos, o ACK o complementa automaticamente com instâncias pay-as-you-go. - Distribution balancing: distribui as instâncias ECS uniformemente entre as zonas, o que entra em vigor apenas em cenários multizona. Se a distribuição de zonas ficar desequilibrada devido a estoque insuficiente, você pode execute a operação de balanceamento novamente.
Supplement spot capacity with on-demand instances	Requer faturamento Spot Instance. Quando ativado, o ACK cria automaticamente instâncias pay-as-you-go se as instâncias spot não puderem ser provisionadas devido a restrições de preço ou estoque.
Enable supplemental spot instances	Requer faturamento Spot Instance. Quando um aviso de recuperação é recebido (5 minutos antes da recuperação), o ACK tenta provisionar novas instâncias spot como substitutas. Se a compensação for bem-sucedida, o ACK drena e remove os nós antigos. Se falhar, o ACK não drena os nós antigos e tenta novamente quando as condições de estoque e preço forem atendidas. Ative Supplement spot capacity with on-demand instances junto com esta opção para melhorar as taxas de sucesso da compensação. Consulte Best practices for spot instance-based node pools.
ECS tags	Tags adicionadas às instâncias ECS durante o auto scaling. O ACK e o Auto Scaling reservam 3 tags (`ack.aliyun.com:Cluster ID`, `ack.alibabacloud.com/nodepool-id:Node pool ID` e `acs:autoscaling:scalingGroupId:Scaling group ID`), deixando um máximo de 17 tags definidas pelo usuário por nó (o limite do ECS é de 20 no total). Nota Quando o auto scaling está ativado, as tags `k8s.io/cluster-autoscaler:true` e `k8s.aliyun.com:true` são adicionadas por padrão. O cluster autoscaler reformata os rótulos e taints dos nós para simulação: os rótulos tornam-se `k8s.io/cluster-autoscaler/node-template/label/key:value` e os taints tornam-se `k8s.io/cluster-autoscaler/node-template/taint/key/value:effect`. Para aumentar a cota de tags, envie uma solicitação no Quota Center console.
Taints	Os taints consistem em uma chave, um valor e um efeito. Restrições: - Key: 1–63 caracteres; letras, dígitos, hifens (`-`), sublinhados (`_`) e pontos (`.`); deve começar e terminar com uma letra ou dígito. Para uma chave com prefixo, o prefixo deve ser um nome de subdomínio (≤253 caracteres, terminando com `/`). - Value: até 63 caracteres; mesmas regras de caracteres da chave; pode estar em branco. - Effect: `NoSchedule`, `NoExecute` ou `PreferNoSchedule`. - `NoSchedule`: os pods não são agendados para o nó. - `NoExecute`: os pods não tolerantes são evacuados quando o taint é adicionado. - `PreferNoSchedule`: o agendador evita colocar pods não tolerantes no nó. Consulte Taints and tolerations.
Node labels	Os rótulos são pares chave-valor. Restrições para chaves: - 1–63 caracteres; letras, dígitos, hifens (`-`), sublinhados (`_`) e pontos (`.`); deve começar e terminar com uma letra ou dígito. - Para uma chave com prefixo, o prefixo deve ser um nome de subdomínio (≤253 caracteres, terminando com `/`). - Prefixos reservados (não podem ser usados): `kubernetes.io/`, `k8s.io/` e qualquer prefixo que termine com estes. Exceções: `kubelet.kubernetes.io/`, `node.kubernetes.io` e prefixos que terminam com estes. Valores: até 63 caracteres; mesmas regras de caracteres da chave; pode estar em branco.
Custom node name	Quando ativado, o nome do nó, o nome da instância ECS e o nome do host ECS são todos definidos com um valor personalizado. Formato: `prefixIP substringsuffix`. - Comprimento total: 2–64 caracteres; deve começar e terminar com uma letra minúscula ou dígito. - Prefixo (obrigatório): letras, dígitos, hifens (`-`) e pontos (`.`); deve começar com uma letra; não pode terminar com hífen ou ponto; sem hifens ou pontos consecutivos. - Sufixo (opcional): mesmas regras do prefixo. Exemplo: IP `192.XX.YY.55`, prefixo `aliyun.com`, sufixo `test` → nome do nó Linux: `aliyun.com192.XX.YY.55test`. Os nós Windows usam hifens em vez de pontos no nome do host (por exemplo, `192-XX-YY-55`).
Pre-custom instance data	Um script que é executado nos nós antes de eles ingressarem no cluster. Requer uma solicitação de cota no Quota Center console. Consulte User-data scripts. Por exemplo, se você definir os dados pré-personalizados como `touch /tmp/pre-script`, os scripts executados em um nó são combinados na seguinte ordem. `#!/bin/bash # The specified pre-custom data execute here. touch /tmp/pre-script # The ACK node initialization script execute here.` Para o efeito deste parâmetro durante a inicialização do nó, consulte Node initialization process.
Instance user data	Um script que é executado nos nós após eles ingressarem no cluster. Consulte User-data scripts. Por exemplo, se você definir os dados do usuário como `touch /tmp/post-script`, os scripts executados em um nó são combinados na seguinte ordem. `#!/bin/bash # The ACK node initialization script execute here. # The specified user data execute here. touch /tmp/post-script` Para o efeito deste parâmetro durante a inicialização do nó, consulte Node initialization process. Após criar um cluster ou adicionar nós, uma operação bem-sucedida não indica que o script de dados do usuário foi executado conforme o esperado. Faça login em um nó e execute `grep cloud-init /var/log/messages` para verificar o log de execução.
Cloud Monitor agent	Instale o agente do Cloud Monitor em novos nós, permitindo que você visualize as métricas do nó no Cloud Monitor console. Aplica-se apenas aos nós recém-adicionados. Para instale o agente em nós existentes, acesse o Cloud Monitor console diretamente.
Public IP address	Atribui um endereço IPv4 público a cada novo nó. Se ativado, configure Bandwidth billing method e Peak bandwidth. Aplica-se apenas aos nós recém-adicionados. Para ativar o acesso à internet para um nó existente, crie um Elastic IP Address (EIP) e associe-o ao nó. Consulte Associate an EIP with an ECS instance.
Custom security group	Selecione Basic security group ou Advanced security group. Apenas um tipo pode ser selecionado, e o tipo não pode ser alterado após a criação. Cada instância ECS suporta até 5 grupos de segurança. Certifique-se de que a cota seja suficiente. Se você selecione um grupo de segurança existente, as regras do grupo de segurança não serão configuradas automaticamente; configure-as manualmente. Consulte Configure security group rules to enforce access control on ACK clusters e Security groups.
RDS whitelist	Adiciona os endereços IP dos nós à lista de permissões de uma instância ApsaraDB RDS.
Deployment set	Distribui instâncias ECS em servidores físicos para alta disponibilidade. Crie um deployment set no ECS console primeiro, e depois especifique aqui. Importante Após selecione um deployment set, o número máximo de nós no pool é `20 × number of zones`. O número de zonas depende do número de vSwitches. Certifique-se de que a cota do ECS para o deployment set selecionado seja suficiente. Consulte Best practices for associating deployment sets with node pools.
Private pool type	Este parâmetro foi descontinuado. Use Resource Pool Policy para especifique um pool privado em seu lugar. Controla se um pool privado de reserva de capacidade é usado ao criar instâncias. - Open: corresponde automaticamente a um pool privado aberto; retorna ao pool público se nenhum for encontrado. - Do not use: usa apenas o pool público. - Specified: usa o pool privado especificado por ID; a criação da instância falha se o pool estiver indisponível. Consulte Private pools.

Método de faturamento	O que acontece com o nó
Pay-as-you-go	Liberado após a exclusão do pool de nós
Subscription	Retido após a exclusão do pool de nós

Pool de nós sem Expected number of nodes configurado:

Origem do nó	O que acontece com o nó
Nós adicionados manual ou automaticamente	Retidos (não liberados)
Nós Subscription	Retidos (não liberados)
Outros nós	Liberados quando o pool de nós é excluído

Todos os nós liberados são removidos do API server do cluster. Os nós retidos permanecem registrados no API server.

Para liberar um nó Subscription retido, altere seu método de faturamento para pay-as-you-go primeiro e, em seguida, libere a instância ECS a partir do ECS console.