Comment résoudre les problèmes liés au modèle de lancement personnalisé avec des groupes de nœuds gérés dans Amazon EKS ?

Brève description

Lorsque vous utilisez un modèle de lancement personnalisé avec des groupes de nœuds gérés dans votre cluster Amazon EKS, l'une des erreurs suivantes peut s'afficher :

• « 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 »

Résolution

Client.InternalError: Client error on launch

Cette erreur se produit lorsque vous utilisez des volumes Amazon Elastic Block Store (Amazon EBS) chiffrés dans le modèle de lancement personnalisé avec des autorisations incorrectes. Pour vérifier l'état du chiffrement et les autorisations ou politiques Gestion des identités et des accès AWS (AWS IAM), effectuez les tâches suivantes :

• Activez la clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer le volume.
• Vérifiez que cette clé AWS KMS dispose des stratégies de clé appropriées. Pour permettre à davantage de rôles IAM de fonctionner avec des volumes Amazon EBS chiffrés, modifiez les stratégies de clé. Pour en savoir plus, consultez la page Autoriser les utilisateurs de clés à utiliser la clé KMS.

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

Cette erreur se produit lorsque vous modifiez manuellement la version du modèle de lancement personnalisé via le groupe Auto Scaling du nœud au lieu d'Amazon EKS. Pour résoudre ce problème, vous devez utiliser Amazon EKS pour mettre à jour la version du modèle de lancement.

Pour mettre à jour votre modèle de lancement EC2 à partir du groupe de nœuds géré, procédez comme suit :

1. Ouvrez la console Amazon EKS.
2. Dans le volet de navigation, choisissez Clusters.
3. Sous Nom du cluster, choisissez le cluster qui contient le groupe de nœuds à mettre à jour.
4. Choisissez l'onglet Calcul.
5. Pour les groupes de nœuds, choisissez votre nœud, puis choisissez Modifier la version.
6. Sélectionnez la version à appliquer à votre groupe de nœuds. Assurez-vous que la stratégie de mise à jour est définie sur Déploiement de la mise à jour.
7. Choisissez Mettre à jour.

Cette erreur se produit également si vous supprimez un modèle de référence lors de la création d’un groupe de nœuds avec un modèle de lancement personnalisé. Lorsque vous créez un groupe de nœuds avec un modèle de lancement personnalisé, Amazon EKS réplique le modèle. Si vous supprimez le modèle d'origine, vous devez recréer le groupe de nœuds.

Pour recréer le groupe de nœuds, procédez comme suit :

1. Lancez un nouveau groupe de nœuds.

2. Exécutez la commande suivante pour vérifier que tous les nœuds sont sains, qu'ils indiquent l'état Prêt et qu'ils ont rejoint le cluster :

   $ kubectl get nodes

3. Videz vos composants master.

4. Supprimez le groupe de nœuds d'origine.

Le groupe de nœuds passe à l'état DÉGRADÉ après avoir créé un nouveau modèle de lancement

Un groupe de nœuds peut passer à l'état DÉGRADÉ et déclencher une erreur de ce type :

« 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 ».

Cette erreur se produit lorsque la version du modèle de lancement Amazon EC2 pour votre groupe de nœuds géré ne correspond pas à la version créée par Amazon EKS. Les groupes de nœuds existants qui n'utilisent pas de modèle de lancement personnalisé ne peuvent pas être directement mis à jour. Pour résoudre ce problème, vous devez créer un modèle de lancement et une version avec les paramètres de votre choix. Utilisez ensuite le modèle de lancement pour créer le groupe de nœuds. Si le nouveau groupe de nœuds est lancé à partir de votre modèle personnalisé, vous devez créer de nouvelles versions du modèle. Vous pouvez utiliser ce modèle sans placer le groupe de nœuds à l’état DÉGRADÉ.

Informations connexes

Personnalisation des nœuds gérés avec des modèles de lancement

Concepts de base de la configuration d'un modèle de lancement