Eliminación de un complemento de Amazon EKS de un clúster - Amazon EKS
Requisitos previosProcedimiento

Ayude a mejorar esta página

¿Quiere contribuir a esta guía del usuario? Desplácese hasta el final de esta página y seleccione Editar esta página en GitHub. Sus contribuciones ayudarán a que nuestra guía del usuario sea mejor para todos.

Eliminación de un complemento de Amazon EKS de un clúster

Puede quitar un complemento de Amazon EKS de su clúster mediante eksctl, la AWS Management Console o la AWS CLI.

Cuando elimine un complemento de Amazon EKS de un clúster, tenga en cuenta lo siguiente:

  • No hay tiempo de inactividad para la funcionalidad que proporciona el complemento.

  • Si utiliza los roles de IAM para las cuentas de servicio (IRSA) y el complemento tiene una función de IAM asociada, esta no se elimina.

  • Si utiliza Pod Identities, se eliminarán todas las asociaciones de Pod Identity que sean propiedad del complemento. Si especifica la opción --preserve en la AWS CLI, las asociaciones se conservan.

  • Amazon EKS deja de administrar la configuración del complemento.

  • La consola deja de avisarle cuando haya nuevas versiones disponibles.

  • No puede actualizar el complemento con ninguna herramienta o API de AWS.

  • Puede optar por dejar el software de complemento en el clúster para poder autoadministrar el software de complemento o puede eliminar el software de complemento del clúster. Solo debe eliminar el complemento de software si ninguno de los recursos del clúster depende de la funcionalidad que proporciona el complemento.

Requisitos previos

Siga estos pasos antes de crear un complemento:

  • Un clúster existente de Amazon EKS. Para implementar uno, consulte Introducción a Amazon EKS.

  • Compruebe si el complemento requiere un rol de IAM. Para obtener más información, consulte

  • La versión 0.187.0 o posterior de la herramienta de línea de comandos eksctl instalada en su dispositivo o AWS CloudShell. Para instalar o actualizar eksctl, consulte la sección Installation de la documentación de eksctl.

Procedimiento

Puede eliminar un complemento de Amazon EKS mediante eksctl, la AWS Management Console o la AWS CLI. Si el complemento requiere un rol de IAM, consulte los detalles del complemento específico en Complementos de Amazon EKS disponibles desde AWS para obtener información sobre cómo crear el rol.

Tiene dos opciones al eliminar un complemento de Amazon EKS.

  • Conservar el software del complemento en el clúster: esta opción elimina la administración de Amazon EKS de cualquier configuración. También elimina la capacidad de Amazon EKS de notificarle las actualizaciones y actualizar de forma automática el complemento de Amazon EKS después de iniciar una actualización. Sin embargo, conserva el software del complemento en el clúster. Esta opción hace que la instalación sea autoadministrada, en lugar de un complemento de Amazon EKS. Con esta opción, no hay tiempo de inactividad para el complemento.

  • Eliminar por completo el software del complemento del clúster: recomendamos que elimine el complemento de Amazon EKS del clúster solo si no hay recursos en el clúster que dependan de él.

eksctl
Para eliminar un complemento de Amazon EKS con eksctl

  1. Determine los complementos instalados en su clúster. Reemplace my-cluster por el nombre del clúster.

    eksctl get addon --cluster my-cluster

    Un ejemplo de salida sería el siguiente.

    NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0
[...]

    El resultado puede tener un aspecto diferente, según los complementos y las versiones que tenga en su clúster.

  2. Elimine el complemento. Reemplace my-cluster por el nombre de su clúster y name-of-add-on por el nombre del complemento que obtuvo en la salida del paso anterior que desea eliminar. Si elimina la opción --preserve, además de que Amazon EKS deja de administrar el complemento, se elimina el software del complemento del clúster.

    eksctl delete addon --cluster my-cluster --name name-of-addon --preserve

Para obtener más información acerca de cómo eliminar complementos, consulte Deleting addons en la documentación de eksctl.

AWS Management Console
Para eliminar un complemento de Amazon EKS con la AWS Management Console

  1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

  2. En el panel de navegación izquierdo, elija Clusters (Clústeres).

  3. Elija el nombre del clúster para el que desea eliminar el complemento de Amazon EKS.

  4. Elija la pestaña Complementos.

  5. Seleccione el complemento que desea eliminar.

  6. Elija Eliminar.

  7. En el cuadro de diálogo de confirmación Eliminar: nombre del complemento, haga lo siguiente:

    1. Si desea que Amazon EKS deje de administrar la configuración del complemento, seleccione Conservar en clúster. Haga esto si desea retener el software del complemento en el clúster. Esto es para que pueda administrar todas las configuraciones del complemento por su cuenta.

    2. Ingrese el nombre del complemento.

    3. Elija Eliminar.

AWS CLI
Requisito previo

La versión 0.187.0 o posterior de la herramienta de línea de comandos eksctl instalada en su dispositivo o AWS CloudShell. Para instalar o actualizar eksctl, consulte la sección de Instalación en la documentación de eksctl.

Para eliminar un complemento de Amazon EKS con la AWS CLI

  1. Consulte la lista de complementos instalados. Reemplace my-cluster por el nombre del clúster.

    aws eks list-addons --cluster-name my-cluster

    Un ejemplo de salida sería el siguiente.

    {
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni",
        "name-of-addon"
    ]
}

  2. Elimine el complemento instalado. Reemplace my-cluster por el nombre de su clúster y name-of-add-on por el nombre del complemento que desea eliminar. Al eliminar --preserve, se elimina el software del complemento del clúster.

    aws eks delete-addon --cluster-name my-cluster --addon-name name-of-addon --preserve

    A continuación se muestra el ejemplo abreviado de salida.

    {
    "addon": {
        "addonName": "name-of-add-on",
        "clusterName": "my-cluster",
        "status": "DELETING",
[...]

  3. Compruebe el estado de la eliminación. Reemplace my-cluster por el nombre de su clúster y name-of-addon por el nombre del complemento que está eliminando.

    aws eks describe-addon --cluster-name my-cluster --addon-name name-of-addon

    El resultado del ejemplo luego de que se elimina el complemento es el siguiente.

    An error occurred (ResourceNotFoundException) when calling the DescribeAddon operation: No addon: name-of-addon found in cluster: my-cluster