Como gerenciar clusters

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 CLI do Google Cloud para essa tarefa, instale e inicialize a gcloud CLI. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando o comando gcloud components update. Talvez as versões anteriores da CLI gcloud não sejam compatíveis com a execução dos comandos neste documento.

Como ver os clusters

gcloud

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

    gcloud container clusters describe CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

    Substitua:

    • CLUSTER_NAME: o nome do cluster.
    • CONTROL_PLANE_LOCATION: o local do Compute Engine do plano de controle do cluster. Forneça uma região para clusters regionais ou uma zona para clusters zonais.

  • Para listar todos os clusters em um projeto em qualquer região ou zona, execute o seguinte comando:

    gcloud container clusters list

  • Para listar clusters localizados na região ou zona específica, execute o seguinte comando:

    gcloud container clusters list \
    --location=CONTROL_PLANE_LOCATION

Console

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

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.

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 \
  --location CONTROL_PLANE_LOCATION \
  --node-locations COMPUTE_ZONE1,COMPUTE_ZONE2

Substitua:

  • CLUSTER_NAME: o nome escolhido para o cluster.
  • CONTROL_PLANE_LOCATION: a zona do Compute Engine do plano de controle do cluster.
  • COMPUTE_ZONE1,COMPUTE_ZONE2,[...]: 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 --location. Para clusters zonais, --node-locations precisa conter a zona principal do cluster.

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 \
  --location 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 \
  --location 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 do Google Kubernetes Engine no Google Cloud console.

    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 --node-locations:

gcloud container clusters update CLUSTER_NAME \
  --location CONTROL_PLANE_LOCATION \
  --node-locations COMPUTE_ZONE1,COMPUTE_ZONE2

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • CONTROL_PLANE_LOCATION: a região do Compute Engine do plano de controle do cluster.
  • COMPUTE_ZONE1 e COMPUTE_ZONE2,[...]: a zona do plano de controle em que os nós são criados. As zonas precisam estar no mesmo CONTROL_PLANE_LOCATION que os planos de controle do cluster, especificados pela sinalização --location.

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 \
  --location 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 \
  --location 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 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