Skip to main content
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Instala Trident

Trident agiliza la administración del almacenamiento de Amazon FSx para NetApp ONTAP en Kubernetes para que tus desarrolladores y administradores se enfoquen en la puesta en marcha de aplicaciones.

Puedes instalar Trident usando uno de los siguientes métodos:

  • Helm

  • Complemento EKS

Si quieres hacer uso de la funcionalidad de instantáneas, instala el complemento controlador de instantáneas CSI. Consulta "Habilita la funcionalidad de instantáneas para volúmenes CSI" para más información.

Instala Trident con helm

Identidad de pod
  1. Agrega el repositorio Trident Helm:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart
  2. Instala Trident usando el siguiente ejemplo:

    helm install trident-operator netapp-trident/trident-operator --version 100.2502.1 --namespace trident --create-namespace

    Puedes usar el comando helm list para revisar detalles de la instalación como nombre, espacio de nombres, gráfico, estado, versión de la aplicación y número de revisión.

    helm list -n trident
    NAME                NAMESPACE   REVISION    UPDATED                                 STATUS       CHART                          APP VERSION
    
    trident-operator    trident     1           2024-10-14 14:31:22.463122 +0300 IDT    deployed     trident-operator-100.2502.0    25.02.0
Asociación de cuenta de servicio (IRSA)
  1. Agrega el repositorio Trident Helm:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart
  2. Establece los valores de proveedor de nube e identidad de nube:

    helm install trident-operator netapp-trident/trident-operator --version 100.2502.1  \
    --set cloudProvider="AWS" \
    --set cloudIdentity="'eks.amazonaws.com/role-arn: arn:aws:iam::<accountID>:role/<AmazonEKS_FSxN_CSI_DriverRole>'" \
    --namespace trident \
    --create-namespace

    Puedes usar el comando helm list para revisar detalles de la instalación como nombre, espacio de nombres, gráfico, estado, versión de la aplicación y número de revisión.

    helm list -n trident
    NAME                NAMESPACE   REVISION    UPDATED                                 STATUS       CHART                          APP VERSION
    
    trident-operator    trident     1           2024-10-14 14:31:22.463122 +0300 IDT    deployed     trident-operator-100.2510.0    25.10.0
Nota

Si estás planeando usar iSCSI, asegúrate de que iSCSI esté habilitado en tu máquina cliente. Si estás usando AL2023 Worker node OS, puedes automatizar la instalación del cliente iSCSI añadiendo el parámetro node prep en la instalación de helm:

helm install trident-operator netapp-trident/trident-operator --version 100.2502.1 --namespace trident --create-namespace –-set nodePrep={iscsi}

Instala Trident mediante el add-on EKS

El complemento Trident EKS incluye los últimos parches de seguridad, correcciones de errores y está validado por AWS para funcionar con Amazon EKS. El complemento EKS te permite asegurarte de forma constante de que tus clústeres de Amazon EKS sean seguros y estables, y reducir la cantidad de trabajo que necesitas hacer para instalar, configurar y actualizar complementos.

Prerrequisitos

Asegúrate de tener lo siguiente antes de configurar el complemento Trident para AWS EKS:

  • Una cuenta de clúster de Amazon EKS con suscripción de complemento

  • Permisos de AWS para AWS marketplace:
    "aws-marketplace:ViewSubscriptions",
    "aws-marketplace:Subscribe",
    "aws-marketplace:Unsubscribe

  • Tipo de AMI: Amazon Linux 2 (AL2_x86_64) o Amazon Linux 2 Arm(AL2_ARM_64)

  • Tipo de nodo: AMD o ARM

  • Un sistema de archivos existente de Amazon FSx para NetApp ONTAP

Habilita el complemento Trident para AWS

Consola de gestión
  1. Abre la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

  2. En el panel de navegación izquierdo, selecciona Clusters.

  3. Selecciona el nombre del clúster para el que quieres configurar el complemento NetApp Trident CSI.

  4. Selecciona Add-ons y luego Get more add-ons.

  5. Sigue estos pasos para seleccionar el complemento:

    1. Desplázate hasta la sección AWS Marketplace add-ons y escribe "Trident” en el cuadro de búsqueda.

    2. Selecciona la casilla de comprobación en la esquina superior derecha del cuadro Trident by NetApp.

    3. Selecciona Siguiente.

  6. En la página de configuración Configurar add-ons seleccionados, haz lo siguiente:

    Nota Omite estos pasos si estás usando la asociación Pod Identity.
    1. Selecciona la Version que te gustaría usar.

    2. Si estás usando la autenticación IRSA, asegúrate de establecer los valores de configuración disponibles en la configuración opcional:

      • Selecciona la Version que te gustaría usar.

      • Sigue el Add-on configuration schema y establece el parámetro configurationValues en la sección Configuration values al role-arn que creaste en el paso anterior (el valor debe tener el siguiente formato):

    {
    
      "cloudIdentity": "'eks.amazonaws.com/role-arn: <role ARN>'",
      "cloudProvider": "AWS"
    
    }

    +
    Si seleccionas Override como método de resolución de conflictos, una o más de las configuraciones del add-on existente pueden sobrescribirse con las configuraciones del Amazon EKS add-on. Si no habilitas esta opción y hay un conflicto con tus configuraciones existentes, la operación falla. Puedes usar el mensaje de error resultante para solucionar el conflicto. Antes de seleccionar esta opción, asegúrate de que el Amazon EKS add-on no gestione configuraciones que necesites administrar tú mismo.

  7. Elige Siguiente.

  8. En la página Revisar y agregar, elige Crear.

    Después de que se complete la instalación del complemento, verás tu complemento instalado.

AWS CLI

1. Crea el add-on.json file:

Para la identidad del pod, usa el siguiente formato:

