Come posso risolvere i problemi relativi ai modelli di avvio personalizzati con i 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

Client.InternalError: Client error on launch

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. Per consentire a più ruoli IAM di utilizzare volumi Amazon EBS crittografati, modifica le policy della chiave. Per ulteriori informazioni, consulta Allows key users to use the KMS key.

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found

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

Per aggiornare il modello di avvio EC2 dal gruppo di nodi gestiti, completa i seguenti passaggi:

1. Apri la console Amazon EKS.
2. Nel riquadro di navigazione, scegliCluster.
3. In Nome cluster, scegli il cluster che contiene il gruppo di nodi da aggiornare.
4. Scegli la scheda Elaborazione.
5. Nei gruppi di nodi, scegli il tuo nodo, quindi scegli Modifica versione.
6. Seleziona la versione da applicare al tuo gruppo di nodi. Assicurati che la strategia di aggiornamento sia impostata su Aggiornamento in sequenza.
7. Seleziona Aggiorna.

Questo errore si verifica anche se si elimina un modello di riferimento quando si crea un gruppo di nodi con un modello di avvio personalizzato. Quando crei un gruppo di nodi con un modello di avvio personalizzato, Amazon EKS replica il modello. Se elimini il modello originale, è necessario 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 Nodo passa nello stato DEGRADATO dopo aver creato un nuovo modello di avvio

Quando un gruppo di nodi entra nello stato DEGRADATO, potrebbe venire visualizzato un messaggio simile al seguente errore:

"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. I gruppi di nodi esistenti che non utilizzano un modello di avvio personalizzato non possono essere aggiornati direttamente. Per risolvere questo errore, crea un modello e una versione di avvio con le tue impostazioni preferite. Quindi, usa 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. È possibile utilizzare questo modello senza che il gruppo di noti entri nello stato DEGRADATO.

Informazioni correlate

Customizing managed nodes with launch templates

Launch template configuration basics