Como redimensionar um cluster de usuário

Redimensionar um cluster de usuário significa adicionar ou remover nós. A adição de nós exige que os endereços IP estejam disponíveis para os novos nós. Para redimensionar um cluster de usuário, altere o número de réplicas no pool de nós.

Para informações sobre limites máximos e mínimos para clusters de usuários, consulte Cotas e limites.

Para mais informações sobre como gerenciar pools de nós, consulte Como criar e gerenciar pools de nós.

Verificar se há endereços IP suficientes disponíveis

Se você pretende ter N nós após o redimensionamento, precisará ter N + 1 endereços IP disponíveis.

Antes de redimensionar um cluster, verifique se você tem endereços IP suficientes. A maneira de fazer a verificação depende do cluster usar um servidor DHCP ou endereços IP estáticos.

DHCP

Se o cluster usar o DHCP, verifique se o servidor DHCP pode fornecer endereços IP suficientes. É necessário que seja possível fornecer pelo menos mais um endereço IP do que o número de nós que estarão no cluster após o redimensionamento.

IPs estáticos

A maneira de verificar se você tem endereços IP estáticos suficientes depende de o cluster ser gerenciado pela API GKE On-Prem. Um cluster de usuário será gerenciado pela API GKE On-Prem se uma das condições a seguir for verdadeira:

O cluster foi criado no console do Google Cloud, que configura automaticamente a API GKE On-Prem para gerenciar o cluster.
O comando gkectl enroll cluster foi executado em um cluster de usuário, que configura ele para ser gerenciado pela API do GKE On-Prem.

Se a API GKE On-Prem estiver gerenciando um cluster de usuário, use o Console do Cloud para contar o número de IPs e adicionar mais IPs, se necessário. Se o cluster de usuário não for gerenciado pela API GKE On-Prem, será possível executar gkectl update cluster primeiro, o que verifica se você alocou endereços IP suficientes no cluster. Caso contrário, você encontrará na mensagem de erro o número necessário de endereços IP extras.

Adicionar IPs estáticos

Se o cluster for gerenciado pela API GKE On-Prem, use o Console do Cloud para adicionar mais endereços IP. Caso contrário, use a linha de comando na estação de trabalho de administrador.

Console

No console, acesse a página de visão geral dos clusters do Google Kubernetes Engine.

Acesse os clusters do GKE
Selecione o projeto do Cloud em que o cluster de usuário está.
Na lista de clusters, clique no nome dele e em Mais detalhes no painel Detalhes.
Na seção Rede, clique em Editar.
Na caixa de diálogo Adicionar outros endereços IP estáticos, clique em Adicionar endereço IP. Digite o endereço IP e, opcionalmente, um nome do host. Repita quantas vezes forem necessárias. Quando terminar, clique em Concluir.

Linha de comando

Abra o arquivo de bloco de IPs do cluster de usuário para edição.
Verifique se todos os endereços IP que você pretende usar para o cluster de usuário estão incluídos no arquivo de bloco de IPs. O arquivo de bloco IP precisa ter pelo menos mais um endereço IP do que o número de nós que estarão no cluster após o redimensionamento.
Para ver os endereços reservados para um cluster de usuário:
```
kubectl get cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --namespace USER_CLUSTER_NAME USER_CLUSTER_NAME --output yaml
```
Substitua:
- ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador
- USER_CLUSTER_NAME: o nome do cluster do usuário
Adicione quantos endereços IP estáticos adicionais ao bloco correspondente forem necessários e execute gkectl update cluster.

Veja um exemplo de um arquivo de bloco de IP que tem quatro endereços IP e os nomes do host correspondentes:

hostconfig:
dns: 172.16.255.1
tod: 216.239.35.0
blocks:
- netmask: 255.255.248.0
  gateway: 21.0.135.254
  ips:
  - ip: 21.0.133.41
    hostname: user-node-1
  - ip: 21.0.133.50
    hostname: user-node-2
  - ip: 21.0.133.56
    hostname: user-node-3
  - ip: 21.0.133.47
    hostname: user-node-4

Redimensionar o cluster

Console

No console, acesse a página de visão geral dos clusters do Google Kubernetes Engine.

Acesse os clusters do GKE
Selecione o projeto do Cloud em que o cluster de usuário está.
Na lista de clusters, clique no nome dele e em Mais detalhes no painel Detalhes.
Clique na guia Nós.
Clique no nome do pool de nós que você quer redimensionar.
Clique em Redimensionar.
No campo Nós, insira o número de nós que você quer no pool de nós e clique em Concluído.
Clique em para voltar à página anterior.
O console do Google Cloud exibe Status do cluster: alterações em andamento. Clique em Mostrar detalhes para ver a Condição do status do recurso e as Mensagens de status.

Linha de comando

No arquivo de configuração do cluster de usuário, atualize o valor do campo replicas em um ou mais dos elementos de nodePools.

Redimensionar o cluster

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

Substitua:

ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador
USER_CLUSTER_CONFIG: o caminho do arquivo de configuração do cluster de usuário

Verifique se o redimensionamento foi concluído:

kubectl --kubeconfig USER_CLUSTER_KUBECONFIG get nodes

kubectl --kubeconfig USER_CLUSTER_KUBECONFIG describe machinedeployments NODE_POOL_NAME | grep Replicas

Substitua:

USER_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de usuário
NODE_POOL_NAME: o nome do pool de nós que você redimensionou.

Solução de problemas

Consulte Solução de problemas na criação e no upgrade de clusters.