Como adicionar e gerenciar pools de nós

Padrão

---

Nesta página, você vê como adicionar e executar operações em pools de nós que executam os clusters do Google Kubernetes Engine (GKE). Para aprender sobre como os pools de nós funcionam, consulte Pools de nós.

Antes de começar

Antes de começar, verifique se você realizou as tarefas a seguir:

• Verifique se você ativou a API Google Kubernetes Engine.
Ativar a API Google Kubernetes Engine
• Verifique se o SDK do Cloud está instalado.

Defina as configurações padrão da gcloud usando um dos métodos a seguir:

• Use gcloud init se quiser orientações para definir os padrões.
• Use gcloud config para definir individualmente a região, a zona e o ID do projeto.

Como usar o gcloud init

Se você receber o erro One of [--zone, --region] must be supplied: Please specify location, conclua esta seção.

1. Execute gcloud init e siga as instruções:

   gcloud init

   Se você estiver usando SSH em um servidor remoto, utilize a sinalização --console-only para impedir que o comando inicie um navegador:

   gcloud init --console-only

2. Siga as instruções para autorizar a gcloud a usar sua conta do Google Cloud.
3. Crie uma nova configuração ou selecione uma atual.
4. Escolha um projeto do Google Cloud.
5. Escolha uma zona padrão do Compute Engine para clusters zonais ou uma região para clusters regionais ou de Autopilot.

Observação: para modificar essas configurações padrão nos comandos gcloud, use as sinalizações --project, --zone e --region.

Como usar o gcloud config

• Defina o ID do projeto padrão:

  gcloud config set project PROJECT_ID

• Se você estiver trabalhando com clusters zonais, defina a zona do Compute padrão:

  gcloud config set compute/zone COMPUTE_ZONE

• Se você estiver trabalhando com clusters de Autopilot ou regionais, defina a região do Compute padrão:

  gcloud config set compute/region COMPUTE_REGION

• Atualize gcloud para a versão mais recente:

  gcloud components update

Observação: para modificar as configurações padrão nos comandos gcloud, use as sinalizações --project, --zone e --region.

Observação: o login do SO não é compatível com clusters públicos do GKE. O Login do SO é compatível com clusters particulares do GKE que executam as versões 1.20.5 ou posteriores do pool de nós. O Login do SO é desativado explicitamente nos nós do GKE, mesmo se estiver ativado no projeto do Google Cloud.

Como adicionar um pool de nós

gcloud

Para criar um pool de nós, execute o comando gcloud container node-pools create:

gcloud container node-pools create POOL_NAME --cluster CLUSTER_NAME

Outras sinalizações operacionais

Veja abaixo algumas sinalizações opcionais que você pode especificar:

• --machine-type: o tipo de máquina do Compute Engine a ser usado para instâncias no pool de nós. É possível especificar um tipo de máquina predefinido ou um tipo de máquina personalizado. Se não for especificado, o tipo de máquina padrão será e2-medium. Consulte gcloud container node-pools create --machine-type para mais informações sobre como especificar tipos de máquinas.
• --num-nodes: especifica o número de nós a serem criados no pool de nós. O padrão é três. É preciso que a cota disponível no projeto seja suficiente para o número de nós. Além disso, a cota de rota também precisa ser suficiente.
• --disk-size: tamanho em GB para discos de inicialização de VM do nó. É usado o padrão de 100 GB.

• --image-type: o tipo de imagem a ser usado para o pool de nós. Com o tipo de imagem, é especificado o SO de base a ser executado nos nós do pool. Se um tipo de imagem for especificado, ele será atribuído ao pool de nós, e usados por todos os futuros upgrades. Se não for especificado, o servidor escolherá o tipo de imagem padrão.

  O tipo de imagem padrão e a lista de tipos de imagem válidos estão disponíveis ao executar o comando a seguir:

  gcloud container get-server-config

• --min-cpu-platform: a plataforma de base mínima de CPU para ser executada nos nós.

• --node-locations=[ZONE,ZONE,...]: possibilita que você especifique zonas nos pools de nós, mesmo se não definir a zona em um cluster. É possível especificar vários locais separados por vírgulas e usar essa sinalização nos clusters de zona única, de várias zonas e regionais. Essa sinalização também pode ser usada para alterar as zonas do pool de nós depois de criar o cluster com node-pools update --node-locations=[zones].

