¿Cómo soluciono los problemas de las plantillas de lanzamiento personalizadas con los grupos de nodos administrados en Amazon EKS?

Descripción breve

Al utilizar una plantilla de lanzamiento personalizada con grupos de nodos administrados en su clúster de Amazon EKS, es posible que aparezca uno de los siguientes errores:

• "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"

Resolución

Client.InternalError: Client error on launch

Este error se produce cuando se utilizan volúmenes cifrados de Amazon Elastic Block Store (Amazon EBS) en la plantilla de lanzamiento personalizada con los permisos incorrectos. Para comprobar el estado del cifrado y los permisos o las políticas de AWS Identity and Access Management (IAM), verifique lo siguiente:

• Active la clave de AWS Key Management Service (AWS KMS) utilizada para cifrar el volumen.
• Asegúrese de que la clave de AWS KMS tenga las políticas de claves correctas. Modifique las políticas de claves para permitir que más roles de IAM funcionen con volúmenes de Amazon EBS cifrados. Para obtener más información, consulte Allows key users to use the KMS key.

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

Este error se produce cuando se cambia manualmente la versión de la plantilla de lanzamiento personalizada a través del grupo de escalamiento automático del nodo en lugar de a través de Amazon EKS. Para resolver este problema, debe actualizar la versión de la plantilla de lanzamiento con Amazon EKS.

Para actualizar la plantilla de lanzamiento de EC2 desde el grupo de nodos administrados, siga estos pasos:

1. Abra la consola de Amazon EKS.
2. En el panel de navegación, seleccione Clústeres.
3. En Nombre del clúster, seleccione el clúster que contiene el grupo de nodos que desea actualizar.
4. Seleccione la pestaña Informática.
5. En Grupos de nodos, seleccione su nodo y, a continuación, elija Cambiar versión.
6. Seleccione la versión que se aplicará al grupo de nodos. Asegúrese de que la estrategia de actualización esté configurada en Actualización continua.
7. Seleccione Actualizar.

Este error también se produce si elimina una plantilla de referencia al crear un grupo de nodos con una plantilla de lanzamiento personalizada. Al crear un grupo de nodos con una plantilla de lanzamiento personalizada, Amazon EKS replica la plantilla. Si elimina la plantilla original, debe volver a crear el grupo de nodos.

Para volver a crear el grupo de nodos, siga estos pasos:

1. Lance un nuevo grupo de nodos.

2. Ejecute el siguiente comando para comprobar que todos los nodos están en buen estado, en el estado Preparado y se han unido al clúster:

   $ kubectl get nodes

3. Drene sus nodos de trabajo.

4. Elimine el grupo de nodos original.

El grupo de nodos pasa a un estado DEGRADADO después de crear una nueva plantilla de lanzamiento

Un grupo de nodos puede pasar al estado DEGRADADO con un mensaje similar al siguiente error:

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

Este error se produce cuando la versión de la plantilla de lanzamiento de Amazon EC2 para su grupo de nodos administrado no coincide con la versión que crea Amazon EKS. No es posible actualizar directamente los grupos de nodos existentes que no utilizan una plantilla de lanzamiento personalizada. Para resolver este error, cree una plantilla de lanzamiento y una versión con la configuración que prefiera. A continuación, utilice la plantilla de lanzamiento para crear el grupo de nodos. Si el nuevo grupo de nodos se lanza desde su plantilla personalizada, cree nuevas versiones de la plantilla. Puede usar esta plantilla sin colocar el grupo de nodos en el estado DEGRADADO.

Información relacionada

Personalización de nodos administrados con plantillas de lanzamiento

Conceptos básicos de configuración de plantillas de lanzamiento