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

Descripción breve

Es posible que aparezca alguno de los siguientes errores al utilizar una plantilla de lanzamiento personalizada con grupos de nodos administrados en su clúster de Amazon EKS:

• “Client.InternalError: Client error on launch” (Client.InternalError: error del cliente al hacer un lanzamiento)
• “SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found” (SourceEc2LaunchTemplateNotFound o no se encontró la plantilla de lanzamiento de Amazon EC2 lt-xxxxxxxxxxxxxxxxx versión x)
• “Node group entered a DEGRADED status” (El grupo de nodos entró en estado DEGRADADO)

Resolución

Client.InternalError: Client error on launch (Client.InternalError: error del cliente al hacer un lanzamiento)

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:

• La clave de AWS Key Management Service (AWS KMS) utilizada para cifrar el volumen está activada.
• La clave de AWS KMS tiene las políticas de claves correctas. Puede modificar 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 Permite a los usuarios de claves utilizar la clave de KMS.

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found (SourceEc2LaunchTemplateNotFound o no se encontró la plantilla de lanzamiento de Amazon EC2 lt-xxxxxxxxxxxxxxxxx versión x)

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 los siguientes pasos:

1. Abra la consola de Amazon EKS.
2. En el panel de navegación, elija Clusters (Clústeres).
3. En Cluster name (Nombre del clúster), seleccione el clúster que contiene el grupo de nodos que desea actualizar.
4. Seleccione la pestaña Compute (Computación).
5. En Node groups (Grupos de nodos), seleccione su nodo y, a continuación, elija Change version (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 Rolling Update (Actualización progresiva).
7. Seleccione Update (Actualizar).

Para obtener más información, consulte Actualización de un grupo de nodos administrados.

El grupo de nodos entró en estado DEGRADADO después de crear una nueva plantilla de lanzamiento

El grupo de nodos puede entrar en el estado DEGRADADO con un 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”. (La plantilla de lanzamiento de Amazon EC2: lt-xxxxxxxxxxxxxxxxx tiene una nueva versión asociada al grupo de escalamiento automático que Amazon EKS no administra. Versión prevista de la plantilla de lanzamiento: x).

El problema surge cuando la versión de la plantilla de lanzamiento de Amazon EC2 para su grupo de nodos administrados no coincide con la versión que creó Amazon EKS. Los grupos de nodos existentes que no utilizan una plantilla de lanzamiento personalizada no se pueden actualizar directamente. Para solucionar este problema, cree una plantilla y una versión de lanzamiento con la configuración que prefiera y, a continuación, cree el grupo de nodos con esa plantilla de lanzamiento. Si el nuevo grupo de nodos se lanza desde su plantilla personalizada, podrá crear nuevas versiones de la plantilla. Puede utilizar esta plantilla sin poner el grupo de nodos en estado DEGRADADO.

Información relacionada

Compatibilidad con las plantillas de lanzamiento

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