• --scopes=SCOPE,[SCOPE,...]: especifica escopos para as instâncias de nós. Por exemplo:

  gcloud container node-pools create example-cluster \
    --scopes https://www.googleapis.com/auth/devstorage.read_only

  gcloud container node-pools create example-cluster \
    --scopes bigquery

  Vários escopos delimitados por vírgulas podem ser especificados. Os escopos default são atribuídos a todas as instâncias. Para ver a lista de escopos padrão, consulte a documentação gcloud container node-pools create.

  O SCOPE pode ser o URI completo do escopo ou um alias.

  Escopos disponíveis

  Os escopos a seguir estão disponíveis:

  Alias	URI
  bigquery	https://www.googleapis.com/auth/bigquery
  cloud-platform	https://www.googleapis.com/auth/cloud-platform
  compute-ro	https://www.googleapis.com/auth/compute.readonly
  compute-rw	https://www.googleapis.com/auth/compute
  datastore	https://www.googleapis.com/auth/datastore
  logging-write	https://www.googleapis.com/auth/logging.write
  monitoring	https://www.googleapis.com/auth/monitoring
  monitoring-write	https://www.googleapis.com/auth/monitoring.write
  service-control	https://www.googleapis.com/auth/servicecontrol
  service-management	https://www.googleapis.com/auth/service.management.readonly
  sql	https://www.googleapis.com/discovery/v1/apis/sqladmin/v1beta4/rest
  sql-admin	https://www.googleapis.com/auth/sqlservice.admin
  storage-full	https://www.googleapis.com/auth/devstorage.full_control
  storage-ro	https://www.googleapis.com/auth/devstorage.read_only
  storage-rw	https://www.googleapis.com/auth/devstorage.read_write
  taskqueue	https://www.googleapis.com/auth/taskqueue
  useraccounts-ro	https://www.googleapis.com/auth/cloud.useraccounts.readonly
  useraccounts-rw	https://www.googleapis.com/auth/cloud.useraccounts
  userinfo-email	https://www.googleapis.com/auth/userinfo.email

Para ver a lista completa de opções, consulte a documentação do gcloud container node-pools create.

Uma solicitação node-pools create bem-sucedida retorna as informações do pool de nós:

