**Ayude a mejorar esta página** 

Para contribuir a esta guía del usuario, elija el enlace **Edit this page on GitHub** que se encuentra en el panel derecho de cada página.

# Cómo eliminar un complemento de Amazon EKS de un clúster
<a name="removing-an-add-on"></a>

Puede quitar un complemento de Amazon EKS de su clúster mediante `eksctl`, la Consola de administración de AWS o 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
<a name="removing-an-add-on-prereq"></a>

Siga estos pasos antes de crear un complemento:
+ Un clúster existente de Amazon EKS. Para implementar uno, consulte [Introducción a Amazon EKS](getting-started.md).
+ Compruebe si el complemento requiere un rol de IAM. Para más información, consulte
+ La versión `0.215.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](https://eksctl.io/installation) de la documentación de `eksctl`.

## Procedimiento
<a name="removing-an-add-on-procedure"></a>

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.

Puede eliminar un complemento de Amazon EKS mediante `eksctl`, la Consola de administración de AWS o AWS CLI.

### Eliminar complemento (eksctl)
<a name="_remove_add_on_eksctl"></a>

1. Determine los complementos instalados en su clúster. Reemplace *my-cluster* por el nombre de su 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.

1. 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](https://eksctl.io/usage/addons/#deleting-addons) en la documentación de `eksctl`.

### Eliminación del complemento (consola de AWS)
<a name="remove_add_on_shared_aws_console"></a>

1. Abra la [consola de Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).

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

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

1. Elija la pestaña **Complementos**.

1. Seleccione el complemento que desea eliminar.

1. Elija **Eliminar**.

1. 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.

   1. Ingrese el nombre del complemento.

   1. Elija **Eliminar**.

### Eliminar complemento (AWS CLI)
<a name="remove_add_on_shared_aws_cli"></a>

1. Necesita tener la versión `0.215.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 [Instalación](https://eksctl.io/installation) en la documentación de `eksctl`.

1. Consulte la lista de complementos instalados. Reemplace *my-cluster* por el nombre de su 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"
       ]
   }
   ```

1. 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",
       }
   }
   ```

1. Compruebe el estado de la eliminación. Reemplace *my-cluster* por el nombre de su clúster y *name-of-add-on* por el nombre del complemento que desea eliminar.

   ```
   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
   ```