Skip to main content
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.

Instale Trident

Colaboradores netapp-aruldeepa netapp-mwallis
PDF

Trident optimiza la gestión del almacenamiento de Amazon FSx para NetApp ONTAP en Kubernetes para que sus desarrolladores y administradores se centren en la puesta en marcha de aplicaciones.

Puede instalar Trident mediante uno de los siguientes métodos:

  • Timón

  • Complemento EKS

Si desea utilizar la funcionalidad Snapshot, instale el complemento del controlador de instantáneas CSI. Consulte "Habilite la funcionalidad Snapshot para volúmenes CSI" si desea obtener más información.

Instale Trident a través del timón

Identidad de pod

  1. Añada el repositorio Helm de Trident:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart

  2. Instale Trident utilizando el siguiente ejemplo:

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

    Puede utilizar helm list el comando para revisar detalles de 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 cuentas de servicio (IRSA)

  1. Añada el repositorio Helm de Trident:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart

  2. Establezca los valores para proveedor de nube y 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

    Puede utilizar helm list el comando para revisar detalles de 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.2506.0    25.06.0
Nota

Si planea usar iSCSI, asegúrese de que esté habilitado en su equipo cliente. Si usa el sistema operativo de nodo de trabajo AL2023, puede 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}

Instale Trident a través del complemento EKS

El complemento Trident EKS incluye los parches de seguridad más recientes, correcciones de errores y está validado por AWS para funcionar con Amazon EKS. El complemento EKS le permite garantizar de forma constante que sus clústeres de Amazon EKS sean seguros y estables y reducir la cantidad de trabajo que necesita para instalar, configurar y actualizar complementos.

Requisitos previos

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

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

  • 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 Amazon FSx para NetApp ONTAP existente

Habilite el complemento Trident para AWS

Consola de gestión

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

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

  3. Seleccione el nombre del cluster para el que desea configurar el complemento CSI de NetApp Trident.

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

  5. Siga estos pasos para seleccionar el complemento:

    1. Desplácese hacia abajo hasta la sección Complementos de AWS Marketplace y escriba "Trident” en el cuadro de búsqueda.

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

    3. Seleccione Siguiente.

  6. En la página de configuración Configure Selected add-ons, haga lo siguiente:

    Nota Omite estos pasos si estás usando la asociación de identidad de pod.

    1. Seleccione la Versión que desea usar.

    2. Si utiliza la autenticación IRSA, asegúrese de establecer los valores de configuración disponibles en la configuración opcional:

      • Seleccione la Versión que desea usar.

      • Siga el Esquema de configuración del complemento y configure el parámetro configurationValues en la sección Valores de configuración en el rol-arn que creó en el paso anterior (el valor debe tener el siguiente formato):

    {

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

}

    +
    Si selecciona Sustituir para el método de resolución de conflictos, una o más de las configuraciones del complemento existente se pueden sobrescribir con la configuración del complemento Amazon EKS. Si no habilita esta opción y existe un conflicto con la configuración existente, se producirá un error en la operación. Puede utilizar el mensaje de error resultante para solucionar el conflicto. Antes de seleccionar esta opción, asegúrese de que el complemento de Amazon EKS no gestiona la configuración que necesita para autogestionar.

  7. Elija Siguiente.

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

    Una vez finalizada la instalación del complemento, verá el complemento instalado.

CLI DE AWS

1. Crea el add-on.json archivo:

Para la identidad del pod, utilice el siguiente formato:

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

Para la autenticación de IRSA, utilice 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 Reemplace <role ARN> por el ARN del rol que se creó en el paso anterior.

2. Instalar 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

Actualice el complemento Trident EKS

Consola de gestión

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

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

  3. Seleccione el nombre del cluster para el que desea actualizar el complemento CSI de NetApp Trident.

  4. Seleccione la pestaña Add-ons.

  5. Selecciona Trident by NetApp y luego selecciona Editar.

  6. En la página Configure Trident by NetApp, haga lo siguiente:

    1. Seleccione la Versión que desea usar.

    2. Expanda la Configuración opcional y modifique según sea necesario.

    3. Seleccione Guardar cambios.

CLI DE AWS

El siguiente ejemplo actualiza el complemento 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

  • Compruebe la versión actual de su complemento FSxN Trident CSI. Sustituya my-cluster por el nombre del 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'"}

  • Actualice el complemento a la versión devuelta bajo ACTUALIZACIÓN DISPONIBLE en la salida del paso anterior.

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

Si elimina la --force opción y cualquiera de las configuraciones del complemento de Amazon EKS entra en conflicto con la configuración existente, la actualización del complemento de Amazon EKS falla; recibirá un mensaje de error que le ayudará a resolver el conflicto. Antes de especificar esta opción, asegúrese de que el complemento de Amazon EKS no gestiona la configuración que debe administrar, ya que dicha configuración se sobrescribe con esta opción. Para obtener más información acerca de otras opciones para esta configuración, consulte "Complementos". Para obtener más información sobre la gestión de campos de Amazon EKS Kubernetes, consulte "Gestión del campo de Kubernetes".

Desinstale/elimine el complemento Trident EKS

Tienes dos opciones para eliminar un complemento de Amazon EKS:

  • Preserve el software complementario en su clúster – Esta opción elimina la administración de Amazon EKS de cualquier configuración. También elimina la posibilidad de que Amazon EKS le notifique las actualizaciones y actualice automáticamente el complemento de Amazon EKS después de iniciar una actualización. Sin embargo, conserva el software complementario en el clúster. Esta opción convierte el complemento en una instalación autogestionada, en lugar de un complemento de Amazon EKS. Con esta opción, no se produce tiempo de inactividad en el complemento. Conserve --preserve la opción en el comando para conservar el complemento.

  • * Elimine el software complementario completamente de su clúster *: NetApp recomienda eliminar el complemento Amazon EKS de su clúster solo si no hay recursos en su clúster que dependan de él. Elimine --preserve la opción del delete comando para eliminar el complemento.

Nota Si el complemento tiene una cuenta de IAM asociada, la cuenta de IAM no se elimina.
Consola de gestión

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

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

  3. Seleccione el nombre del cluster para el que desea quitar el complemento CSI de NetApp Trident.

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

  5. Seleccione Quitar.

  6. En el cuadro de diálogo Remove netapp_trident-operator confirmation, 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 conservar el software complementario en su clúster para que pueda gestionar todos los ajustes del complemento por su cuenta.

    2. Introduzca netapp_trident-operator.

    3. Seleccione Quitar.

CLI DE AWS

Reemplace my-cluster por el nombre del clúster y, a continuación, ejecute 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