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

Trident をインストール

共同作成者 netapp-aruldeepa
PDF

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

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

  • Helm

  • EKSアドオン

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

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

  1. Tridentインストーラパッケージのダウンロード

    Tridentインストーラパッケージには、Tridentオペレータの導入とTridentのインストールに必要なすべてのものが含まれています。GitHubのAssetsセクションから最新バージョンのTridentインストーラをダウンロードして展開します。

    wget https://github.com/NetApp/trident/releases/download/v25.02.0/trident-installer-25.02.0.tar.gz
tar -xf trident-installer-25.02.0.tar.gz
cd trident-installer

  2. 次の環境変数を使用して、* cloud provider フラグと cloud identity *フラグの値を設定します。

    次の例では、Tridentをインストールし、フラグをに設定し、 `cloud-identity`を `$CI`に `$CP`設定し `cloud-provider`ます。

    helm install trident trident-operator-100.2502.0.tgz \
--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。

    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

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_Linux_64 ARM）

  • ノードタイプ：AMDまたはARM

  • 既存のAmazon FSx for NetApp ONTAPファイルシステム

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

eksctl

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

eksctl create addon --name netapp_trident-operator --cluster <cluster_name> \
--service-account-role-arn arn:aws:iam::<account_id>:role/<role_name> --force
管理コンソール

  1. でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。

  2. 左側のナビゲーションペインで、*[クラスタ]*を選択します。

  3. NetApp Trident CSIアドオンを設定するクラスタの名前を選択します。

  4. *アドオン*を選択し、*追加のアドオン*を選択します。

  5. [アドオンの選択]ページで、次の手順を実行します。

    1. [AWS Marketplace EKS-addons]セクションで、* Trident by NetApp *チェックボックスを選択します。

    2. 「 * 次へ * 」を選択します。

  6. [Configure selected add-ons* settings]ページで、次の手順を実行します。

    1. 使用する*バージョン*を選択します。

    2. では、[Not set]*のままにします。

    3. Add-on構成スキーマ*に従って、* Configuration Values *セクションのconfigurationValuesパラメーターを前の手順で作成したrole-arnに設定します（値は次の形式にする必要があります。

      {

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

}

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

  7. [次へ]*を選択します。

  8. [確認して追加]ページで、*[作成]*を選択します。

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

AWS CLI

  1. ファイルを作成し add-on.json ます。

    {
  "clusterName": "<eks-cluster>",
  "addonName": "netapp_trident-operator",
  "addonVersion": "v25.02.1-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

Trident EKSアドオンの更新

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.02.1-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.02.1-eksbuild.1 --cluster my-cluster --force

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

管理コンソール

  1. Amazon EKSコンソールを開き https://console.aws.amazon.com/eks/home#/clustersます。

  2. 左側のナビゲーションペインで、*[クラスタ]*を選択します。

  3. NetApp Trident CSIアドオンを更新するクラスタの名前を選択します。

  4. [アドオン]タブを選択します。

  5. Trident by NetApp を選択し、 Edit *を選択します。

  6. [Configure Trident by NetApp *]ページで、次の手順を実行します。

    1. 使用する*バージョン*を選択します。

    2. [Optional configuration settings]*を展開し、必要に応じて変更します。

    3. 「変更を保存」を選択します。

AWS CLI

次の例では、EKSアドオンを更新します。

aws eks update-addon --cluster-name my-cluster netapp_trident-operator vpc-cni --addon-version v25.02.1-eksbuild.1 \
    --service-account-role-arn <role-ARN> --configuration-values '{}' --resolve-conflicts --preserve

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

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

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

  • クラスターからアドオンソフトウェアを完全に削除する–NetAppは、クラスターに依存するリソースがない場合にのみ、クラスターからAmazon EKSアドオンを削除することを推奨します。コマンドからオプションを削除してアドオンを削除し --preserve delete ます。

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

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

eksctl delete addon --cluster K8s-arm --name netapp_trident-operator
管理コンソール

  1. でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。

  2. 左側のナビゲーションペインで、*[クラスタ]*を選択します。

  3. NetApp Trident CSIアドオンを削除するクラスタの名前を選択します。

  4. アドオン*タブを選択し、 Trident by NetApp を選択します。

  5. 「 * 削除」を選択します。

  6. [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