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
-
Agrega el repositorio Trident Helm:
helm repo add netapp-trident https://netapp.github.io/trident-helm-chart -
Instala Trident usando el siguiente ejemplo:
helm install trident-operator netapp-trident/trident-operator --version 100.2502.1 --namespace trident --create-namespacePuedes usar el comando
helm listpara 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 tridentNAME 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
-
Agrega el repositorio Trident Helm:
helm repo add netapp-trident https://netapp.github.io/trident-helm-chart -
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-namespacePuedes usar el comando
helm listpara 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 tridentNAME 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
|
|
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:
|
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
-
Abre la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.
-
En el panel de navegación izquierdo, selecciona Clusters.
-
Selecciona el nombre del clúster para el que quieres configurar el complemento NetApp Trident CSI.
-
Selecciona Add-ons y luego Get more add-ons.
-
Sigue estos pasos para seleccionar el complemento:
-
Desplázate hasta la sección AWS Marketplace add-ons y escribe "Trident” en el cuadro de búsqueda.
-
Selecciona la casilla de comprobación en la esquina superior derecha del cuadro Trident by NetApp.
-
Selecciona Siguiente.
-
-
En la página de configuración Configurar add-ons seleccionados, haz lo siguiente:
Omite estos pasos si estás usando la asociación Pod Identity. -
Selecciona la Version que te gustaría usar.
-
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. -
-
Elige Siguiente.
-
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.
1. Crea el add-on.json file:
Para la identidad del pod, usa el siguiente formato:
|
|
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"
}
}
|
|
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
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
-
Abre la consola de Amazon EKS https://console.aws.amazon.com/eks/home#/clusters.
-
En el panel de navegación izquierdo, selecciona Clusters.
-
Selecciona el nombre del clúster para el que quieres actualizar el software complementario Trident CSI de NetApp.
-
Selecciona la pestaña Add-ons.
-
Selecciona Trident by NetApp y luego selecciona Editar.
-
En la página Configura Trident por NetApp, haz lo siguiente:
-
Selecciona la Version que te gustaría usar.
-
Expande las Configuraciones de configuración opcionales y modifícalas según sea necesario.
-
Selecciona Guardar cambios.
-
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>'\"}"
-
Comprueba la versión actual de tu FSxN Trident CSI add-on. Reemplaza
my-clustercon el nombre de tu clúster.eksctl get addon --name netapp_trident-operator --cluster my-clusterEjemplo 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
--preserveopció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
--preservedel comandodeletepara eliminar el complemento.
|
|
Si el software complementario tiene una cuenta IAM asociada, la cuenta IAM no se elimina. |
-
Abre la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.
-
En el panel de navegación izquierdo, selecciona Clusters.
-
Selecciona el nombre del clúster del que quieres quitar el NetApp Trident CSI add-on.
-
Selecciona la pestaña Complementos y luego selecciona Trident by NetApp.*
-
Selecciona Eliminar.
-
En el cuadro de diálogo Remove netapp_trident-operator confirmation, haz lo siguiente:
-
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.
-
Ingresa netapp_trident-operator.
-
Selecciona Eliminar.
-
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
El siguiente comando desinstala el complemento Trident EKS:
eksctl delete addon --cluster K8s-arm --name netapp_trident-operator