Nota Usa la
{
  "clusterName": "<eks-cluster>",
  "addonName": "netapp_trident-operator",
  "addonVersion": "v25.6.0-eksbuild.1",
}

Para la autenticación de IRSA, usa el siguiente formato:

{
  "clusterName": "<eks-cluster>",
  "addonName": "netapp_trident-operator",
  "addonVersion": "v25.6.0-eksbuild.1",
  "serviceAccountRoleArn": "<role ARN>",
  "configurationValues": {
    "cloudIdentity": "'eks.amazonaws.com/role-arn: <role ARN>'",
    "cloudProvider": "AWS"
  }
}
Nota Reemplaza <role ARN> con el ARN del rol que se creó en el paso anterior.

2. Instala el complemento Trident EKS.

aws eks create-addon --cli-input-json file://add-on.json
eksctl

El siguiente comando de ejemplo instala el complemento Trident EKS:

eksctl create addon --name netapp_trident-operator --cluster <cluster_name> --force

Actualiza el add-on Trident EKS

Consola de gestión
  1. Abre la consola de Amazon EKS https://console.aws.amazon.com/eks/home#/clusters.

  2. En el panel de navegación izquierdo, selecciona Clusters.

  3. Selecciona el nombre del clúster para el que quieres actualizar el software complementario Trident CSI de NetApp.

  4. Selecciona la pestaña Add-ons.

  5. Selecciona Trident by NetApp y luego selecciona Editar.

  6. En la página Configura Trident por NetApp, haz lo siguiente:

    1. Selecciona la Version que te gustaría usar.

    2. Expande las Configuraciones de configuración opcionales y modifícalas según sea necesario.

    3. Selecciona Guardar cambios.

AWS CLI

El siguiente ejemplo actualiza el add-on EKS:

aws eks update-addon --cluster-name <eks_cluster_name> --addon-name netapp_trident-operator --addon-version v25.6.0-eksbuild.1 \
  --service-account-role-arn <role-ARN> --resolve-conflict preserve \
  --configuration-values “{\"cloudIdentity\": \"'eks.amazonaws.com/role-arn: <role ARN>'\"}"
eksctl
  • Comprueba la versión actual de tu FSxN Trident CSI add-on. Reemplaza my-cluster con el nombre de tu clúster.

    eksctl get addon --name netapp_trident-operator --cluster my-cluster

    Ejemplo de salida:

NAME                        VERSION             STATUS    ISSUES    IAMROLE    UPDATE AVAILABLE    CONFIGURATION VALUES
netapp_trident-operator    v25.6.0-eksbuild.1    ACTIVE    0       {"cloudIdentity":"'eks.amazonaws.com/role-arn: arn:aws:iam::139763910815:role/AmazonEKS_FSXN_CSI_DriverRole'"}
  • Actualiza el software complementario a la versión que aparece bajo UPDATE AVAILABLE en la salida del paso anterior.

    eksctl update addon --name netapp_trident-operator --version v25.6.0-eksbuild.1 --cluster my-cluster --force

Si quitas la opción --force y alguna de las configuraciones del complemento de Amazon EKS entra en conflicto con tus configuraciones actuales, entonces la actualización del complemento de Amazon EKS falla; recibes un mensaje de error para ayudarte a resolver el conflicto. Antes de especificar esta opción, asegúrate de que el complemento de Amazon EKS no administre configuraciones que necesites administrar, porque esas configuraciones se sobrescriben con esta opción. Para más información sobre otras opciones para esta configuración, consulta "Complementos". Para más información sobre la administración de campos de Kubernetes de Amazon EKS, consulta "Gestión de campos de Kubernetes".

Desinstala/elimina el complemento Trident EKS

Tienes dos opciones para eliminar un complemento de Amazon EKS:

  • Conservar el software complementario en tu clúster – Esta opción elimina la administración de cualquier configuración por parte de Amazon EKS. También elimina la capacidad de Amazon EKS para notificarte sobre actualizaciones y actualizar automáticamente el Amazon EKS add-on después de que inicies una actualización. Sin embargo, conserva el software complementario en tu clúster. Esta opción hace que el add-on sea una instalación autogestionada, en lugar de un Amazon EKS add-on. Con esta opción, no hay tiempo de inactividad para el add-on. Retén la --preserve opción en el comando para conservar el add-on.

  • Elimina el software complementario por completo de tu clúster – NetApp recomienda que elimines el complemento de Amazon EKS de tu clúster solo si no hay recursos en tu clúster que dependan de él. Elimina la opción --preserve del comando delete para eliminar el complemento.

Nota Si el software complementario tiene una cuenta IAM asociada, la cuenta IAM no se elimina.
Consola de gestión
  1. Abre la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

  2. En el panel de navegación izquierdo, selecciona Clusters.

  3. Selecciona el nombre del clúster del que quieres quitar el NetApp Trident CSI add-on.

  4. Selecciona la pestaña Complementos y luego selecciona Trident by NetApp.*

  5. Selecciona Eliminar.

  6. En el cuadro de diálogo Remove netapp_trident-operator confirmation, haz lo siguiente:

    1. Si quieres que Amazon EKS deje de administrar la configuración del software complementario, selecciona Conservar en el clúster. Haz esto si quieres conservar el software complementario en tu clúster para que puedas administrar tú mismo todas las configuraciones del complemento.

    2. Ingresa netapp_trident-operator.

    3. Selecciona Eliminar.

AWS CLI

Reemplaza my-cluster con el nombre de tu clúster y luego ejecuta el siguiente comando.

aws eks delete-addon --cluster-name my-cluster --addon-name netapp_trident-operator --preserve
eksctl

El siguiente comando desinstala el complemento Trident EKS:

eksctl delete addon --cluster K8s-arm --name netapp_trident-operator