Trident installieren
Trident optimiert Amazon FSx for NetApp ONTAP Speicherverwaltung in Kubernetes, damit sich Ihre Entwickler und Administratoren auf die Anwendungsbereitstellung konzentrieren können.
Sie können Trident mit einer der folgenden Methoden installieren:
-
Helm
-
EKS Add-on
Wenn Sie die Snapshot-Funktionalität nutzen möchten, installieren Sie das CSI Snapshot Controller-Add-on. Weitere Informationen finden Sie unter "Snapshot-Funktionalität für CSI-Volumes aktivieren".
Trident über helm installieren
-
Fügen Sie das Trident Helm repository hinzu:
helm repo add netapp-trident https://netapp.github.io/trident-helm-chart -
Installieren Sie Trident anhand des folgenden Beispiels:
helm install trident-operator netapp-trident/trident-operator --version 100.2502.1 --namespace trident --create-namespaceSie können den
helm listBefehl verwenden, um Installationsdetails wie Name, Namespace, Chart, Status, App-Version und Revisionsnummer zu überprüfen.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
-
Fügen Sie das Trident Helm repository hinzu:
helm repo add netapp-trident https://netapp.github.io/trident-helm-chart -
Legen Sie die Werte für cloud provider und cloud identity fest:
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-namespaceSie können den
helm listBefehl verwenden, um Installationsdetails wie Name, Namespace, Chart, Status, App-Version und Revisionsnummer zu überprüfen.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
|
|
Wenn Sie iSCSI verwenden möchten, stellen Sie sicher, dass iSCSI auf Ihrem Client-Rechner aktiviert ist. Wenn Sie das AL2023 Worker node OS verwenden, können Sie die Installation des iSCSI-Clients automatisieren, indem Sie den node prep Parameter in der helm Installation hinzufügen:
|
Installieren Sie Trident über das EKS-Add-on
Das Trident EKS-Add-on enthält die neuesten Sicherheitspatches, Fehlerbehebungen und ist von AWS für die Verwendung mit Amazon EKS validiert. Das EKS-Add-on ermöglicht es Ihnen, konsequent sicherzustellen, dass Ihre Amazon EKS-Cluster sicher und stabil sind, und reduziert den Arbeitsaufwand, den Sie für die Installation, Konfiguration und Aktualisierung von Add-ons aufwenden müssen.
Voraussetzungen
Stellen Sie sicher, dass Sie Folgendes haben, bevor Sie das Trident-Add-on für AWS EKS konfigurieren:
-
Ein Amazon EKS-Clusterkonto mit Add-on-Abonnement
-
AWS-Berechtigungen für den AWS Marketplace:
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Subscribe",
"aws-marketplace:Unsubscribe -
AMI type: Amazon Linux 2 (AL2_x86_64) oder Amazon Linux 2 Arm (AL2_ARM_64)
-
Knotentyp: AMD oder ARM
-
Ein bestehendes Amazon FSx for NetApp ONTAP file system
Aktivieren Sie das Trident Add-on für AWS
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters.
-
Wählen Sie im linken Navigationsbereich Clusters aus.
-
Wählen Sie den Namen des Clusters aus, für den Sie das NetApp Trident CSI-Add-on konfigurieren möchten.
-
Wählen Sie Add-ons und dann Weitere Add-ons abrufen.
-
Führen Sie die folgenden Schritte aus, um das Add-on auszuwählen:
-
Scrollen Sie nach unten zum Abschnitt AWS Marketplace add-ons und geben Sie "Trident” in das Suchfeld ein.
-
Aktivieren Sie das Kästchen in der oberen rechten Ecke des Trident by NetApp-Feldes.
-
Wählen Sie Next.
-
-
Gehen Sie auf der Seite Ausgewählte Add-ons konfigurieren wie folgt vor:
Überspringen Sie diese Schritte, wenn Sie die Pod Identity association verwenden. -
Wählen Sie die Version aus, die Sie verwenden möchten.
-
Wenn Sie die IRSA-Authentifizierung verwenden, stellen Sie sicher, dass Sie die in den Optionalen Konfigurationseinstellungen verfügbaren Konfigurationswerte festlegen:
-
Wählen Sie die Version aus, die Sie verwenden möchten.
-
Folgen Sie dem Add-on-Konfigurationsschema und legen Sie den configurationValues-Parameter im Abschnitt Konfigurationswerte auf den role-arn fest, den Sie im vorherigen Schritt erstellt haben (Wert sollte folgendes Format haben):
-
{ "cloudIdentity": "'eks.amazonaws.com/role-arn: <role ARN>'", "cloudProvider": "AWS" }+
Wenn Sie bei der Konfliktlösungsmethode „Überschreiben“ auswählen, kann eine oder mehrere Einstellungen des bestehenden Add-ons mit den Amazon EKS add-on Einstellungen überschrieben werden. Wenn Sie diese Option nicht aktivieren und ein Konflikt mit Ihren bestehenden Einstellungen auftritt, schlägt der Vorgang fehl. Sie können die resultierende Fehlermeldung zur Fehlerbehebung des Konflikts verwenden. Bevor Sie diese Option auswählen, stellen Sie sicher, dass das Amazon EKS add-on keine Einstellungen verwaltet, die Sie selbst verwalten müssen. -
-
Wählen Sie Weiter.
-
Auf der Seite Review and add wählen Sie Create.
Nach Abschluss der Add-on-Installation sehen Sie Ihr installiertes Add-on.
1. Erstellen Sie die add-on.json Datei:
Für Pod Identity verwenden Sie das folgende Format:
|
|
Verwenden Sie die |
{
"clusterName": "<eks-cluster>",
"addonName": "netapp_trident-operator",
"addonVersion": "v25.6.0-eksbuild.1",
}
Für die IRSA-Authentifizierung verwenden Sie das folgende Format:
{
"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"
}
}
|
|
Ersetzen Sie <role ARN> durch den ARN der Rolle, die im vorherigen Schritt erstellt wurde.
|
2. Installieren Sie das Trident EKS-Add-on.
aws eks create-addon --cli-input-json file://add-on.json
Der folgende Beispielbefehl installiert das Trident EKS add-on:
eksctl create addon --name netapp_trident-operator --cluster <cluster_name> --force
Aktualisieren Sie das Trident EKS add-on
-
Öffnen Sie die Amazon EKS-Konsole https://console.aws.amazon.com/eks/home#/clusters.
-
Wählen Sie im linken Navigationsbereich Clusters aus.
-
Wählen Sie den Namen des Clusters aus, für den Sie das NetApp Trident CSI Add-on aktualisieren möchten.
-
Wählen Sie die Registerkarte Add-ons aus.
-
Wählen Sie Trident by NetApp und dann Bearbeiten aus.
-
Gehen Sie auf der Seite Trident konfigurieren von NetApp wie folgt vor:
-
Wählen Sie die Version aus, die Sie verwenden möchten.
-
Erweitern Sie die Optional configuration settings und nehmen Sie bei Bedarf Anpassungen vor.
-
Wählen Sie Save changes.
-
Das folgende Beispiel aktualisiert das EKS add-on:
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>'\"}"
-
Überprüfen Sie die aktuelle Version Ihres FSxN Trident CSI Add-on. Ersetzen Sie
my-clusterdurch Ihren Clusternamen.eksctl get addon --name netapp_trident-operator --cluster my-clusterBeispielausgabe:
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'"}
-
Aktualisieren Sie das Add-on auf die Version, die unter UPDATE AVAILABLE in der Ausgabe des vorherigen Schritts zurückgegeben wurde.
eksctl update addon --name netapp_trident-operator --version v25.6.0-eksbuild.1 --cluster my-cluster --force
Wenn Sie die --force Option entfernen und eine der Amazon EKS Add-on-Einstellungen mit Ihren bestehenden Einstellungen in Konflikt steht, schlägt die Aktualisierung des Amazon EKS Add-ons fehl; Sie erhalten eine Fehlermeldung, die Ihnen hilft, den Konflikt zu beheben. Bevor Sie diese Option festlegen, stellen Sie sicher, dass das Amazon EKS Add-on keine Einstellungen verwaltet, die Sie verwalten müssen, da diese Einstellungen mit dieser Option überschrieben werden. Weitere Informationen zu anderen Optionen für diese Einstellung finden Sie unter "Add-ons". Weitere Informationen zur Amazon EKS Kubernetes-Feldverwaltung finden Sie unter "Kubernetes-Feldmanagement".
Deinstallieren/entfernen Sie das Trident EKS Add-on
Sie haben zwei Optionen, ein Amazon EKS add-on zu entfernen:
-
Add-on-Software auf Ihrem Cluster beibehalten – Diese Option entfernt die Amazon EKS-Verwaltung aller Einstellungen. Außerdem wird die Möglichkeit entfernt, dass Amazon EKS Sie über Updates benachrichtigt und das Amazon EKS-Add-on nach einer Aktualisierung automatisch aktualisiert. Die Add-on-Software selbst bleibt jedoch auf Ihrem Cluster erhalten. Mit dieser Option wird das Add-on zu einer selbstverwalteten Installation, anstatt ein Amazon EKS-Add-on zu sein. Mit dieser Option gibt es keine Ausfallzeiten für das Add-on. Behalten Sie die
--preserveOption im Befehl bei, um das Add-on beizubehalten. -
Entfernen Sie die Add-on-Software vollständig aus Ihrem Cluster – NetApp empfiehlt, das Amazon EKS-Add-on nur dann aus Ihrem Cluster zu entfernen, wenn keine Ressourcen auf Ihrem Cluster davon abhängig sind. Entfernen Sie die
--preserveOption aus demdeleteBefehl, um das Add-on zu entfernen.
|
|
Wenn dem Add-on eine IAM-Konto zugeordnet ist, wird das IAM-Konto nicht entfernt. |
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters.
-
Wählen Sie im linken Navigationsbereich Clusters aus.
-
Wählen Sie den Namen des Clusters aus, für den Sie das NetApp Trident CSI-Add-on entfernen möchten.
-
Wählen Sie die Registerkarte Add-ons und dann Trident by NetApp.*
-
Wählen Sie Remove.
-
Führen Sie im Dialogfeld Remove netapp_trident-operator confirmation die folgenden Schritte aus:
-
Wenn Amazon EKS die Einstellungen für das Add-on nicht mehr verwalten soll, wählen Sie Preserve on cluster. Tun Sie dies, wenn Sie die Add-on-Software auf Ihrem Cluster behalten und alle Einstellungen des Add-ons selbst verwalten möchten.
-
Geben Sie netapp_trident-operator ein.
-
Wählen Sie Remove.
-
Ersetzen Sie my-cluster durch den Namen Ihres Clusters und führen Sie dann den folgenden Befehl aus.
aws eks delete-addon --cluster-name my-cluster --addon-name netapp_trident-operator --preserve
Der folgende Befehl deinstalliert das Trident EKS add-on:
eksctl delete addon --cluster K8s-arm --name netapp_trident-operator