Comment résoudre les problèmes liés aux modèles de lancement personnalisés pour les groupes de nœuds gérés dans Amazon EKS ?

Brève description

L'une des erreurs suivantes pourrait survenir lorsque vous utilisez un modèle de lancement personnalisé avec des groupes de nœuds gérés dans votre cluster Amazon EKS :

• « Client.InternalError: Client error on launch » (Client.InternalError : Erreur client au lancement)
• « SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found » (SourceEc2LaunchTemplateNotFound ou le modèle de lancement Amazon EC2 lt-xxxxxxxxxxxxxxxxx version x n'a pas été trouvé)
• « Node group entered a DEGRADED status » (Le groupe de nœuds est passé au statut DÉGRADÉ)

Solution

Client.InternalError: Client error on launch (Client.InternalError : Erreur client au lancement)

Cette erreur se produit lors de l'utilisation de volumes Amazon Elastic Block Store (Amazon EBS) cryptés dans le modèle de lancement personnalisé avec des autorisations incorrectes. Pour vérifier le statut de chiffrement et les autorisations ou politiques de la gestion des identités et des accès AWS (AWS IAM), vérifiez les points suivants :

• La clé AWS Key Management Service (AWS KMS) utilisée pour le chiffrement du volume est activée.
• La clé AWS KMS dispose des politiques de clé appropriées. Pour permettre à davantage de rôles IAM de travailler avec des volumes Amazon EBS chiffrés, vous pouvez modifier les politiques de clé. Pour plus d’informations, consultez Autorise les utilisateurs clés à utiliser la clé KMS.

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found (SourceEc2LaunchTemplateNotFound ou le modèle de lancement Amazon EC2 lt-xxxxxxxxxxxxxxxxx version x n'a pas été trouvé)

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

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

1. Ouvrez la console Amazon EKS.
2. Dans le panneau de navigation, choisissez Clusters.
3. Dans Nom de cluster, choisissez le cluster qui contient le groupe de nœuds à mettre à jour.
4. Choisissez l'onglet Compute (Calculer).
5. Pour les groupes de nœuds, choisissez votre nœud, puis sélectionnez Change version (Changer 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 Mise à jour continue.
7. Choisissez Update (Mettre à jour).

Pour plus d’informations, consultez Mise à jour d'un groupe de nœuds gérés.

Le groupe de nœuds est passé au statut DÉGRADÉ après la création d’un nouveau modèle de lancement

Le groupe de nœuds peut passer au statut DÉGRADÉ en contenant une erreur similaire à la suivante :

« Le modèle de lancement Amazon EC2 : lt-xxxxxxxxxxxxxxxxx comporte une nouvelle version associée à votre groupe Autoscaling, qui n'est pas géré par Amazon EKS. Version du modèle de lancement prévue : x ».

Ce problème se produit lorsque la version du modèle de lancement Amazon EC2 pour votre groupe de nœuds gérés 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 mis à jour directement. Pour résoudre ce problème, créez un modèle et une version de lancement avec vos paramètres préférés, puis créez le groupe de nœuds à l'aide de ce modèle de lancement. Si le nouveau groupe de nœuds est lancé à partir de votre modèle personnalisé, vous pouvez créer de nouvelles versions du modèle. Vous pouvez utiliser ce modèle sans placer le groupe de nœuds dans un statut DÉGRADÉ.

Informations connexes

Support des modèles de lancement

Principes de base de configuration du modèle de lancement