日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Trident をインストール

09/02/2025 共同作成者

PDF

Tridentは、KubernetesでAmazon FSx for NetApp ONTAPストレージ管理を合理化し、開発者や管理者がアプリケーションの導入に集中できるようにします。

次のいずれかの方法でTridentをインストールできます。

Helm
EKSアドオン

スナップショット機能を利用する場合は、CSIスナップショットコントローラアドオンをインストールします。詳細については、を参照してください "CSIボリュームのスナップショット機能を有効にする" 。

Helmを使用したTridentのインストール

ポッドのアイデンティティ

Trident Helmリポジトリを追加します。

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

次の例を使用して Trident をインストールします。

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

コマンドを使用して、名前、ネームスペース、グラフ、ステータス、アプリケーションのバージョン、リビジョン番号など、インストールの詳細を確認できます helm list。

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

サービスアカウントアソシエーション (IRSA)

Trident Helmリポジトリを追加します。

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

クラウドプロバイダー と クラウド ID の値を設定します。

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

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

iSCSI を使用する場合は、クライアントマシンで iSCSI が有効になっていることを確認してください。AL2023Worker node OS を使用している場合は、helm インストール時に node prep パラメータを追加することで、iSCSI クライアントのインストールを自動化できます。

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

EKSアドオンを使用してTridentをインストールする

Trident EKSアドオンには、最新のセキュリティパッチ、バグ修正が含まれており、AWSによってAmazon EKSと連携することが検証されています。EKSアドオンを使用すると、Amazon EKSクラスタの安全性と安定性を一貫して確保し、アドオンのインストール、構成、更新に必要な作業量を削減できます。

前提条件

AWS EKS用のTridentアドオンを設定する前に、次の条件を満たしていることを確認してください。

アドオンサブスクリプションがあるAmazon EKSクラスタアカウント
AWS MarketplaceへのAWS権限：
"aws-marketplace:ViewSubscriptions", "aws-marketplace:Subscribe", "aws-marketplace:Unsubscribe
AMIタイプ：Amazon Linux 2（AL2_x86_64）またはAmazon Linux 2 Arm（AL2_ARM_64）
ノードタイプ：AMDまたはARM
既存のAmazon FSx for NetApp ONTAPファイルシステム

AWS向けTridentアドオンを有効にする

管理コンソール

でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。
左側のナビゲーションペインで、*[クラスタ]*を選択します。
NetApp Trident CSIアドオンを設定するクラスタの名前を選択します。
*アドオン*を選択し、*追加のアドオン*を選択します。
アドオンを選択するには、次の手順に従います。
1. AWS Marketplace アドオン セクションまでスクロールし、検索ボックスに 「Trident」 と入力します。
2. Trident by NetApp ボックスの右上隅にあるチェックボックスを選択します。
3. 「 * 次へ * 」を選択します。
[Configure selected add-ons* settings]ページで、次の手順を実行します。

Pod Identity 関連付けを使用している場合は、これらの手順をスキップしてください。
1. 使用する*バージョン*を選択します。
2. IRSA 認証を使用している場合は、オプション構成設定で使用可能な構成値を必ず設定してください。
  - 使用する*バージョン*を選択します。
  - アドオン構成スキーマ に従って、構成値 セクションの configurationValues パラメータを、前の手順で作成した role-arn に設定します (値は次の形式である必要があります)。
```
{

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

}
```
+
[Conflict resolution method]で[Override]を選択すると、既存のアドオンの1つ以上の設定をAmazon EKSアドオン設定で上書きできます。このオプションを有効にしない場合、既存の設定と競合すると、操作は失敗します。表示されたエラーメッセージを使用して、競合のトラブルシューティングを行うことができます。このオプションを選択する前に、Amazon EKSアドオンが自己管理に必要な設定を管理していないことを確認してください。
[次へ]*を選択します。
[確認して追加]ページで、*[作成]*を選択します。

アドオンのインストールが完了すると、インストールされているアドオンが表示されます。

AWS CLI

1.作成する `add-on.json`ファイル：

