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:

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.

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

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

Esta seção se aplica somente a clusters criados no modo padrão.

Veja nas seções a seguir como adicionar ou remover zonas de 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 \
  --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.

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

Esta seção se aplica somente a clusters criados no modo padrão.

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.

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.

A seguir