Creating node pool example-pool...done.
Created [https://container.googleapis.com/v1/projects/kubernetes-engine-docs/zones/us-central1-f/clusters/example-cluster/nodePools/example-pool].
NAME          MACHINE_TYPE   DISK_SIZE_GB  NODE_VERSION
example-pool  e2-medium      100           1.2.4

Você criou o pool de nós. Às vezes, ele é criado com sucesso, mas os comandos gcloud expiram em vez de relatar o status do servidor. Para verificar o status de todos os pools de nós, incluindo aqueles que ainda não foram totalmente provisionados, use o comando a seguir:

gcloud container node-pools list --cluster CLUSTER_NAME

Console

Para adicionar um pool de nós a um cluster atual, execute as etapas a seguir:

1. Acesse a página do Google Kubernetes Engine no Console do Cloud.

   Acessar o Google Kubernetes Engine

2. Ao lado do cluster que você quer editar, clique em Ações e em Editar.

3. Clique em Adicionar pool de nós.

4. Configure o pool de nós como quiser.

5. Clique em Criar para adicionar o pool de nós.

Como visualizar pools de nós em um cluster

gcloud

Para listar todos os pools de nós de um cluster, execute o comando gcloud container node-pools list:

gcloud container node-pools list --cluster CLUSTER_NAME

Para visualizar detalhes sobre um pool de nós específico, execute o comando gcloud container node-pools describe:

gcloud container node-pools describe POOL_NAME \
    --cluster CLUSTER_NAME

Substitua:

• CLUSTER_NAME: o nome do cluster.
• POOL_NAME: o nome do pool de nós a ser visualizado.

Console

Para ver os pools de nós de um cluster, siga estas etapas:

1. Acesse a página do Google Kubernetes Engine no Console do Cloud.

   Acessar o Google Kubernetes Engine

2. Na lista de clusters, clique no nome do cluster.

3. Clique na guia Nós.

4. Em Pools de nós, clique no nome do pool que você quer visualizar.

Como redimensionar um pool de nós

gcloud

Para redimensionar os pools de nós de um cluster, execute o comando gcloud container clusters resize:

gcloud container clusters resize CLUSTER_NAME --node-pool POOL_NAME \
    --num-nodes NUM_NODES

Substitua:

• CLUSTER_NAME: o nome do cluster a ser redimensionado.
• POOL_NAME: o nome do pool de nós a ser redimensionado.
• NUM_NODES: o número de nós no pool em um cluster zonal. Se você usar clusters regionais ou de várias zonas, NUM_NODES será o número de nós para cada zona em que os pools de nós estão.

Repita este comando para cada pool de nós. Se o cluster tiver apenas um pool de nós, omita a sinalização --node-pool.

Console

Para reescalonar os pools de nós do cluster, siga estas etapas:

1. Acesse a página do Google Kubernetes Engine no Console do Cloud.

   Acessar o Google Kubernetes Engine

2. Ao lado do cluster que você quer editar, clique em Ações e em Editar.

3. Clique na guia Nós.

4. Na seção Pool de nós, clique no nome do pool de nós que você quer redimensionar.

5. Clique em Redimensionar.

6. No campo Número de nós, insira quantos nós você quer no pool de nós e clique em Redimensionar.

7. Repita para cada pool de nós conforme necessário.

Como fazer upgrade de um pool de nós

Por padrão, os nós de um cluster têm o upgrade automático ativado e é recomendável que ele não seja desativado.

Quando um pool de nós é atualizado, é possível definir configurações de upgrade de sobretensão para controlar quantos nós do GKE são atualizados ao mesmo tempo e o grau de interrupção do upgrade para as cargas de trabalho. Por padrão, o GKE atualiza um nó por vez.

Enquanto um nó está sendo atualizado, o GKE interrompe a programação de novos pods nele e tenta programar seus pods em execução em outros nós. Isso é semelhante a outros eventos que recriam o nó, como ativar ou desativar um recurso no pool de nós.

Observação: durante os upgrades automáticos ou manuais de nós, os PodDisruptionBudgets (PDBs) [em inglês] são respeitados por 1 hora no máximo. Se a programação dos pods em um nó não for possível depois desse período, o upgrade será iniciado mesmo assim.
Para mais informações sobre o que esperar durante o encerramento do nó, consulte o tópico sobre Pods.

O upgrade será concluído apenas quando todos os nós forem recriados, e o cluster assumir o estado desejado. Quando um nó recém-atualizado é registrado no plano de controle, o GKE o marca como programável.

As instâncias do novo nó executam a versão do Kubernetes desejada e também:

• A imagem do nó
• O daemon do Docker, se aplicável
• kubelet
• kube-proxy

Como fazer upgrade manual de um pool de nós

É possível fazer upgrade manual de uma versão do pool de nós para igualá-la à versão do plano de controle ou a uma versão anterior que ainda esteja disponível e seja compatível com o plano de controle. A versão do Kubernetes e a política de suporte de diferença de versão (em inglês) garantem que os planos de controle sejam compatíveis com nós de até duas versões secundárias mais antigas que o plano de controle. Por exemplo, os planos de controle do Kubernetes 1.13 são compatíveis com os nós do Kubernetes 1.11.

Quando você faz upgrade manual de um pool de nós, o GKE remove todos os rótulos adicionados a nós individuais usando kubectl. Para evitar isso, aplique rótulos aos pools de nós (visualização)

Observação: o upgrade de um pool de nós pode interromper a execução das cargas de trabalho nele. Para evitar que isso aconteça, crie um novo pool de nós com a versão pretendida e migre a carga de trabalho. Após a migração, é possível excluir o antigo pool de nós.

Observação: se você fizer upgrade de um pool de nós que tenha uma Entrada com erro, o grupo da instância não será sincronizado. Para resolver esse problema, primeiro verifique status usando o comando kubectl get ing. Se o grupo de instâncias não estiver sincronizado, aplique novamente o manifesto usado para criar o ingress.

É possível fazer upgrade manual dos pools de nós para uma versão compatível com o plano de controle usando o Console do Google Cloud ou a ferramenta de linha de comando gcloud.

gcloud

Para atualizar todos os nós para a mesma versão do plano de controle, execute o comando gcloud container clusters upgrade:

gcloud container clusters upgrade CLUSTER_NAME

Substitua CLUSTER_NAME pelo nome do cluster a ser atualizado.

Para atualizar um pool de nós específico, especifique o sinalizador --node-pool:

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME

Para especificar uma versão diferente do GKE nos nós, use a sinalização opcional --cluster-version:

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME \
  --cluster-version VERSION

Substitua VERSION pela versão do Kubernetes para que os nós serão atualizados. Por exemplo, --cluster-version=1.7.2 ou cluster-version=latest.

Para mais informações sobre como especificar versões, consulte Controle de versões.

Para mais informações, consulte a documentação gcloud container clusters upgrade.

Console

Para fazer upgrade de um pool de nós com o Console do Cloud, siga as etapas a seguir:

Para fazer upgrade de um pool de nós, siga estas etapas:

1. Acesse a página do Google Kubernetes Engine no Console do Cloud.

   Acessar o Google Kubernetes Engine

2. Ao lado do cluster que você quer editar, clique em Ações e, depois, em Editar.

3. Na página Detalhes do cluster, clique na guia Nós.

4. Na seção Pools de nós, clique no nome do pool de nós que você quer atualizar.

5. Clique em Editar.

6. Em Versão do nó, clique em Alterar.

7. Selecione a versão pretendida na lista suspensa Versão do nó e clique em Alterar.

Observação: talvez leve vários minutos para que a versão do nó seja alterada.

Implantar um pod em um pool de nós específico

É possível implantar explicitamente um pod em um pool de nós específico usando um nodeSelector no manifesto do pod. nodeSelector programa pods em nós com um rótulo correspondente.

Todos os pools de nós do GKE têm rótulos com o seguinte formato: cloud.google.com/gke-nodepool: POOL_NAME. Adicione esse rótulo ao campo nodeSelector no seu pod, conforme mostrado no exemplo a seguir:

apiVersion: v1
kind: Pod
metadata:
  name: nginx
  labels:
    env: test
spec:
  containers:
  - name: nginx
    image: nginx
    imagePullPolicy: IfNotPresent
  nodeSelector:
    cloud.google.com/gke-nodepool: POOL_NAME

Para mais informações, consulte Como atribuir pods a nós.

Como alternativa ao seletor de nós, é possível usar a afinidade de nó. Use essa afinidade se quiser uma regra "soft" em que o pod tenta cumprir a restrição, mas ainda seja programado, mesmo que a restrição não seja atendida. Para mais informações, consulte Afinidade de nó. Também é possível especificar solicitações de recursos nos contêineres.

Como fazer downgrade de pools de nós

Observação: não é recomendável fazer downgrade de pools de nós. Tente apenas fazer o downgrade de um pool de nós para reduzir um upgrade malsucedido de nós.

Exclusão do pool de nós

A exclusão de um pool exclui os nós e as rotas que levam a eles. Todos os pods executados nesses nós são removidos e reprogramados. Se os pods tiverem seletores de nó específicos, poderão permanecer em uma condição não programável se nenhum outro nó no cluster cumprir os critérios.

gcloud

Para excluir um pool de nós, execute o comando gcloud container node-pools delete:

gcloud container node-pools delete POOL_NAME --cluster CLUSTER_NAME

Console

Para excluir um pool de nós, siga estas etapas:

1. Acesse a página do Google Kubernetes Engine no Console do Cloud.

   Acessar o Google Kubernetes Engine

2. Ao lado do cluster que você quer editar, clique em Ações e em Editar.

3. Clique na guia Nós.

4. Na seção Pool de nós, clique em ao lado do pool que você quer excluir.

5. Quando solicitado a confirmar, clique em Excluir.

A seguir

• Leia sobre como os pools de nós funcionam.
• Saiba mais sobre os pools de nós com provisionamento automático.
• Saiba como configurar kubelet e sysctl usando a configuração do sistema do nó.