Obtenha visibilidade das atualizações de clusters

Esta página explica como pode obter informações sobre atualizações para os seus clusters do Google Kubernetes Engine (GKE). O GKE atualiza automaticamente todos os clusters ao longo do tempo. Quando o GKE atualiza um cluster, o GKE atualiza a versão do painel de controlo do Kubernetes e os nós de trabalho em operações separadas.

O GKE agrega informações sobre as atualizações de clusters para ajudar a compreender melhor o estado do seu cluster. Pode obter as seguintes informações para um cluster:

• Alvos de atualização automática: descubra que novas versões o GKE está a segmentar para o seu cluster, que podem ser patches ou novas versões secundárias, consoante a versão e as restrições existentes do cluster. Se não existir um destino de atualização automática, o cluster já está no destino de atualização mais recente ou o GKE não atribuiu um destino de atualização automática por motivos técnicos ou empresariais. Também pode obter alvos de atualização automática gerais 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.
• Estado da atualização automática: os clusters do GKE têm um estado para as atualizações de clusters. Use este estado para saber mais sobre as atualizações atuais e as restrições que o GKE considera ao escolher quando atualizar automaticamente o cluster, incluindo fatores como exclusões de manutenção ou motivos que impedem as atualizações. Para saber mais, consulte o estado da atualização automática do cluster.

• Histórico de atualizações: o GKE fornece uma vista geral das atualizações recentes do painel de controlo e das atualizações de nós do seu cluster, incluindo atualizações automáticas e manuais. Para atualizações recentes do plano de controlo e dos nós, pode ver detalhes como os seguintes:

  • Versões: a versão inicial e a versão de destino.
  • Estado: indica se a atualização ainda está em execução ou se foi bem-sucedida, falhou ou foi cancelada.
  • Hora: a hora de início e de fim.
  • Tipo de início: se a atualização foi acionada automaticamente ou manualmente.

• Datas de fim do suporte: o GKE suporta versões secundárias durante um período máximo de 24 meses. Para saber mais, consulte o ciclo de vida da versão secundária do GKE. Para ver as datas de fim do suporte de todas as versões secundárias atuais, consulte o cronograma estimado dos canais de lançamento.

• Eventos de cluster: o GKE envia notificações de cluster para o Cloud Logging para determinados eventos, como quando as atualizações são iniciadas ou concluídas, quando estão disponíveis novas versões, boletins de segurança e datas de fim do suporte técnico. Além de o GKE apresentar estes eventos automaticamente com o Cloud Logging, também pode encaminhar estas notificações para o Pub/Sub. Para saber mais, consulte o artigo Agrupe notificações.

Antes de começar

Antes de começar, certifique-se de que realizou as seguintes tarefas:

• Ative a API Google Kubernetes Engine.
Ative a API Google Kubernetes Engine
• Se quiser usar a CLI gcloud para esta tarefa, instale-a e, em seguida, inicialize-a. Se instalou anteriormente a CLI gcloud, execute gcloud components update para obter a versão mais recente.

Receba informações sobre as atualizações de um cluster

Pode obter informações sobre as atualizações de um cluster através da Trusted Cloud consola ou da CLI gcloud.

Receba informações sobre atualizações ao nível do projeto

Para obter informações agregadas sobre as atualizações de clusters num projeto, pode usar o painel de controlo Atualizações.

Na Trusted Cloud consola, aceda ao painel de controlo Atualizações:

Aceda a Atualizações

Os separadores incluídos neste painel de controlo agregam informações relevantes sobre as atualizações, como as seguintes:

• Estados das atualizações recentes do painel de controlo e dos nós
• Registos de notificações de clusters para atualizações
• Recomendações relacionadas com atualizações
• Linhas cronológicas do fim do suporte para versões secundárias específicas
• O número de clusters em cada canal de lançamento

Receba informações de atualizações ao nível do cluster

gcloud container clusters get-upgrade-info CLUSTER_NAME

Receba informações de atualizações para node pools de clusters Standard

Pode obter visibilidade dos conjuntos de nós individuais para clusters padrão. Esta secção não se aplica a clusters do Autopilot, em que o GKE gere os nós, pelo que não existem node pools para gerir.

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

Estado da atualização automática do cluster

Seguem-se os potenciais estados das atualizações automáticas para um cluster:

• ACTIVE: um estado de atualização ativo.
• UNKNOWN: o estado da atualização é desconhecido.
• MINOR_UPGRADE_PAUSED: as atualizações de versões secundárias estão pausadas.
• UPGRADE_PAUSED: Todas as atualizações automáticas estão em pausa.

Seguem-se os potenciais motivos pelos quais o GKE pausa as atualizações automáticas de um cluster:

