Como adicionar e gerenciar pools de nós

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 saber como os pools de nós funcionam, consulte esta página.

Antes de começar

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

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

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

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

Como usar o gcloud init

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

   gcloud init

   Se você usa o 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.

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 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 essas 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 o GKE v1.10.x e superior 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 a seguir:

gcloud container node-pools create pool-name --cluster cluster-name

Observação: desde 11 de novembro de 2019, o upgrade automático de nós é ativado por padrão em novos pools de nós criados com gcloud.

Outras sinalizações operacionais

Veja abaixo algumas sinalizações opcionais que podem ser especificadas:

• --machine-type: o tipo de máquina do Compute Engine, como n1-standard-1, a ser usado nas instâncias do pool de nós. Se não for especificado, o tipo de máquina padrão será n1-standard-1. Consulte gcloud container node-pools create --machine-type para informações sobre como especificar tipos de máquina.
• --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 da cota de rota.
• --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 no 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 usado por todos os upgrades futuros. Caso contrário, 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 mínima de CPU de valor de referência a 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,storage-rw,compute-ro

  Vários escopos delimitados por vírgulas podem ser especificados. Os escopos necessários para que o cluster funcione corretamente (compute-rw, storage-ro) são sempre adicionados, mesmo que não sejam especificados explicitamente.

  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 a lista completa de opções, consulte a documentação de 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  n1-standard-1  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 o menu do Google Kubernetes Engine no Console do Cloud.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão de edição do cluster, que se parece com um lápis.

3. Clique em Adicionar pool de nós.

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

5. Clique em Concluído para fechar a sobreposição Adicionar pool de nós.

6. Clique em Salvar para modificar o cluster.

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 node-pools list:

gcloud container node-pools list --cluster cluster-name

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

gcloud container node-pools describe pool-name \
        --cluster cluster-name

Console

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

1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

   Acessar o menu do Google Kubernetes Engine

2. Clique no nome do cluster que você quer visualizar.

3. Na seção Pool de nós, clique no ícone de revelação ao lado do pool de nós pretendido. O menu é expandido para exibir detalhes sobre o pool de nós.

4. Clique em Concluído para sair da visão geral de detalhes do pool de nós.

Como redimensionar um pool de nós

gcloud

Para redimensionar um pool de nós, use o comando gcloud container clusters resize. Especifique o nome do cluster, o nome do pool de nós pretendido e o novo número de nós:

gcloud container clusters resize cluster-name --node-pool pool-name \
        --num-nodes num-nodes

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

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

Console

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

1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão de edição do cluster, que se parece com um lápis.

3. Na seção Pools de nós, altere o campo Tamanho para o valor pretendido. Repita para cada pool de nós conforme necessário.

4. Clique em Salvar.

Como fazer upgrade de um pool de nós

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

gcloud

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

gcloud container clusters upgrade cluster-name

Para atualizar um pool de nós específico, especifique a sinalização --node-pool:

gcloud container clusters upgrade cluster-name --node-pool pool-name

Console

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

1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão de edição do cluster, que se parece com um lápis.

3. Na seção Pools de nós, clique no link Alterar ao lado do campo Versão do nó no pool pretendido.

4. Selecione a versão do Kubernetes que você quer.

5. Leia o aviso e clique em Alterar para confirmar.

6. Clique em Salvar para sair da tela de modificação do cluster.

Como excluir o pool de nós

A exclusão de um pool de nós exclui os nós e as rotas dele. Todos os pods executados nesses nós são removidos e reprogramados. Se os pods tiverem seletores de nó específicos, eles 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 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 o menu do Google Kubernetes Engine no Console do Cloud.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão de edição do cluster, que se parece com um lápis.

3. Na seção Pools de nós, expanda o pool de nós que você quer excluir.

4. Clique no ícone de exclusão, que tem a forma de uma lixeira.

5. Clique em Salvar.

A seguir

• Leia sobre como os pools de nós funcionam.
• Saiba mais sobre os pools de nós com provisionamento automático.