Préparez-vous aux mises à niveau de Kubernetes version grâce à des informations sur le cluster

Les informations sur le cluster Amazon EKS fournit des recommandations pour vous aider à suivre les bonnes pratiques Amazon EKS et Kubernetes. Chaque cluster Amazon EKS est soumis à des contrôles automatiques et récurrents par rapport à une liste d'informations organisée par Amazon EKS. Ces contrôles d'informations sont entièrement gérés par Amazon EKS et proposent des recommandations sur la manière de traiter les éventuels résultats.

Utilisation recommandée des informations sur les clusters :

• Avant de mettre à jour Kubernetes la version de votre cluster, consultez les informations relatives au cluster dans la console EKS.

• Si votre cluster a identifié des problèmes, passez-les en revue et apportez les correctifs appropriés. Les problèmes incluent les liens vers Amazon EKS etKubernetes.

• Après avoir résolu les problèmes, attendez que les informations du cluster soient actualisées. Si tous les problèmes ont été résolus, mettez à jour votre cluster.

Actuellement, Amazon EKS renvoie uniquement des informations relatives à l'état de préparation de la mise à niveau des versions de Kubernetes.

Les informations sur les mises à niveau identifient les problèmes potentiels susceptibles d'avoir un impact sur les mises à niveau des cluster Kubernetes. Cela minimise les efforts que les administrateurs consacrent à la préparation des mises à niveau et augmente la fiabilité des applications sur les nouvelles versions de Kubernetes. Les clusters sont automatiquement analysés par Amazon EKS par rapport à une liste de problèmes susceptibles d'avoir un impact sur la mise à niveau de la version de Kubernetes. Amazon EKS met fréquemment à jour la liste des vérifications des informations en fonction des révisions des modifications apportées à chaque version publiée de Kubernetes.

Les informations de mise à niveau d'Amazon EKS accélèrent le processus de test et de vérification des nouvelles versions. Elles permettent également aux administrateurs de clusters et aux développeurs d'applications de tirer parti des fonctionnalités Kubernetes les plus récentes en mettant en évidence les problèmes et en proposant des conseils pour y remédier. Pour consulter la liste des vérifications d'informations effectuées et les éventuels problèmes pertinents identifiés par Amazon EKS, vous pouvez appeler l'API ListInsights Amazon EKS ou consulter la console Amazon EKS.

Les informations sur les clusters sont mises à jour régulièrement. Vous ne pouvez pas actualiser manuellement les informations du cluster. Si vous corrigez un problème de cluster, la mise à jour des informations sur le cluster prendra un certain temps. Pour déterminer si un correctif a réussi, comparez l'heure à laquelle la modification a été déployée à la « date de dernière actualisation » de l'aperçu du cluster.

Afficher les informations relatives au cluster (console)

Pour consulter les informations d'un cluster Amazon EKS :

1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

2. Dans la liste de clusters, choisissez le nom du cluster Amazon EKS pour lequel vous souhaitez obtenir des informations.

3. Choisissez l'onglet Mettre à niveau les informations.

4. Sur la page Mettre à niveau les informations, vous verrez les champs suivants :

   • Nom : vérification effectuée par Amazon EKS par rapport au cluster.

   • Statut des informations : une information dont le statut est « Erreur » signifie généralement que la version Kubernetes affectée est N+1 de la version actuelle du cluster, tandis qu'un statut « Avertissement » signifie que l'information s'applique à une future version Kubernetes N+2 ou plus. Une information dont le statut est « Réussi » signifie qu'Amazon EKS n'a détecté aucun problème associé à cette vérification d'informations dans votre cluster. Une information dont le statut est « Inconnu » signifie qu'Amazon EKS n'est pas en mesure de déterminer si votre cluster est concerné par cette vérification des informations.

   • Version : la version Kubernetes vérifiée par l'analyse pour détecter d'éventuels problèmes.

   • Heure de la dernière actualisation (UTC-5:00) : heure à laquelle le statut de l'information a été actualisé pour la dernière fois pour ce cluster.

   • Heure de la dernière transition (UTC -5:00) : heure à laquelle le statut de cette information a été modifié pour la dernière fois.

   • Description : informations provenant de la vérification des informations, qui incluent l'alerte et les mesures correctives recommandées.

Afficher les informations sur le cluster (AWS CLI)

Pour consulter les informations d'un cluster Amazon EKS :

1. Déterminez le cluster que vous souhaitez vérifier pour obtenir des informations. La commande suivante répertorie les information d'un cluster spécifique. Si nécessaire, apportez les modifications suivantes à la commande, puis exécutez la commande modifiée :

   • Remplacez region-code par le code de votre Région AWS.

   • Remplacez my-cluster par le nom de votre cluster.

   aws eks list-insights --region region-code --cluster-name my-cluster
   

   L'exemple qui suit illustre un résultat.

   {
       "insights": [
           {
               "category": "UPGRADE_READINESS", 
               "name": "Deprecated APIs removed in Kubernetes v1.29", 
               "insightStatus": {
                   "status": "PASSING", 
                   "reason": "No deprecated API usage detected within the last 30 days."
               }, 
               "kubernetesVersion": "1.29", 
               "lastTransitionTime": 1698774710.0, 
               "lastRefreshTime": 1700157422.0, 
               "id": "123e4567-e89b-42d3-a456-579642341238", 
               "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes v1.29. Upgrading your cluster before migrating to the updated APIs supported by v1.29 could cause application impact."
           }
       ]
   }

2. Pour obtenir une description des informations, exécutez la commande suivante. Si nécessaire, apportez les modifications suivantes à la commande, puis exécutez la commande modifiée :

   • Remplacez region-code par le code de votre Région AWS.

   • Remplacez 123e4567-e89b-42d3-a456-579642341238 par l'ID d'information extrait de la liste des informations du cluster.

   • Remplacez my-cluster par le nom de votre cluster.

   aws eks describe-insight --region region-code --id 123e4567-e89b-42d3-a456-579642341238 --cluster-name my-cluster
   

   L'exemple qui suit illustre un résultat.

   {
       "insight": {
           "category": "UPGRADE_READINESS", 
           "additionalInfo": {
               "EKS update cluster documentation": "https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html", 
               "Kubernetes v1.29 deprecation guide": "https://kubernetes.io/docs/reference/using-api/deprecation-guide/#v1-29"
           }, 
           "name": "Deprecated APIs removed in Kubernetes v1.29", 
           "insightStatus": {
               "status": "PASSING", 
               "reason": "No deprecated API usage detected within the last 30 days."
           }, 
           "kubernetesVersion": "1.29", 
           "recommendation": "Update manifests and API clients to use newer Kubernetes APIs if applicable before upgrading to Kubernetes v1.29.", 
           "lastTransitionTime": 1698774710.0, 
           "lastRefreshTime": 1700157422.0, 
           "categorySpecificSummary": {
               "deprecationDetails": [
                   {
                       "usage": "/apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas", 
                       "replacedWith": "/apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas", 
                       "stopServingVersion": "1.29", 
                       "clientStats": [], 
                       "startServingReplacementVersion": "1.26"
                   }, 
                   {
                       "usage": "/apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations", 
                       "replacedWith": "/apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations", 
                       "stopServingVersion": "1.29", 
                       "clientStats": [], 
                       "startServingReplacementVersion": "1.26"
                   }
               ]
           }, 
           "id": "f6a11fe4-77f7-48c6-8326-9a13f022ecb3", 
           "resources": [], 
           "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes v1.29. Upgrading your cluster before migrating to the updated APIs supported by v1.29 could cause application impact."
       }
   }