• MAINTENANCE_WINDOW: um período de manutenção está a impedir as atualizações do cluster.
• MAINTENANCE_EXCLUSION_: um motivo de pausa com este prefixo indica que uma exclusão de manutenção está a impedir as atualizações do cluster. O sufixo indica o âmbito da exclusão de manutenção, como MAINTENANCE_EXCLUSION_NO_UPGRADES.
• CLUSTER_DISRUPTION_BUDGET: Após determinadas operações, como a criação ou as atualizações de clusters, os clusters requerem um período de repouso para proteger a estabilidade e a disponibilidade do cluster e das respetivas aplicações.
• CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: o cluster está fora do orçamento de interrupção do cluster para atualizações de versões secundárias.
• SYSTEM_CONFIG: as atualizações automáticas estão temporariamente pausadas por motivos técnicos ou empresariais. Com este estado, recomendamos que não faça uma atualização manual, a menos que seja necessário.
• AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: Um motivo não especificado.

Encontre informações sobre cenários comuns para atualizações de clusters

Encontre informações sobre cenários comuns que pode encontrar ao gerir atualizações de clusters.

Saiba quando esperar a próxima atualização do seu cluster

Para saber quando esperar a próxima atualização do cluster, de modo a poder planear e qualificar a atualização para a nova versão, use os seguintes recursos:

• Cronograma de lançamento: no cronograma estimado para os canais de lançamento, encontre a data de atualização automática estimada que corresponde à versão secundária e ao canal de lançamento do seu cluster.
• Obtenha informações de atualizações ao nível do cluster: encontre o destino da atualização automática do seu cluster.
• Notificações de clusters: o GKE envia uma notificação quando uma nova versão fica disponível num canal. Depois de uma nova versão ficar disponível, com o tempo a depender do canal, o GKE designa a versão como um destino de atualização automática no canal. Para ver estas notificações, filtre por UpgradeAvailableEvent quando visualizar 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 atualização automática no canal.

Encontre o que está a bloquear a próxima atualização do seu cluster

Para saber o que está a bloquear uma atualização para que possa desbloqueá-la, encontre o estado de atualização automática do cluster. Se as atualizações automáticas estiverem pausadas, consulte o motivo. Use um dos seguintes métodos:

• Receba informações de atualizações ao nível do projeto (Pré-visualização). Clique no separador Atualizações, onde pode ver a tabela Estados das atualizações. Procure o seu cluster na tabela e veja a coluna Atualização automática do cluster.
• Obtenha informações de atualizações ao nível do cluster para encontrar o estado de atualização automática do seu cluster.

Saiba quando a atualização do cluster é concluída

Para saber quando as atualizações do plano de controlo e dos nós do cluster são concluídas, de modo a poder verificar se as cargas de trabalho estão a funcionar conforme esperado, use os seguintes recursos:

• Notificações de clusters: o GKE envia uma notificação quando o GKE conclui uma operação para atualizar um cluster. Para ver estas notificações, filtre por UpgradeInfoEvent quando visualizar as notificações de cluster no Cloud Logging.
• Painel de controlo de atualizações (pré-visualização): aceda à tabela Estados de atualização na Trusted Cloud consola. Encontre o seu cluster. Se a coluna Estado indicar Atualizado, consulte na coluna Última atualização quando a atualização foi concluída.
• Obtenha informações de atualizações ao nível do cluster: use a CLI gcloud para encontrar o histórico de atualizações do seu cluster, que inclui atualizações recentes.

Saiba quanto tempo se espera que a atualização demore

Para saber quanto tempo se prevê que a atualização demore, pode encontrar a duração das atualizações anteriores obtendo informações de atualizações ao nível do cluster. Consulte o histórico de atualizações para ver exemplos recentes.

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

Saiba quando a versão secundária do seu cluster atinge o fim do suporte

O GKE atualiza automaticamente os clusters que ainda estão a executar versões secundárias após a respetiva data de fim do apoio técnico. Para mais informações, consulte o artigo Atualizações automáticas no final do suporte.

Para saber quando a versão secundária do seu cluster atinge o fim do apoio técnico, por exemplo, para definir uma exclusão de manutenção ou compreender quando as APIs descontinuadas deixam de ser utilizáveis, use os seguintes recursos:

• Cronograma de lançamento: no cronograma estimado para os canais de lançamento, encontre a data de fim do suporte técnico que corresponde à versão secundária e ao canal de lançamento do seu cluster. Para clusters que não estão no canal Extended, consulte a data de fim do suporte padrão. Para clusters que estão no canal alargado, consulte a data de fim do suporte alargado.
• Notificações de clusters: o GKE envia uma notificação quando um cluster executa uma versão secundária no final do suporte técnico ou perto do mesmo. Para ver estas notificações, filtre por UpgradeInfoEvent quando visualizar notificações de clusters no Cloud Logging.
• Estatísticas e recomendações: o GKE informa quando o cluster está a executar uma versão secundária após o fim do apoio técnico padrão. Para mais informações, consulte o artigo Identifique clusters que executam uma versão secundária após o fim do apoio técnico padrão.
• Obtenha informações sobre atualizações ao nível do cluster: Encontre a data de fim do apoio técnico da versão secundária do seu cluster.
• Painel de controlo de atualizações (pré-visualização): o painel de controlo de atualizações inclui uma secção Fim do apoio técnico da versão com versões específicas e os respetivos dias restantes até ao fim do apoio técnico.

O que se segue?

• Agenda de lançamentos do GKE
• Notas de lançamento do GKE
• Notificações de clusters