Pod Identity の場合は、次の形式を使用します:

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

IRSA 認証の場合は、次の形式を使用します:

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

を、前の手順で作成したロールのARNに置き換えます <role ARN>。

2.Trident EKS アドオンをインストールします。

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

eksctl

次の例では、Trident EKSアドオンをインストールします。

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

Trident EKSアドオンの更新

管理コンソール

Amazon EKSコンソールを開き https://console.aws.amazon.com/eks/home#/clustersます。
左側のナビゲーションペインで、*[クラスタ]*を選択します。
NetApp Trident CSIアドオンを更新するクラスタの名前を選択します。
[アドオン]タブを選択します。
Trident by NetApp を選択し、 Edit *を選択します。
[Configure Trident by NetApp *]ページで、次の手順を実行します。
1. 使用する*バージョン*を選択します。
2. [Optional configuration settings]*を展開し、必要に応じて変更します。
3. 「変更を保存」を選択します。

AWS CLI

次の例では、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

お使いのFSxN Trident CSIアドオンの現在のバージョンを確認してください。をクラスタ名に置き換え `my-cluster`ます。
```
eksctl get addon --name netapp_trident-operator --cluster my-cluster
```
出力例：

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

前の手順の出力でupdate availableで返されたバージョンにアドオンを更新します。

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

オプションを削除し、いずれかのAmazon EKSアドオン設定が既存の設定と競合している場合 --force 、Amazon EKSアドオンの更新は失敗します。競合の解決に役立つエラーメッセージが表示されます。このオプションを指定する前に、管理する必要がある設定がAmazon EKSアドオンで管理されていないことを確認してください。これらの設定はこのオプションで上書きされます。この設定のその他のオプションの詳細については、を参照してください "アドオン"。Amazon EKS Kubernetesフィールド管理の詳細については、を参照してください "Kubernetesフィールド管理"。

Trident EKSアドオンのアンインストール/削除

Amazon EKSアドオンを削除するには、次の2つのオプションがあります。

クラスタにアドオンソフトウェアを保持–このオプションを選択すると、Amazon EKSによる設定の管理が削除されます。また、Amazon EKSが更新を通知し、更新を開始した後にAmazon EKSアドオンを自動的に更新する機能も削除されます。ただし、クラスタ上のアドオンソフトウェアは保持されます。このオプションを選択すると、アドオンはAmazon EKSアドオンではなく自己管理型インストールになります。このオプションを使用すると、アドオンのダウンタイムは発生しません。アドオンを保持するには、コマンドのオプションをそのまま使用し --preserve ます。
クラスターからアドオンソフトウェアを完全に削除する–NetAppは、クラスターに依存するリソースがない場合にのみ、クラスターからAmazon EKSアドオンを削除することを推奨します。コマンドからオプションを削除してアドオンを削除し --preserve delete ます。

アドオンにIAMアカウントが関連付けられている場合、IAMアカウントは削除されません。

管理コンソール

でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。
左側のナビゲーションペインで、*[クラスタ]*を選択します。
NetApp Trident CSIアドオンを削除するクラスタの名前を選択します。
アドオン*タブを選択し、 Trident by NetApp を選択します。
「 * 削除」を選択します。
[Remove netapp_trident-operator confirmation]*ダイアログで、次の手順を実行します。
1. Amazon EKSでアドオンの設定を管理しないようにするには、*[クラスタに保持]*を選択します。クラスタにアドオンソフトウェアを残して、アドオンのすべての設定を自分で管理できるようにする場合は、この手順を実行します。
2. 「netapp_trident -operator *」と入力します。
3. 「 * 削除」を選択します。

AWS CLI

をクラスタの名前に置き換え my-cluster 、次のコマンドを実行します。

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

eksctl

次のコマンドは、Trident EKSアドオンをアンインストールします。

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

Trident をインストール

Creating your file...

Helmを使用したTridentのインストール

EKSアドオンを使用してTridentをインストールする

前提条件

AWS向けTridentアドオンを有効にする

Trident EKSアドオンの更新

Trident EKSアドオンのアンインストール/削除