Obtenir une visibilité sur les mises à niveau de cluster

Cette page explique comment obtenir des informations sur les mises à niveau de vos clusters Google Kubernetes Engine (GKE). GKE met automatiquement à niveau tous les clusters au fil du temps. Lorsque GKE met à niveau un cluster, il met à jour la version du plan de contrôle Kubernetes et des nœuds de calcul dans des opérations distinctes.

GKE regroupe des informations sur les mises à niveau des clusters pour vous aider à mieux comprendre l'état de votre cluster. Vous pouvez obtenir les informations suivantes pour un cluster :

• Cibles de mise à niveau automatique : découvrez les nouvelles versions que GKE cible pour votre cluster (il peut s'agir de correctifs ou de nouvelles versions mineures), en fonction de la version existante et des contraintes de votre cluster. Si aucune cible de mise à niveau automatique n'est disponible, si le cluster est déjà sur la dernière cible de mise à niveau ou si GKE n'a pas attribué de cible de mise à niveau automatique pour des raisons techniques ou commerciales. Vous pouvez également récupérer les cibles de mise à niveau automatique générales en fonction de la version mineure d'un cluster dans les notes de version GKE Mises à jour des versions, comme la note 2024-R33.
• État de la mise à niveau automatique : les clusters GKE ont un état pour les mises à niveau de cluster. Utilisez cet état pour en savoir plus sur les mises à niveau en cours et sur les contraintes que GKE prend en compte lorsqu'il choisit le moment où mettre à niveau automatiquement votre cluster. Cela inclut des facteurs tels que les exclusions de maintenance ou les raisons empêchant les mises à niveau. Pour en savoir plus, consultez État de la mise à niveau automatique du cluster.

• Historique des mises à niveau : GKE fournit un aperçu des mises à niveau récentes du plan de contrôle et des nœuds de votre cluster, y compris les mises à niveau automatiques et manuelles. Pour les mises à niveau récentes du plan de contrôle et des nœuds, vous pouvez consulter des informations telles que les suivantes :

  • Versions : version initiale et version cible.
  • État : indique si la migration est toujours en cours, ou si elle a réussi, échoué ou été annulée.
  • Heure : heure de début et de fin.
  • Type de démarrage : indique si la mise à niveau a été déclenchée automatiquement ou manuellement.

• Dates de fin de compatibilité : GKE est compatible avec les versions mineures pendant 24 mois maximum. Pour en savoir plus, consultez le cycle de vie d'une version mineure GKE. Pour connaître les dates de fin de la période d'assistance pour toutes les versions mineures actuelles, consultez le calendrier estimé des canaux de publication.

• Événements de cluster : GKE envoie des notifications de cluster à Cloud Logging pour certains événements, par exemple lorsque des mises à niveau commencent ou se terminent, lorsque de nouvelles versions sont disponibles, pour les bulletins de sécurité et les dates de fin de prise en charge. En plus de la surface GKE de ces événements automatiquement avec Cloud Logging, vous pouvez également les router vers Pub/Sub. Pour en savoir plus, consultez Notifications de cluster.

Avant de commencer

Avant de commencer, effectuez les tâches suivantes :

• Activez l'API Google Kubernetes Engine.
Activer l'API Google Kubernetes Engine
• Si vous souhaitez utiliser Google Cloud CLI pour cette tâche, installez puis initialisez gcloud CLI. Si vous avez déjà installé gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande gcloud components update.

Obtenir des informations sur les mises à niveau d'un cluster

Vous pouvez obtenir des informations sur les mises à niveau d'un cluster à l'aide de la consoleGoogle Cloud ou de gcloud CLI.

Obtenir des informations sur les mises à niveau au niveau du projet

Pour obtenir des informations agrégées sur les mises à niveau de cluster dans un projet, vous pouvez utiliser le tableau de bord Mises à niveau.

Dans la console Google Cloud , accédez au tableau de bord Mises à niveau :

Accéder à Mises à niveau

Les onglets de ce tableau de bord regroupent des informations pertinentes sur les mises à niveau, par exemple :

• États des mises à niveau récentes du plan de contrôle et des nœuds
• Journaux de notifications de mise à niveau des clusters
• Recommandations liées aux mises à niveau
• Calendrier de fin de l'assistance pour des versions mineures spécifiques
• Nombre de clusters dans chaque version disponible

Obtenir des informations sur les mises à niveau au niveau du cluster

gcloud container clusters get-upgrade-info CLUSTER_NAME

Obtenir des informations sur les mises à niveau des pools de nœuds de cluster standard

Vous pouvez obtenir de la visibilité sur les pools de nœuds individuels pour les clusters standards. Cette section ne s'applique pas aux clusters Autopilot, où GKE gère les nœuds. Vous n'avez donc pas de pools de nœuds à gérer.

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

État de la mise à niveau automatique du cluster

Voici les états possibles des mises à niveau automatiques pour un cluster :

• ACTIVE : état de mise à niveau actif.
• UNKNOWN : l'état de la mise à niveau est inconnu.
• MINOR_UPGRADE_PAUSED : les mises à niveau de versions mineures sont suspendues.
• UPGRADE_PAUSED : toutes les mises à niveau automatiques sont suspendues.

Voici les raisons potentielles pour lesquelles GKE suspend les mises à niveau automatiques d'un cluster :

• MAINTENANCE_WINDOW : un intervalle de maintenance empêche la mise à niveau du cluster.
• MAINTENANCE_EXCLUSION_ : un motif de suspension avec ce préfixe indique qu'une exclusion de maintenance empêche la mise à niveau du cluster. Le suffixe indique le champ d'application de l'exclusion de maintenance, tel que MAINTENANCE_EXCLUSION_NO_UPGRADES.
• CLUSTER_DISRUPTION_BUDGET : Après certaines opérations, telles que la création ou la mise à niveau d'un cluster, les clusters nécessitent une période de refroidissement pour protéger la stabilité et la disponibilité du cluster et de ses applications.
• CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE : le cluster ne respecte pas le budget d'interruption de cluster pour les mises à niveau de version mineure.
• SYSTEM_CONFIG : les mises à niveau automatiques sont temporairement suspendues pour des raisons techniques ou commerciales. Avec cet état, nous vous recommandons de ne pas effectuer de mise à niveau manuelle, sauf si cela est nécessaire.
• AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED : motif non spécifié.

Obtenir des informations sur les scénarios courants de mise à niveau des clusters

Trouvez des informations sur les scénarios courants que vous pouvez rencontrer lors de la gestion des mises à niveau de cluster.

Savoir quand la prochaine mise à niveau de votre cluster aura lieu

Pour savoir quand vous pouvez vous attendre à la prochaine mise à niveau de votre cluster afin de la planifier et de la qualifier pour la nouvelle version, consultez les ressources suivantes :

• Calendrier de publication : dans le calendrier estimé des canaux de publication, recherchez la date de mise à niveau automatique estimée qui correspond à la version mineure et au version disponible de votre cluster.
• Obtenir des informations sur les mises à niveau au niveau du cluster : trouvez la version cible de la mise à niveau automatique de votre cluster.
• Notifications de cluster : GKE envoie une notification lorsqu'une nouvelle version devient disponible dans un canal. Lorsqu'une nouvelle version est disponible (le délai dépend du canal), GKE la désigne comme cible de mise à niveau automatique dans le canal. Pour afficher ces notifications, filtrez sur UpgradeAvailableEvent lorsque vous affichez les notifications de cluster dans Cloud Logging.
• Notes de version : consultez les notes de version pour savoir quand GKE définit la nouvelle version mineure comme cible de mise à niveau automatique dans le canal.

Identifier ce qui bloque la prochaine mise à niveau de votre cluster

Pour savoir ce qui bloque une mise à niveau et pouvoir la débloquer, consultez l'état de la mise à niveau automatique de votre cluster. Si les mises à niveau automatiques sont suspendues, consultez la raison. Pour ce faire, utilisez une des méthodes suivantes :

• Obtenir des informations sur les mises à niveau au niveau du projet (preview) Cliquez sur l'onglet Mises à niveau, où vous pouvez voir le tableau États des mises à niveau. Recherchez votre cluster dans le tableau et consultez la colonne Mise à niveau automatique du cluster.
• Obtenez des informations sur les mises à niveau au niveau du cluster pour connaître l'état de la mise à niveau automatique de votre cluster.

Savoir quand la mise à niveau de votre cluster sera terminée

Pour savoir quand les mises à niveau du plan de contrôle et des nœuds de votre cluster sont terminées afin de pouvoir vérifier que vos charges de travail fonctionnent comme prévu, utilisez les ressources suivantes :

• Notifications de cluster : GKE envoie une notification lorsqu'il termine une opération de mise à niveau d'un cluster. Pour afficher ces notifications, filtrez sur UpgradeInfoEvent lorsque vous affichez les notifications de cluster dans Cloud Logging.
• Tableau de bord des mises à niveau (aperçu) : accédez au tableau États des mises à niveau dans la consoleGoogle Cloud . Recherchez votre cluster. Si la colonne État indique Mise à niveau effectuée, consultez la colonne Dernière mise à jour pour savoir quand la mise à niveau a été effectuée.
• Obtenir des informations sur les mises à niveau au niveau du cluster : utilisez gcloud CLI pour consulter l'historique des mises à niveau de votre cluster, y compris les mises à niveau récentes.

Déterminer la durée de la mise à niveau

Pour savoir combien de temps devrait prendre votre mise à niveau, vous pouvez trouver la durée des mises à niveau précédentes en obtenant des informations sur les mises à niveau au niveau du cluster. Consultez l'historique des mises à niveau pour obtenir des exemples récents.

La durée d'une mise à niveau dépend de la mise à niveau du plan de contrôle ou des nœuds, de la stratégie de mise à niveau, des budgets de perturbation de pods (PDB), des stratégies de maintenance actives et d'autres facteurs.

Savoir quand la version mineure de votre cluster atteindra la fin de la période d'assistance

GKE met automatiquement à niveau les clusters qui exécutent encore des versions mineures après leur date de fin de compatibilité. Pour en savoir plus, consultez Mises à niveau automatiques à la fin de la période d'assistance.

Pour savoir quand la version mineure de votre cluster arrive en fin de vie (par exemple, pour définir une exclusion de maintenance ou comprendre quand les API obsolètes ne seront plus utilisables), consultez les ressources suivantes :

• Calendrier de publication : dans le calendrier estimé des canaux de publication, recherchez la date de fin de l'assistance qui correspond à la version mineure et version disponible de votre cluster. Pour les clusters qui ne sont pas dans le canal étendu, consultez la date de fin de l'assistance standard. Pour les clusters du canal étendu, consultez la date de fin de la période d'assistance étendue.
• Notifications de cluster : GKE envoie une notification lorsqu'un cluster exécute une version mineure en fin de vie ou presque. Pour afficher ces notifications, filtrez sur UpgradeInfoEvent lorsque vous affichez les notifications de cluster dans Cloud Logging.
• Insights et recommandations : GKE vous informe lorsque votre cluster exécute une version mineure après la fin de la période d'assistance standard. Pour en savoir plus, consultez Identifier les clusters exécutant une version mineure dont le support standard est terminé.
• Obtenir des informations sur les mises à niveau au niveau du cluster : trouvez la date de fin de la compatibilité de la version mineure de votre cluster.
• Tableau de bord "Mises à niveau" (version bêta) : le tableau de bord Mises à niveau inclut une section Fin de la compatibilité des versions qui indique les versions spécifiques et le nombre de jours restants avant la fin de leur compatibilité.

Étapes suivantes

• Calendrier des versions GKE
• Notes de version de GKE
• Notifications de cluster