Solución de problemas de clústeres locales para Amazon EKS en AWS Outposts

Los clústeres locales se crean mediante la API de Amazon EKS, pero se ejecutan de forma asincrónica. Esto significa que las solicitudes a la API de Amazon EKS se devuelven inmediatamente para los clústeres locales. Sin embargo, estas solicitudes pueden tener éxito, responder rápido a los errores debido a errores de validación de entradas o fallar y tener errores de validación descriptivos. Este comportamiento es similar a la API de Kubernetes.

Los clústeres locales no pasan a un estado FAILED. Amazon EKS intenta conciliar el estado del clúster con el estado deseado solicitado por el usuario de forma continua. Como resultado, un clúster local puede permanecer en el estado CREATING durante un periodo prolongado hasta que se resuelva el problema subyacente.

Los problemas de los clústeres locales se pueden detectar con el comando describe-cluster de la AWS CLI de Amazon EKS. Los problemas de los clústeres locales aparecen en el campo cluster.health de la respuesta del comando describe-cluster. El mensaje contenido en este campo incluye un código de error, un mensaje descriptivo y los ID de los recursos relacionados. Esta información se encuentra disponible solo a través de la API y la AWS CLI de Amazon EKS. En el siguiente ejemplo, reemplace my-cluster por el nombre de su clúster local.

aws eks describe-cluster --name my-cluster --query 'cluster.health'

Un ejemplo de salida sería el siguiente.

{
    "issues": [
        {
            "code": "ConfigurationConflict",
            "message": "The instance type 'm5.large' is not supported in Outpost 'my-outpost-arn'.",
            "resourceIds": [
                "my-cluster-arn"
            ]
        }
    ]
}

Si el problema no se puede solucionar, es posible que tenga que eliminar el clúster local y crear uno nuevo. Por ejemplo, intentar aprovisionar un clúster con un tipo de instancia que no está disponible en su Outpost. La siguiente tabla incluye errores comunes relacionados con el estado.

En la siguiente tabla se enumeran los errores de otros Servicios de AWS que se presentan en el campo de estado de la respuesta describe-cluster.

Los clústeres locales requieren permisos y políticas diferentes a los de los clústeres de Amazon EKS alojados en la nube. Cuando un clúster no se puede crear y produce un error InvalidPermissions, compruebe que el rol de clúster que está usando tiene la política administrada AmazonEKSLocalOutpostClusterPolicy asociada. Todas las demás llamadas a la API requieren el mismo conjunto de permisos que los clústeres de Amazon EKS en la nube.

La cantidad de tiempo que tarda en crearse un clúster local varía según varios factores. Estos factores incluyen la configuración de la red, la configuración de Outpost y la configuración del clúster. En general, se crea un clúster local y cambia al estado ACTIVE en un plazo de 15 a 20 minutos. Si un clúster local permanece en el estado CREATING, puede llamar a describe-cluster para solicitar información sobre la causa en el campo de resultado cluster.health.

Los problemas más comunes son los siguientes:

Falta o está mal configurada la configuración de DNS de la VPC y de la subred

Consulte Requisitos y consideraciones de VPC y subred del clúster local de Amazon EKS.

Cuando un Outpost se desconecta del servidor al que está asociado la Región de AWS, es probable que el clúster Kubernetes siga funcionando con normalidad. Sin embargo, si el clúster no funciona correctamente, siga los pasos de solución de problemas que se indican en Preparación para las desconexiones de red. Si tiene otros problemas, póngase en contacto con AWS Support. AWS Support puede guiarlo para descargar y ejecutar una herramienta de recopilación de registros. De esta forma, puede recopilar registros de sus instancias del plano de control del clúster de Kubernetes y enviarlas al soporte de AWS Support para una investigación en mayor profundidad.

Cuando no se puede acceder a las instancias del plano de control de Amazon EKS a través de AWS Systems Manager (Systems Manager), Amazon EKS muestra el siguiente error para su clúster.

Amazon EKS control plane instances are not reachable through SSM. Please verify your SSM and network configuration, and reference the EKS on Outposts troubleshooting documentation.

Para resolver este problema, asegúrese de que su VPC y las subredes cumplen con los requisitos de Requisitos y consideraciones de VPC y subred del clúster local de Amazon EKS y que ha completado los pasos de la Configuración del administrador de sesiones en la Guía del usuario de AWS Systems Manager.