Como gerenciar clusters

Autopilot Padrão

---

Veja nesta página como gerenciar seus clusters no Google Kubernetes Engine (GKE). Para saber como os clusters funcionam, consulte Arquitetura de cluster.

Antes de começar

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

• Ativar a API Google Kubernetes Engine.
Ativar a API Google Kubernetes Engine
• Se você quiser usar a Google Cloud CLI para essa tarefa, instale e, em seguida, inicialize a CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando gcloud components update.
  Observação: para instalações atuais da CLI gcloud, defina as propriedades compute/region e compute/zone. Ao definir locais padrão, é possível evitar erros na gcloud CLI, como: One of [--zone, --region] must be supplied: Please specify location.

Como ver os clusters

gcloud

Para ver um cluster específico, execute o seguinte comando:

gcloud container clusters describe CLUSTER_NAME

Substitua CLUSTER_NAME pelo nome do cluster.

Para visualizar todos os clusters na sua zona padrão:

gcloud container clusters list

Console

Para visualizar os clusters, acesse a página do Google Kubernetes Engine no console do Google Cloud.

Acessar o Google Kubernetes Engine

Para ver mais informações sobre um cluster, selecione-o na lista.

Como configurar um cluster padrão para kubectl

Se você tiver vários clusters, poderá definir um cluster padrão para a ferramenta de linha de comando kubectl.

Para saber mais, consulte a seção Como configurar um cluster padrão para os comandos kubectl.

Como configurar um cluster padrão para gcloud

Para definir um cluster padrão para os comandos gcloud, execute este comando:

gcloud config set container/cluster CLUSTER_NAME

Substitua CLUSTER_NAME pelo nome do cluster.

Como fazer upgrade de clusters

Por padrão, o GKE faz upgrade dos clusters automaticamente. No entanto, é possível fazer o upgrade dos clusters padrão por conta própria. Para saber mais, consulte Como fazer upgrade manual de um cluster.

Para orientações sobre como fazer upgrade de clusters, consulte Práticas recomendadas para fazer upgrade de clusters.

Como adicionar ou remover zonas em um cluster padrão

Veja nas seções a seguir como adicionar ou remover zonas de cluster. Todas as zonas precisam estar na região do cluster.

Aviso: se você alterar as zonas do cluster, os nós serão adicionados ou removidos imediatamente. Antes de remover uma zona, verifique se as cargas de trabalho nela estão preparadas para interrupções.

Como alterar as zonas para clusters zonais

Para clusters zonais, é possível adicionar ou remover zonas.

gcloud

Para adicionar ou remover zonas de um cluster zonal, use o comando gcloud container clusters update:

gcloud container clusters update CLUSTER_NAME \
  --zone COMPUTE_ZONE \
  --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Substitua:

• CLUSTER_NAME: o nome escolhido para o cluster.
• COMPUTE_ZONE: é a zona do plano de controle do cluster.
• COMPUTE_ZONE,COMPUTE_ZONE1,[...]: as zonas em que os nós são criados. Especifique quantas zonas forem necessárias para o cluster. Todas as zonas precisam estar na mesma região que o plano de controle do cluster, especificado pela sinalização --zone. Para clusters zonais, --node-locations precisa conter a zona principal do cluster.

Observação: em --node-locations, não coloque espaços entre os nomes das zonas.

Por exemplo, example-cluster é executado em us-central1-a. Para adicionar mais duas zonas ao cluster, você executaria o seguinte comando:

gcloud container clusters update example-cluster \
  --zone us-central1-a
  --node-locations us-central1-a,us-central1-b,us-central1-c

Como outro exemplo, example-cluster é executado em us-central1-a, us-central1-b e us-central1-c. Se você quiser que o cluster seja executado apenas em us-central1-a e us-central1-b, execute este comando:

gcloud container clusters update example-cluster \
  --zone us-central1-a \
  --node-locations us-central1-a,us-central1-b

Console

Para adicionar ou remover zonas em um cluster atual, execute as seguintes etapas:

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

   Acessar o Google Kubernetes Engine

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

3. No campo Zonas de nós padrão na guia "Detalhes", clique em Editar pools de nós.

4. Selecione as zonas desejadas e salve as alterações.

Como alterar as zonas para clusters regionais

Atualmente, só é possível alterar as zonas dos clusters regionais atuais usando o comando gcloud.

Para adicionar ou remover zonas de um cluster regional, use o comando gcloud container clusters update com a sinalização --region:

gcloud container clusters update CLUSTER_NAME \
  --region COMPUTE_REGION \
  --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Substitua:

• CLUSTER_NAME: o nome do cluster.
• COMPUTE_REGION: é a região em que o cluster é executado.
• COMPUTE_ZONE e COMPUTE_ZONE1,[...]: a zona do plano de controle em que os nós são criados. As zonas precisam estar no mesmo COMPUTE_REGION que os planos de controle do cluster, especificados pela sinalização --region.

Observação: em --node-locations, não coloque espaços entre as zonas.

Por exemplo, example-cluster é executado em us-central1-a e us-central1-b. Para adicionar us-central1-c, você executaria este comando:

gcloud container clusters update example-cluster \
  --region us-central1 \
  --node-locations us-central1-a,us-central1-b,us-central1-c

Como outro exemplo, example-cluster é executado em us-central1-a, us-central1-b e us-central1-c. Se você quiser que o cluster seja executado apenas em us-central1-a e us-central1-b, execute este comando:

gcloud container clusters update example-cluster \
  --region us-central1 \
  --node-locations us-central1-a,us-central1-b

Como redimensionar clusters

É possível redimensionar um cluster padrão para aumentar ou diminuir o número de nós. Por exemplo, se você quiser impedir o cluster de consumir recursos sem excluí-lo, será possível redimensionar os nós para zero. Para saber mais sobre isso, consulte Como redimensionar um cluster.

Os clusters de Autopilot são dimensionados automaticamente com base nas especificações do pod, portanto, o redimensionamento do cluster não é algo com que você precise se preocupar. Por exemplo, se você alterar o número de réplicas do pod ou os recursos solicitados, o cluster será ampliado ou reduzido de maneira adequada.

Se você quiser uma maneira mais eficiente de otimizar os clusters, também é possível usar o Escalonamento automático do pod vertical (VPA, na sigla em inglês). O escalonador automático recomenda valores para essas solicitações e limites ou atualiza automaticamente os valores.

Como excluir clusters

Quando necessário, é possível excluir um cluster. Para saber mais, consulte Como excluir um cluster.

Como adicionar clusters a uma frota

Caso sua organização use vários clusters, simplifique o gerenciamento de vários clusters adicionando-os a uma frota: um agrupamento lógico de clusters do Kubernetes. Criar uma frota ajuda sua organização a melhorar o gerenciamento de clusters individuais para grupos inteiros de clusters e permite usar recursos ativados para frotas, como Ingress de vários clusters, Config Sync e Controlador de Políticas.

É possível adicionar clusters do GKE a uma frota usando o console do Google Cloud, a CLI gcloud ou de maneira declarativa usando o Terraform ou o Config Connector.

Saiba mais sobre como as frotas funcionam no Gerenciamento de frotas e sobre a criação delas em Criar frotas para simplificar o gerenciamento de vários clusters.

A seguir

• Veja como os clusters funcionam.
• Saiba como adicionar e gerenciar os pools de nós dos clusters.
• Práticas recomendadas para fazer upgrade de clusters.