Adicionar e gerenciar pools de nós

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

Antes de começar

Prepare-se para a tarefa tomando as seguintes medidas:

• Verifique se você ativou a API Google Kubernetes Engine.
Ativar a API Google Kubernetes Engine
• Verifique se o SDK do Cloud está instalado.
• Defina o código do projeto padrão:

  gcloud config set project [PROJECT_ID]

• Se você estiver trabalhando com clusters zonais, defina a zona de computação padrão:

  gcloud config set compute/zone [COMPUTE_ZONE]

• Se você estiver trabalhando com clusters regionais, defina a região de computação padrão:

  gcloud config set compute/region [COMPUTE_REGION]

• Atualize a gcloud para a versão mais recente:

  gcloud components update

Observação: é possível modificar essas configurações padrão nos comandos do gcloud usando as sinalizações operacionais --project, --zone e --region.

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]

Sinalizadores operacionais adicionais

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

• --machine-type: o tipo de máquina do compute Engine (como n1-standard-1) para usar em instâncias no pool de nós. Caso não seja especificado, o tipo de máquina padrão será n1-standard-1. Para informações sobre como especificar tipos de máquinas, consulte gcloud container node-pools create --machine-type.
• --num-nodes: especifica o número de nodes a serem criados no pool. 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 dos discos de inicialização da VM do nó em GB. É usado o padrão de 100 GB.
• --enable-cloud-endpoints: ativa automaticamente o Cloud Endpoints para aproveitar os recursos de gerenciamento de API. Ativado por padrão. Use --no-enable-cloud-endpoints para desativá-lo.

• --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 CPU mínima de base para executar nos nós.

• --scopes SCOPE,[SCOPE,...]: são especificados escopos para as instâncias de nó. Exemplo:

  <pre class="devsite-click-to-copy" translate="no">gcloud container node-pools create example-cluster \
      --scopes https://www.googleapis.com/auth/devstorage.read_only</pre>
  
  <pre class="devsite-click-to-copy" translate="no">gcloud container node-pools create example-cluster \
      --scopes bigquery,storage-rw,compute-ro</pre>
  

  Vários escopos delimitados por vírgulas podem ser especificados. Os escopos necessários para o funcionamento correto do cluster (compute-rw, storage-ro) sempre são adicionados, mesmo quando não são 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 ver a lista completa de opções, consulte a documentação do gcloud container node-pools create.

Em uma solicitação de criação de node-pools create bem-sucedida, as informações do pool são retornadas:

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

Console

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

1. Acesse o menu do Google Kubernetes Engine no console do GCP.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão "Editar" do cluster, que se parece com um lápis.

3. Na seção Pools de nós, clique em Adicionar pool de nós.

4. Configure seu pool de nós como quiser. Para ativar opções avançadas, como atualizações e escalonamento automáticos, clique em Edição avançada para o pool de nós.

5. Clique em Salvar para fechar a sobreposição Edição avançada.

6. Clique em Salvar novamente 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 os 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 GCP.

   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 desejado. O menu se expande 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 desejado e o novo número de nós:

gcloud container clusters resize [CLUSTER_NAME] --node-pool [NODE_POOL] \
    --size [SIZE]

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 do 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 GCP.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão "Editar" do cluster, que se parece com um lápis.

3. Na seção Pool de nós, altere o valor do 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

gcloud

Execute o comando gcloud container clusters upgrade e atualize todos os nós para a versão mais recente do Kubernetes:

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 GCP.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão "Editar" do cluster, que se parece com um lápis.

3. Na seção Pool de nós, clique no link Alterar ao lado do campo Versão do nó no pool de nós 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 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 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 GCP.

   Acessar o menu do Google Kubernetes Engine

2. Clique no botão "Editar" do cluster, que se parece com um lápis.

3. Para excluir o pool de nós, clique no ícone de exclusão, visível ao passar o mouse sobre o botão "Editar" que se parece com um lápis.

4. Clique em Salvar. Para retornar à página de visão geral do cluster, clique na seta na parte superior da tela.

A seguir

• Leia sobre o funcionamento dos pools de nós.