Come posso risolvere i problemi relativi ai modelli di avvio personalizzati con gruppi di nodi gestiti in Amazon EKS?

Breve descrizione

Quando utilizzi un modello di avvio personalizzato con gruppi di nodi gestiti nel cluster Amazon EKS, potresti ricevere uno dei seguenti errori:

• "Client.InternalError: Client error on launch"
• "SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found"
• "Node group entered a DEGRADED status"

Risoluzione

Errore del cliente all'avvio

Questo errore si verifica quando utilizzi volumi crittografati di Amazon Elastic Block Store (Amazon EBS) nel modello di avvio personalizzato con autorizzazioni errate. Per verificare lo stato della crittografia e le autorizzazioni o le policy di AWS Identity and Access Management (IAM), completa le seguenti attività:

• Attiva la chiave del Servizio AWS di gestione delle chiavi (AWS KMS) utilizzata per crittografare il volume.
• Assicurati che la chiave AWS KMS abbia le policy della chiave corrette. Per consentire a più ruoli IAM di utilizzare volumi Amazon EBS crittografati, modifica le policy della chiave. Per ulteriori informazioni, consulta Consente agli utenti della chiave di utilizzare la chiave KMS.

Modello di avvio non trovato

Questo errore si verifica quando modifichi manualmente la versione del modello di avvio personalizzato tramite il gruppo Auto Scaling del nodo anziché Amazon EKS. Per risolvere il problema, devi utilizzare Amazon EKS per aggiornare la versione del modello di avvio.

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Per aggiornare il modello di avvio di Amazon Elastic Compute Cloud (Amazon EC2) dal gruppo di nodi gestiti, completa i seguenti passaggi:

1. Apri la console Amazon EKS.
2. Nel pannello di navigazione, scegliCluster.
3. In Nome del cluster, seleziona il cluster che contiene il gruppo di nodi da aggiornare.
4. Scegli la scheda Calcolo.
5. Per Gruppi di nodi, seleziona il nodo, quindi scegli Modifica versione.
   Nota: questa opzione viene visualizzata solo se è disponibile una nuova revisione del modello di avvio. Se non riesci a visualizzare l'opzione, utilizza il comando AWS CLI aws eks update-nodegroup-version per modificare la versione del modello di avvio del gruppo di nodi.
6. Seleziona la versione da applicare al gruppo di nodi. Assicurati che la strategia di aggiornamento sia impostata su Aggiornamento in sequenza.
7. Seleziona Aggiorna.

Questo errore si verifica anche se elimini un modello di riferimento quando crei un gruppo di nodi con un modello di avvio personalizzato. Se utilizzi un modello di avvio personalizzato, Amazon EKS replica il modello. Se elimini il modello originale, devi ricreare il gruppo di nodi.

Per ricreare il gruppo di nodi, completa i passaggi seguenti:

1. Avvia un nuovo gruppo di nodi.

2. Esegui il comando seguente per verificare che tutti i nodi siano integri, nello stato Pronto e siano nel cluster:

   $ kubectl get nodes

3. Svuota i nodi worker.

4. Elimina il gruppo di nodi originale.

Il gruppo di nodi entra in uno stato DEGRADATO

Un gruppo di nodi può passare allo stato DEGRADATO dopo che Amazon EKS ha creato un modello di avvio con un messaggio di errore simile al seguente:

"The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS. Expected Launch Template version: x".

Questo errore si verifica quando la versione del modello di avvio di Amazon EC2 del gruppo di nodi gestiti non corrisponde alla versione creata da Amazon EKS. Puoi aggiornare direttamente solo i gruppi di nodi esistenti che utilizzano un modello di avvio personalizzato. Per risolvere l'errore, crea un modello e una versione di avvio con le tue impostazioni preferite. Quindi utilizza il modello di avvio per creare il gruppo di nodi. Se il nuovo gruppo di nodi viene avviato dal modello personalizzato, crea nuove versioni del modello. Puoi utilizzare questo modello senza che il gruppo di nodi entri nello stato DEGRADATO.

Informazioni correlate

Personalizza i nodi gestiti con modelli di avvio

Informazioni di base sulla configurazione del modello di avvio