Ter visibilidade dos upgrades de cluster

Nesta página, explicamos como receber informações sobre upgrades dos seus clusters do Google Kubernetes Engine (GKE). O GKE faz upgrade automático de todos os clusters com o 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:

• Destinos de upgrade automático: descubra quais novas versões o GKE está direcionando 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á estiver no destino de upgrade mais recente ou o GKE não tiver atribuído um destino de upgrade automático por motivos técnicos ou comerciais. 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 nota 2024-R33.
• Status do 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 upgrade automático do cluster, incluindo fatores como exclusões de manutenção ou motivos que impedem upgrades. Para saber mais, consulte Status do upgrade automático do cluster.

• Histórico de upgrades: o GKE fornece um instantâneo dos upgrades recentes do plano de controle e dos nós do cluster, incluindo upgrades automáticos e manuais. Para upgrades recentes de nós e planos de controle, é possível conferir detalhes como:

  • Versões: a versão inicial e a de destino.
  • Estado: indica se o upgrade ainda está em execução ou se foi concluído, falhou ou foi cancelado.
  • Horário: o horário de início e término.
  • Tipo de início: se o upgrade foi acionado automaticamente ou manualmente.

• Datas de fim 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 conferir as datas de fim do suporte de todas as versões secundárias atuais, consulte a Programação estimada para canais de lançamento.

• Eventos do cluster: o GKE envia notificações de cluster para o Cloud Logging em determinados eventos, como quando os upgrades começam ou são concluídos, quando novas versões estão disponíveis, boletins de segurança e datas de fim do suporte. Além de o GKE mostrar esses eventos automaticamente com o Cloud Logging, também é possível rotear essas notificações para o Pub/Sub. Para saber mais, consulte Notificações de cluster.

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 sobre upgrades no nível do projeto

Para receber informações agregadas sobre upgrades de cluster em um projeto, use o painel Upgrades.

No console Google Cloud , acesse o painel Atualizações:

Acessar "Upgrades"

As guias incluídas neste painel agregam informações relevantes sobre upgrades, como:

• Status dos upgrades recentes do plano de controle e dos nós
• Registros de notificações de upgrade do cluster
• Recomendações relacionadas a upgrades
• Cronogramas de fim do suporte para versões secundárias específicas
• O número de clusters em cada canal de lançamento

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

gcloud container clusters get-upgrade-info CLUSTER_NAME

Receber informações de upgrade para pools de nós de cluster Standard

É possível ter visibilidade dos 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, então não há pools de nós para você gerenciar.

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

Status do upgrade automático do cluster

Confira a seguir os possíveis status dos 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 estão pausados.
• UPGRADE_PAUSED: todos os upgrades automáticos estão pausados.

Confira a seguir os possíveis motivos para o GKE pausar os upgrades automáticos de um cluster:

• MAINTENANCE_WINDOW: uma janela de manutenção está impedindo os upgrades do cluster.
• MAINTENANCE_EXCLUSION_: um motivo de pausa com esse prefixo indica que uma exclusão de manutenção está impedindo os upgrades do cluster. O sufixo indica o escopo da exclusão de manutenção, como MAINTENANCE_EXCLUSION_NO_UPGRADES.
• CLUSTER_DISRUPTION_BUDGET: após algumas 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 aplicativos dele.
• CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: o cluster está fora do orçamento de interrupção do cluster para upgrades de versão secundária.
• 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.
• AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: um motivo não especificado.

Encontrar informações sobre cenários comuns para upgrades de cluster

Encontre informações sobre cenários comuns que podem ocorrer ao gerenciar upgrades de cluster.

Descobrir quando esperar o próximo upgrade do cluster

Para saber quando esperar o próximo upgrade do cluster e planejar e qualificar o upgrade para a nova versão, use os seguintes recursos:

