Preparación para las actualizaciones de las versiones de Kubernetes con información sobre clústeres - Amazon EKS
Consulta de la información del clúster (consola)Consulta de la información del clúster (AWS CLI)

Preparación para las actualizaciones de las versiones de Kubernetes con información sobre clústeres

La información sobre los clústeres de Amazon EKS ofrece recomendaciones que lo ayudarán a seguir las prácticas recomendadas de Amazon EKS y Kubernetes. Todos los clústeres de Amazon EKS se someten a comprobaciones automáticas y periódicas con una lista de información seleccionada por Amazon EKS. Amazon EKS administra en su totalidad estas comprobaciones de información y ofrece recomendaciones sobre cómo abordar cualquier resultado.

  • Antes de actualizar la versión de Kubernetes del clúster, consulte la información sobre el clúster en la consola de EKS.

  • Si su clúster ha identificado problemas, revíselos y aplique las correcciones adecuadas. Los problemas incluyen enlaces a Amazon EKS y Kubernetes.

  • Tras solucionar los problemas, espere a que se actualicen las estadísticas del clúster. Si se han resuelto todos los problemas, actualice el clúster.

Actualmente, Amazon EKS solo devuelve información relacionada con la preparación para la actualización de la versión de Kubernetes.

La información sobre las actualizaciones identifica los posibles problemas que podrían afectar a las actualizaciones del clúster de Kubernetes. Esto minimiza el esfuerzo que los administradores dedican a preparar las actualizaciones y aumenta la fiabilidad de las aplicaciones en las versiones más recientes de Kubernetes. Amazon EKS analiza automáticamente los clústeres para compararlos con una lista de posibles problemas que podrían afectar las actualizaciones de la versión de Kubernetes. Amazon EKS actualiza con frecuencia la lista de comprobaciones de información en función de las revisiones de los cambios realizados en cada lanzamiento de versión de Kubernetes.

La información sobre las actualizaciones de Amazon EKS acelera el proceso de prueba y verificación de las nuevas versiones. También permiten a los administradores de clústeres y a los desarrolladores de aplicaciones aprovechar las capacidades más recientes de Kubernetes, ya que destacan las inquietudes y ofrecen consejos para solucionarlas. Para ver la lista de comprobaciones de información realizadas y cualquier problema relevante que Amazon EKS haya identificado, puede llamar a la operación de la API ListInsights de Amazon EKS o buscar en la consola de Amazon EKS.

La información sobre los clústeres se actualiza periódicamente. No puede actualizar manualmente la información del clúster. Si soluciona un problema con el clúster, la información del clúster tardará algún tiempo en actualizarse. Para determinar si una solución se ha aplicado correctamente, compare la hora en que se implementó el cambio con la “hora de la última actualización” de la información del clúster.

Consulta de la información del clúster (consola)

  1. Abra la consola de Amazon EKS.

  2. En la lista de clústeres, elija el nombre del clúster de Amazon EKS del que desea ver la información.

  3. Seleccione la pestaña Información sobre actualizaciones.

  4. En la página Información sobre actualizaciones, verá los siguientes campos:

    • Nombre: la comprobación realizada por Amazon EKS en relación con el clúster.

    • Estado de la información: una información con un estado de “Error” normalmente significa que la versión de Kubernetes afectada es N+1 de la versión actual del clúster, mientras que un estado de “Advertencia” significa que la información se aplica a una versión futura de Kubernetes N+2 o superior. Una información con el estado “Aprobado” significa que Amazon EKS no ha encontrado ningún problema relacionado con esta comprobación de información en su clúster. Un estado de información “Desconocido” significa que Amazon EKS no puede determinar si su clúster se ve afectado por esta comprobación de información.

    • Versión: la versión de Kubernetes que la información comprobó para detectar posibles problemas.

    • Hora de la última actualización (UTC-5:00): la hora en que se actualizó por última vez el estado de la información para este clúster.

    • Hora de la última transición (UTC-5:00): la hora en que se modificó por última vez el estado de esta información.

    • Descripción: información de la comprobación de información, que incluye la alerta y las acciones recomendadas para su corrección.

Consulta de la información del clúster (AWS CLI)

  1. Determine qué clúster desea comprobar para obtener información. El siguiente comando enumera toda la información para el clúster especificado. Realice las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado:

    • Reemplace region-code por el código de la región de AWS.

    • Reemplace my-cluster por el nombre de su clúster.

      aws eks list-insights --region region-code --cluster-name my-cluster

      Un ejemplo de salida sería el siguiente.

      {
    "insights": [
        {
            "category": "UPGRADE_READINESS",
            "name": "Deprecated APIs removed in Kubernetes v1.29",
            "insightStatus": {
                "status": "PASSING",
                "reason": "No deprecated API usage detected within the last 30 days."
            },
            "kubernetesVersion": "1.29",
            "lastTransitionTime": 1698774710.0,
            "lastRefreshTime": 1700157422.0,
            "id": "123e4567-e89b-42d3-a456-579642341238",
            "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes v1.29. Upgrading your cluster before migrating to the updated APIs supported by v1.29 could cause application impact."
        }
    ]
}

  2. Ejecute el siguiente comando para obtener información descriptiva. Realice las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado:

    • Reemplace region-code por el código de la región de AWS.

    • Reemplace 123e4567-e89b-42d3-a456-579642341238 por el ID de información obtenido de la lista de información del clúster.

    • Reemplace my-cluster por el nombre de su clúster.

      aws eks describe-insight --region region-code --id 123e4567-e89b-42d3-a456-579642341238 --cluster-name my-cluster

      Un ejemplo de salida sería el siguiente.

      {
    "insight": {
        "category": "UPGRADE_READINESS",
        "additionalInfo": {
            "EKS update cluster documentation": "https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html",
            "Kubernetes v1.29 deprecation guide": "https://kubernetes.io/docs/reference/using-api/deprecation-guide/#v1-29"
        },
        "name": "Deprecated APIs removed in Kubernetes v1.29",
        "insightStatus": {
            "status": "PASSING",
            "reason": "No deprecated API usage detected within the last 30 days."
        },
        "kubernetesVersion": "1.29",
        "recommendation": "Update manifests and API clients to use newer Kubernetes APIs if applicable before upgrading to Kubernetes v1.29.",
        "lastTransitionTime": 1698774710.0,
        "lastRefreshTime": 1700157422.0,
        "categorySpecificSummary": {
            "deprecationDetails": [
                {
                    "usage": "/apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas",
                    "replacedWith": "/apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas",
                    "stopServingVersion": "1.29",
                    "clientStats": [],
                    "startServingReplacementVersion": "1.26"
                },
                {
                    "usage": "/apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations",
                    "replacedWith": "/apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations",
                    "stopServingVersion": "1.29",
                    "clientStats": [],
                    "startServingReplacementVersion": "1.26"
                }
            ]
        },
        "id": "f6a11fe4-77f7-48c6-8326-9a13f022ecb3",
        "resources": [],
        "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes v1.29. Upgrading your cluster before migrating to the updated APIs supported by v1.29 could cause application impact."
    }
}