Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Installation de Trident

Contributeurs netapp-aruldeepa netapp-mwallis
PDF

Trident rationalise la gestion du stockage Amazon FSX for NetApp ONTAP dans Kubernetes pour que vos développeurs et administrateurs puissent donner la priorité au déploiement d'applications.

Vous pouvez installer Trident à l'aide de l'une des méthodes suivantes :

  • Gouvernail

  • Module complémentaire EKS

Si vous souhaitez utiliser la fonctionnalité snapshot, installez le module complémentaire CSI snapshot Controller. Pour plus d'informations, reportez-vous à la section "Activer la fonctionnalité snapshot pour les volumes CSI" .

Installez Trident via Helm

Identité du pod

  1. Ajout du référentiel Trident Helm :

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

  2. Installez Trident en utilisant l’exemple suivant :

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

    Vous pouvez utiliser helm list la commande pour consulter les détails de l'installation tels que le nom, l'espace de noms, le graphique, l'état, la version de l'application et le numéro de révision.

    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
Association de comptes de service (IRSA)

  1. Ajout du référentiel Trident Helm :

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

  2. Définissez les valeurs pour fournisseur de cloud et identité cloud :

    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

    Vous pouvez utiliser helm list la commande pour consulter les détails de l'installation tels que le nom, l'espace de noms, le graphique, l'état, la version de l'application et le numéro de révision.

    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
Remarque

Si vous prévoyez d'utiliser iSCSI, assurez-vous qu'il est activé sur votre machine cliente. Si vous utilisez le système d'exploitation du nœud Worker AL2023, vous pouvez automatiser l'installation du client iSCSI en ajoutant le paramètre node prep à l'installation de Helm :

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

Installez Trident via le module complémentaire EKS

Le module complémentaire Trident EKS inclut les derniers correctifs de sécurité et de bogues, et est validé par AWS pour une utilisation avec Amazon EKS. Le module complémentaire EKS vous permet de vous assurer de manière cohérente que vos clusters Amazon EKS sont sécurisés et stables et de réduire la quantité de travail à effectuer pour installer, configurer et mettre à jour des modules complémentaires.

Prérequis

Vérifiez les points suivants avant de configurer le module complémentaire Trident pour AWS EKS :

  • Un compte de cluster Amazon EKS avec abonnement complémentaire

  • Autorisations AWS sur AWS Marketplace :
    "aws-marketplace:ViewSubscriptions",
    "aws-marketplace:Subscribe",
    "aws-marketplace:Unsubscribe

  • Type ami : Amazon Linux 2 (AL2_x86_64) ou Amazon Linux 2 Arm (AL2_ARM_64)

  • Type de nœud : AMD ou ARM

  • Un système de fichiers Amazon FSX pour NetApp ONTAP

Activez le module complémentaire Trident pour AWS

Console de gestion

  1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

  2. Dans le volet de navigation de gauche, sélectionnez clusters.

  3. Sélectionnez le nom du cluster pour lequel vous souhaitez configurer le module complémentaire NetApp Trident CSI.

  4. Sélectionnez Compléments, puis obtenir plus de modules complémentaires.

  5. Suivez ces étapes pour sélectionner le module complémentaire :

    1. Faites défiler jusqu'à la section Modules complémentaires AWS Marketplace et saisissez « Trident » dans la zone de recherche.

    2. Cochez la case dans le coin supérieur droit de la boîte Trident by NetApp.

    3. Sélectionnez Suivant.

  6. Sur la page configurer les compléments sélectionnés, procédez comme suit :

    Remarque Ignorez ces étapes si vous utilisez l’association d’identité de pod.

    1. Sélectionnez la version que vous souhaitez utiliser.

    2. Si vous utilisez l'authentification IRSA, assurez-vous de définir les valeurs de configuration disponibles dans les paramètres de configuration facultatifs :

      • Sélectionnez la version que vous souhaitez utiliser.

      • Suivez le schéma de configuration du module complémentaire et définissez le paramètre configurationValues dans la section Valeurs de configuration sur le rôle-arn que vous avez créé à l'étape précédente (la valeur doit être au format suivant) :

    {

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

}

    +
    Si vous sélectionnez remplacer pour la méthode de résolution des conflits, un ou plusieurs des paramètres du module complémentaire existant peuvent être remplacés par les paramètres du module complémentaire Amazon EKS. Si vous n'activez pas cette option et qu'il y a un conflit avec vos paramètres existants, l'opération échoue. Vous pouvez utiliser le message d'erreur qui en résulte pour résoudre le conflit. Avant de sélectionner cette option, assurez-vous que le module complémentaire Amazon EKS ne gère pas les paramètres que vous devez gérer vous-même.

  7. Choisissez Suivant.

  8. Sur la page consulter et ajouter, choisissez Créer.

    Une fois l'installation du module complémentaire terminée, le module complémentaire installé s'affiche.