• Programação de lançamento: na programação estimada para canais de lançamento, encontre a data estimada de upgrade automático que corresponde à versão secundária e ao canal de lançamento do seu cluster.
• Receber informações de upgrade no nível do cluster: encontre a meta de upgrade automático do cluster.
• Notificações de cluster: o GKE envia uma notificação quando uma nova versão fica disponível em um canal. Depois que uma nova versão fica disponível, com o tempo dependendo do canal, o GKE designa a versão como um destino de upgrade automático no canal. Para conferir essas notificações, filtre por UpgradeAvailableEvent ao visualizar notificações de cluster no Cloud Logging.
• Notas da versão: siga as notas da versão para saber quando o GKE define a nova versão secundária como um destino de upgrade automático no canal.

Encontre o que está bloqueando o próximo upgrade do cluster

Para saber o que está bloqueando um upgrade e como desbloqueá-lo, encontre o status do upgrade automático do cluster. Se os upgrades automáticos estiverem pausados, confira o motivo. Use um dos seguintes métodos:

• Receba informações de upgrades no nível do projeto (prévia). Clique na guia Upgrades, onde você pode ver a tabela Status do upgrade. Procure seu cluster na tabela e confira a coluna Atualização automática.
• Receba informações de upgrade no nível do cluster para encontrar o status de upgrade automático do cluster.

Descobrir quando o upgrade do cluster será concluído

Para saber quando o plano de controle e os upgrades de nós do cluster serão concluídos e verificar se as cargas de trabalho estão funcionando conforme o esperado, use os seguintes recursos:

• Notificações de cluster: o GKE envia uma notificação quando conclui uma operação de upgrade de um cluster. Para ver essas notificações, filtre o UpgradeInfoEvent ao acessar as notificações de cluster no Cloud Logging.
• Painel de upgrades (prévia): acesse a tabela Status do upgrade no consoleGoogle Cloud . Encontre seu cluster. Se a coluna Status mostrar Upgrade concluído, consulte a coluna Última atualização para saber quando o upgrade foi concluído.
• Receber informações de upgrade no nível do cluster: use a CLI gcloud para encontrar o histórico de upgrade do cluster, que inclui upgrades recentes.

Descobrir quanto tempo o upgrade deve levar

Para saber quanto tempo o upgrade deve levar, receba informações sobre upgrades no nível do cluster. Confira o histórico de upgrades para ver exemplos recentes.

A duração de um upgrade depende de se o plano de controle ou os nós estão sendo atualizados, da estratégia de upgrade, dos orçamentos de interrupção de pods (PDBs), das políticas de manutenção ativas e de outros fatores.

Descobrir quando a versão secundária do cluster chega ao fim do suporte

O GKE faz upgrade automático dos clusters que ainda estão executando versões secundárias após a data de fim do suporte. Para mais informações, consulte Upgrades automáticos no fim do suporte.

Para saber quando a versão secundária do seu cluster vai atingir o fim do suporte (por exemplo, para definir uma exclusão de manutenção ou entender quando as APIs suspensas não poderão mais ser usadas), use os seguintes recursos:

• Programação de lançamento: na programação estimada para canais de lançamento, encontre a data de fim de suporte que corresponde à versão secundária e ao canal de lançamento do cluster. Para clusters que não estão no canal Extended, consulte a data de fim do suporte padrão. Para clusters no canal Extended, consulte a data de fim do suporte estendido.
• Notificações de cluster: o GKE envia uma notificação quando um cluster executa uma versão secundária no fim do suporte ou perto dele. Para conferir essas notificações, filtre por UpgradeInfoEvent ao visualizar notificações de cluster no Cloud Logging.
• Insights e recomendações: o GKE informa quando o cluster está executando uma versão secundária após o fim do suporte padrão. Para mais informações, consulte Identificar clusters que executam uma versão secundária após o fim do suporte padrão.
• Receba informações sobre upgrades no nível do cluster: encontre a data de fim do suporte da versão secundária do cluster.
• Painel de upgrades (prévia): o painel Upgrades inclui uma seção Fim do suporte da versão com versões específicas e os dias restantes até o fim do suporte.

A seguir

• Programação de lançamentos do GKE
• Notas da versão do GKE
• Notificações de cluster