Ter visibilidade dos upgrades de cluster

Nesta página, explicamos como receber informações sobre upgrades para seus clusters do Google Kubernetes Engine (GKE). O GKE faz upgrade automático de todos os clusters ao longo do tempo. Quando o GKE faz upgrade de um cluster, ele atualiza a versão do plano de controle do Kubernetes e dos nós de trabalho em operações separadas.

O GKE agrega informações sobre upgrades de cluster para ajudar você a entender melhor o status do cluster. É possível acessar as seguintes informações de um cluster:

  • Alvos de upgrade automático:encontre quais novas versões o GKE está alvejando para seu cluster, que podem ser patches ou novas versões secundárias, dependendo da versão e das restrições atuais do cluster. Se não houver um destino de upgrade automático, o cluster já está na versão mais recente ou o GKE não atribuiu um destino de upgrade automático por motivos técnicos ou de negócios. Também é possível recuperar destinos gerais de upgrade automático com base na versão secundária de um cluster nas notas de lançamento do GKE Atualizações de versão, como a 2024-R33 note.
  • Status de upgrade automático:os clusters do GKE têm um status para upgrades de cluster. Use esse status para saber mais sobre os upgrades atuais e as restrições que o GKE considera ao escolher quando fazer o upgrade automático do cluster, incluindo fatores como exclusões de manutenção ou motivos que impedem upgrades. Para saber mais, consulte Status de upgrade automático do cluster.
  • Histórico de atualização automática:o GKE fornece um resumo das atualizações automáticas recentes do plano de controle e dos nós do cluster. Para upgrades automáticos recentes de nós e planos de controle, você pode conferir a versão inicial, a versão de destino e se o upgrade foi bem-sucedido, falhou ou foi cancelado.
  • Datas de término do suporte:o GKE oferece suporte a versões secundárias por até 24 meses. Para saber mais, consulte o Ciclo de vida da versão secundária do GKE. Para saber as datas de fim do suporte para todas as versões secundárias atuais, consulte a Programação estimada para canais de lançamento.

Antes de começar

Antes de começar, veja se você realizou as seguintes tarefas:

  • Ative 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, em seguida, inicialize a CLI gcloud. Se você instalou a gcloud CLI anteriormente, instale a versão mais recente executando gcloud components update.

Receber informações sobre os upgrades de um cluster

É possível receber informações sobre os upgrades de um cluster usando o console doGoogle Cloud ou a CLI gcloud.

Receber informações de upgrades no nível do cluster

Console

  1. No console do Google Cloud , acesse a página Clusters do Kubernetes.

    Acesse os clusters do Kubernetes

  2. Selecione o nome do cluster para acessar a página Detalhes do cluster.

  3. Na página Detalhes do cluster, consulte a seção Upgrades de cluster.

gcloud

Execute este comando:

gcloud beta container clusters get-upgrade-info CLUSTER_NAME

Substitua CLUSTER_NAME pelo nome do cluster.

Receber informações de upgrade para pools de nós de cluster padrão

É possível usar a CLI gcloud para ter visibilidade em pools de nós individuais para clusters padrão. Esta seção não se aplica aos clusters do Autopilot, em que o GKE gerencia os nós. Portanto, não há pools de nós para você gerenciar.

Execute este comando:

gcloud beta container node-pools get-upgrade-info POOL_NAME
    --cluster CLUSTER_NAME

Substitua POOL_NAME pelo nome do pool de nós.

Status do upgrade automático do cluster

Confira a seguir os possíveis status de upgrades automáticos de um cluster:

  • ACTIVE: um status de upgrade ativo.
  • UNKNOWN: o status do upgrade é desconhecido.
  • MINOR_UPGRADE_PAUSED: os upgrades de versão secundária são pausados.
  • UPGRADE_PAUSED: todos os upgrades automáticos são pausados.

Confira a seguir os possíveis motivos pelos quais o GKE pausa os upgrades automáticos de um cluster:

  • AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: um motivo não especificado.
  • MAINTENANCE_WINDOW: uma janela de manutenção está impedindo upgrades do cluster.
  • MAINTENANCE_EXCLUSION_: um motivo pausado com esse prefixo indica que uma exclusão de manutenção está impedindo upgrades de cluster. O sufixo indica o escopo da exclusão de manutenção, como MAINTENANCE_EXCLUSION_NO_UPGRADES.
  • CLUSTER_DISRUPTION_BUDGET: após determinadas operações, como criação ou upgrades de cluster, os clusters precisam de um período de espera para proteger a estabilidade e a disponibilidade do cluster e dos respectivos aplicativos.
  • CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: o cluster está fora do orçamento de interrupção do cluster para upgrades de versões secundárias.
  • SYSTEM_CONFIG: os upgrades automáticos estão temporariamente pausados por motivos técnicos ou comerciais. Com esse status, recomendamos que você não faça um upgrade manual, a menos que seja necessário.

A seguir