CLI AWS

1. Créer le add-on.json déposer:

Pour l'identité du pod, utilisez le format suivant :

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

Pour l'authentification IRSA, utilisez le format suivant :

{
  "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"
  }
}
Remarque Remplacer <role ARN> par l'ARN du rôle créé à l'étape précédente.

2. Installez le module complémentaire Trident EKS.

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

L'exemple de commande suivant installe le module complémentaire Trident EKS :

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

Mettez à jour le module complémentaire Trident EKS

Console de gestion

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

  2. Dans le volet de navigation de gauche, sélectionnez clusters.

  3. Sélectionnez le nom du cluster pour lequel vous souhaitez mettre à jour le module complémentaire NetApp Trident CSI.

  4. Sélectionnez l'onglet Compléments.

  5. Sélectionnez Trident by NetApp, puis Edit.

  6. Sur la page configurer Trident par NetApp, procédez comme suit :

    1. Sélectionnez la version que vous souhaitez utiliser.

    2. Développez les Paramètres de configuration facultatifs et modifiez-les si nécessaire.

    3. Sélectionnez Enregistrer les modifications.

CLI AWS

L'exemple suivant met à jour le module complémentaire 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

  • Vérifiez la version actuelle de votre module complémentaire FSxN Trident CSI. Remplacez my-cluster par le nom de votre cluster.

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

    Exemple de sortie :

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'"}

  • Mettez à jour le complément à la version renvoyée sous MISE À JOUR DISPONIBLE dans la sortie de l'étape précédente.

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

Si vous supprimez l' --force option et que l'un des paramètres du module complémentaire Amazon EKS entre en conflit avec vos paramètres existants, la mise à jour du module complémentaire Amazon EKS échoue ; un message d'erreur s'affiche pour vous aider à résoudre le conflit. Avant de spécifier cette option, assurez-vous que le module complémentaire Amazon EKS ne gère pas les paramètres que vous devez gérer, car ces paramètres sont remplacés par cette option. Pour plus d'informations sur les autres options de ce paramètre, reportez-vous à la section "Addons". Pour plus d'informations sur la gestion de terrain Amazon EKS Kubernetes, reportez-vous à la section "Gestion de terrain Kubernetes".

Désinstallez/supprimez le module complémentaire Trident EKS

Vous avez deux options pour supprimer un module complémentaire Amazon EKS :

  • Préserver le logiciel complémentaire sur votre cluster – cette option supprime la gestion Amazon EKS de tous les paramètres. Il supprime également la possibilité pour Amazon EKS de vous informer des mises à jour et de mettre à jour automatiquement le module complémentaire Amazon EKS après avoir lancé une mise à jour. Cependant, il conserve le logiciel complémentaire sur votre cluster. Cette option fait du complément une installation auto-gérée, plutôt qu'un module complémentaire Amazon EKS. Avec cette option, vous n'avez plus à subir de temps d'indisponibilité. Conservez --preserve l'option dans la commande pour conserver le complément.

  • Supprimer entièrement le logiciel complémentaire de votre cluster – NetApp vous recommande de supprimer le module complémentaire Amazon EKS de votre cluster uniquement s'il n'y a pas de ressources qui en dépendent sur votre cluster. Supprimez l' --preserve option de la delete commande pour supprimer le complément.

Remarque Si le complément est associé à un compte IAM, le compte IAM n'est pas supprimé.
Console de gestion

  1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

  2. Dans le volet de navigation de gauche, sélectionnez clusters.

  3. Sélectionnez le nom du cluster pour lequel vous souhaitez supprimer le module complémentaire NetApp Trident CSI.

  4. Sélectionnez l'onglet Compléments, puis sélectionnez Trident by NetApp.*

  5. Sélectionnez Supprimer.

  6. Dans la boîte de dialogue Remove netapp_trident-operator confirmation, procédez comme suit :

    1. Si vous souhaitez qu'Amazon EKS cesse de gérer les paramètres du module complémentaire, sélectionnez préserver sur le cluster. Procédez ainsi si vous souhaitez conserver l'extension logicielle sur votre cluster afin de pouvoir gérer tous les paramètres du module complémentaire vous-même.

    2. Entrez netapp_trident-operator.

    3. Sélectionnez Supprimer.

CLI AWS

Remplacez my-cluster par le nom de votre cluster, puis exécutez la commande suivante.

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

La commande suivante désinstalle le module complémentaire Trident EKS :

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