Preparati agli aggiornamenti di Kubernetes versione con Cluster Insights

Gli approfondimenti sui cluster offerti da Amazon EKS forniscono consigli per aiutare a seguire le best practice di Amazon EKS e Kubernetes. Ogni cluster Amazon EKS è soggetto a controlli automatici e ricorrenti basati su un elenco di approfondimenti curato da Amazon EKS. Questi controlli sugli approfondimenti sono completamente gestiti da Amazon EKS e offrono consigli su come affrontare eventuali esiti.

Utilizzo consigliato di Cluster Insights:

• Prima di aggiornare la Kubernetes versione del cluster, controlla cluster insights nella console EKS.

• Se il tuo cluster ha identificato problemi, esaminali e apporta le correzioni appropriate. I problemi includono collegamenti ad Amazon EKS eKubernetes.

• Dopo aver risolto i problemi, attendi che Cluster Insights si aggiorni. Se tutti i problemi sono stati risolti, aggiorna il cluster.

Attualmente, Amazon EKS restituisce solo approfondimenti riguardanti la disponibilità per l'aggiornamento della versione di Kubernetes.

Gli approfondimenti sugli aggiornamenti identificano possibili problemi che possono influire sugli aggiornamenti del cluster Kubernetes. Questo riduce l'impegno richiesto agli amministratori nella preparazione degli aggiornamenti e aumenta l'affidabilità delle applicazioni sulle versioni più recenti di Kubernetes. I cluster vengono scansionati automaticamente da Amazon EKS in base a un elenco di possibili aggiornamenti di versione di Kubernetes che influiscono sui problemi. Amazon EKS aggiorna frequentemente l'elenco dei controlli sugli approfondimenti in base alle revisioni delle modifiche apportate in ogni versione di Kubernetes.

Gli approfondimenti sugli aggiornamenti offerti da Amazon EKS velocizzano il processo di test e verifica per le nuove versioni. Inoltre, consentono agli amministratori dei cluster e agli sviluppatori di applicazioni di avvalersi delle funzionalità di Kubernetes più recenti, evidenziando eventuali problemi e offrendo consigli per porvi rimedio. Per visualizzare l'elenco dei controlli sugli approfondimenti eseguiti e gli eventuali problemi rilevanti identificati da Amazon EKS, puoi richiamare l'operazione dell'API ListInsights di Amazon EKS o consultare la console Amazon EKS.

Cluster Insights si aggiorna periodicamente. Non è possibile aggiornare manualmente Cluster Insights. Se risolvi un problema relativo al cluster, l'aggiornamento di Cluster Insights richiederà del tempo. Per determinare se una correzione ha avuto successo, confronta l'ora in cui è stata implementata la modifica con quella «ultima ora di aggiornamento» di Cluster Insight.

Visualizza le informazioni sul cluster (Console)

Per visualizzare le informazioni dettagliate di un cluster Amazon EKS:

1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home#/clusters.

2. Dall'elenco dei cluster, scegli il nome del cluster Amazon EKS per il quale desideri visualizzare gli approfondimenti.

3. Scegli la scheda Approfondimenti sugli aggiornamenti.

4. Nella pagina Approfondimenti sugli aggiornamenti vedrai i seguenti campi:

   • Nome: il controllo eseguito da Amazon EKS sul cluster.

   • Stato dell'approfondimento: un approfondimento che presenta lo stato "Errore" in genere indica che la versione di Kubernetes interessata è N+1 rispetto alla versione corrente del cluster, mentre lo stato "Avviso" indica che l'approfondimento si applica a una versione futura N+2 o superiore di Kubernetes. Un approfondimento con lo stato "Ammesso" indica che Amazon EKS non ha riscontrato alcun problema associato a questo controllo sull'approfondimento nel cluster. Lo stato dell'approfondimento "Sconosciuto" significa che Amazon EKS non è in grado di determinare se il cluster è interessato da questo controllo sull'approfondimento.

   • Versione: la versione di Kubernetes che l'approfondimento ha verificato per individuare possibili problemi.

   • Ora dell'ultimo aggiornamento (UTC-5:00): l'ora in cui lo stato dell'approfondimento è stato aggiornato l'ultima volta per questo cluster.

   • Ora dell'ultima transizione (UTC-5:00): l'ora in cui lo stato di questo approfondimento è cambiato l'ultima volta.

   • Descrizione: informazioni tratte dal controllo sull'approfondimento, che include l'avviso e le azioni consigliate per la correzione.

Visualizza gli approfondimenti sul cluster (AWS CLI)

Per visualizzare le informazioni dettagliate di un cluster Amazon EKS:

1. Determina in quale cluster desideri verificare la presenza di approfondimenti. Il comando seguente elenca gli approfondimenti per un cluster specifico. Apportare le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato:

   • Sostituisci region-code con il codice per la tua Regione AWS.

   • Sostituisci my-cluster con il nome del cluster.

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

   Di seguito viene riportato un output di esempio:

   {
       "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. Eseguire il comando seguente per visualizzare le informazioni dettagliate relative all'approfondimento. Apportare le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato:

   • Sostituisci region-code con il codice per la tua Regione AWS.

   • Sostituisci 123e4567-e89b-42d3-a456-579642341238 con l'ID dell'approfondimento recuperato dall'elenco degli approfondimenti del cluster.

   • Sostituisci my-cluster con il nome del cluster.

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

   Di seguito viene riportato un output di esempio:

   {
       "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."
       }
   }