Ter visibilidade dos upgrades de cluster

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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:

• Destinos de upgrade automático: encontre quais novas versões o GKE está visando 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 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 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 upgrade: o GKE fornece um resumo das atualizações recentes do plano de controle e do nó do cluster, incluindo upgrades automáticos e manuais. Para upgrades recentes de nó e plano de controle, você pode conferir detalhes como estes:

  • Versões: a versão inicial e a versão de destino.
  • Estado: se o upgrade ainda está em execução, se foi bem-sucedido, 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 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.

• Eventos de 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, você também pode encaminhar 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 do Google Cloud ou a gcloud CLI.

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 do Google Cloud, acesse o painel Upgrades:

Acessar "Upgrades"

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

• Status dos upgrades recentes do plano de controle e do nó
• Registros de notificação de cluster para upgrades
• 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 upgrades 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 padrão

É possível 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, 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 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 estão pausados.

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

• MAINTENANCE_WINDOW: uma janela de manutenção está impedindo upgrades do cluster.
• MAINTENANCE_EXCLUSION_: um motivo de pausa 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.
• AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: um motivo não especificado.

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

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

Descubra quando será a próxima atualização do cluster

Para saber quando esperar o próximo upgrade do cluster e poder 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 cluster.
• Receber informações de upgrades no nível do cluster: encontre o destino 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 UpgradeAvailableEvent ao acessar notificações de cluster no Cloud Logging.
• Notas de lançamento: siga as notas de lançamento para saber quando o GKE define a nova versão secundária como um destino de upgrade automático no canal.

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

Para saber o que está bloqueando um upgrade e desbloqueá-lo, encontre o status de 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é-lançamento). Clique na guia Upgrades, onde você pode conferir a tabela Upgrade statuses. Procure o cluster na tabela e confira a coluna Autoupgrade.
• Conferir 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 for concluído

Para saber quando os upgrades do plano de controle e do nó do cluster sã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 para fazer upgrade de um cluster. Para conferir essas notificações, filtre UpgradeInfoEvent ao acessar as notificações do cluster no Cloud Logging.
• Painel de upgrades (pré-lançamento): acesse a tabela Upgrade statuses no console do Google Cloud. Encontre seu cluster. Se a coluna Status mostrar Upgraded, consulte a coluna Latest update para saber quando o upgrade foi concluído.
• Receber informações de upgrades no nível do cluster: use a CLI gcloud para encontrar o histórico de upgrade do cluster, que inclui upgrades recentes.

Descubra quanto tempo o upgrade levará

Para saber quanto tempo o upgrade vai levar, você pode encontrar a duração de upgrades anteriores conferindo informações de upgrades no nível do cluster. Confira o histórico de upgrade para ver exemplos recentes.

A duração de um upgrade depende 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 pod (PDBs, na sigla em inglês), 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 o upgrade automático de clusters que ainda executam 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 cluster atinge o fim do suporte, por exemplo, para definir uma exclusão de manutenção ou entender quando as APIs descontinuadas 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 estendido, consulte a data de fim do suporte padrão. Para clusters no canal estendido, 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 próximo dele. Para conferir essas notificações, filtre por UpgradeInfoEvent ao acessar as 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 menor após o fim do suporte padrão.
• Receber informações de upgrades no nível do cluster: encontre a data de fim do suporte da versão secundária do cluster.
• Painel "Upgrades" (pré-lançamento): o painel Upgrades inclui uma seção Fim do suporte à 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