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

Descripción breve

Al utilizar una plantilla de inicio personalizada con grupos de nodos administrados en tu 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 error on launch

Este error se produce cuando se utilizan volúmenes cifrados de Amazon Elastic Block Store (Amazon EBS) en la plantilla de inicio 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), verifica lo siguiente:

• Activa la clave de AWS Key Management Service (AWS KMS) utilizada para cifrar el volumen.
• Asegúrate de que la clave de AWS KMS tenga las políticas de claves correctas. Modifica 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, consulta Permitir que los usuarios clave usen la clave de KMS.

Launch template not found

Este error se produce cuando se cambia manualmente la versión de la plantilla de inicio 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, debes actualizar la versión de la plantilla de inicio con Amazon EKS.

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de problemas de AWS CLI. Además, asegúrate de utilizar la versión más reciente de la AWS CLI.

Para actualizar la plantilla de inicio de Amazon Elastic Compute Cloud (Amazon EC2) desde el grupo de nodos administrado, sigue estos pasos:

1. Abre la consola de Amazon EKS.
2. En el panel de navegación, selecciona Clústeres.
3. En Nombre del clúster, selecciona el clúster que contiene el grupo de nodos que deseas actualizar.
4. Selecciona la pestaña Informática.
5. En Grupos de nodos, selecciona tu nodo y, a continuación, elige Cambiar versión.
   Nota: Esta opción solo aparece si hay una nueva revisión de la plantilla de inicio disponible. Si no ves la opción, utiliza el comando aws eks update-nodegroup-version de la AWS CLI para modificar la versión de la plantilla de inicio del grupo de nodos.
6. Selecciona la versión que se aplicará al grupo de nodos. Asegúrate de que la estrategia de actualización esté configurada en Actualización continua.
7. Selecciona Actualizar.

Este error también se produce si eliminas una plantilla de referencia al crear un grupo de nodos con una plantilla de inicio personalizada. Si utilizas una plantilla de inicio personalizada, Amazon EKS replica la plantilla. Si eliminas la plantilla original, debes volver a crear el grupo de nodos.

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

1. Inicia un nuevo grupo de nodos.

2. Ejecuta 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. Drena tus nodos de trabajo.

4. Elimina el grupo de nodos original.

Node group enters a DEGRADED status

Un grupo de nodos puede pasar a un estado DEGRADADO después de que Amazon EKS cree una plantilla de inicio con un mensaje de error similar al siguiente:

"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 inicio de Amazon EC2 para tu grupo de nodos administrado no coincide con la versión que crea Amazon EKS. Solo puedes actualizar directamente los grupos de nodos existentes que usen una plantilla de inicio personalizada. Para resolver este error, crea una plantilla de inicio y una versión con la configuración que prefieras. A continuación, utiliza la plantilla de inicio para crear el grupo de nodos. Si el nuevo grupo de nodos se inicia desde tu plantilla personalizada, crea nuevas versiones de la plantilla. Puedes usar esta plantilla sin colocar el grupo de nodos en el estado DEGRADADO.

Información relacionada

Personalización de nodos administrados con plantillas de inicio

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