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

Astra Trident をインストール

11/13/2024 共同作成者

PDF

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

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

Helm
EKSアドオン

If you want to make use of the snapshot functionality, install the CSI snapshot controller add-on. Refer to https://docs.aws.amazon.com/eks/latest/userguide/csi-snapshot-controller.html.

Helmを使用してAstra Tridentをインストール

Astra Tridentインストーラパッケージをダウンロード

Astra Tridentインストーラパッケージには、Tridentオペレータの導入とAstra Tridentのインストールに必要なものがすべて含まれています。最新バージョンのAstra TridentインストーラをGitHubの[Assets]セクションからダウンロードして展開します。
wget https://github.com/NetApp/trident/releases/download/v24.10.0/trident-installer-24.10.0.tar.gz
tar -xf trident-installer-24.10.0.tar.gz
cd trident-installer
次の環境変数を使用して、* cloud provider フラグと cloud identity *フラグの値を設定します。

export CP="AWS"
export CI="'eks.amazonaws.com/role-arn: arn:aws:iam::<accountID>:role/<AmazonEKS_FSxN_CSI_DriverRole>'"

次の例では、Astra Tridentをインストールし、フラグを $CP、 `cloud-identity`に `$CI`設定してい `cloud-provider`ます。
```
helm install trident trident-operator-100.2410.0.tgz --set cloudProvider=$CP --set cloudIdentity=$CI -–namespace trident
```
コマンドを使用して、名前、ネームスペース、グラフ、ステータス、アプリケーションのバージョン、リビジョン番号など、インストールの詳細を確認できます 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.2410.0    24.10.0
```

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

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

前提条件

AWS EKS用のAstra 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向けのAstra Tridentアドオンを有効にする

EKSクラスタ

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

eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.6.1-eksbuild
eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.6.1-eksbuild.1 （専用バージョンを使用）

オプションのパラメータを設定する場合 `cloudIdentity`は、EKSアドオンを使用してTridentをインストールするときにを指定して `cloudProvider`ください。

管理コンソール

でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。
左側のナビゲーションペインで、*[クラスタ]*をクリックします。
NetApp Trident CSIアドオンを設定するクラスタの名前をクリックします。
をクリックし、[その他のアドオンの入手]*をクリックします。
[* S * elect add-ons *]ページで、次の手順を実行します。
1. [AWS Marketplace EKS-addons]セクションで、* Astra Trident by NetApp *チェックボックスを選択します。
2. 「 * 次へ * 」をクリックします。

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

使用する*バージョン*を選択します。
では、[Not set]*のままにします。

*オプションの構成設定*を展開し、*アドオン構成スキーマ*に従って、*構成値*セクションのconfigurationValuesパラメーターを前の手順で作成したrole-arnに設定します（値は次の形式にする必要があります eks.amazonaws.com/role-arn: arn:aws:iam::464262061435:role/AmazonEKS_FSXN_CSI_DriverRole）。[Conflict resolution method]で[Override]を選択すると、既存のアドオンの1つ以上の設定をAmazon EKSアドオン設定で上書きできます。このオプションを有効にしない場合、既存の設定と競合すると、操作は失敗します。表示されたエラーメッセージを使用して、競合のトラブルシューティングを行うことができます。このオプションを選択する前に、Amazon EKSアドオンが自己管理に必要な設定を管理していないことを確認してください。

オプションのパラメータを設定する場合 `cloudIdentity`は、EKSアドオンを使用してTridentをインストールするときにを指定して `cloudProvider`ください。

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

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

AWS CLI

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

add-on.json
{

   "clusterName": "<eks-cluster>",
   "addonName": "netapp_trident-operator",
   "addonVersion": "v24.6.1-eksbuild.1",
   "serviceAccountRoleArn": "arn:aws:iam::123456:role/astratrident-role",
   "configurationValues": "{"cloudIdentity": "'eks.amazonaws.com/role-arn: arn:aws:iam::123456:role/astratrident-role'",
   "cloudProvider": "AWS"}"
}

オプションのパラメータを設定する場合 cloudIdentity`は `cloudProvider、EKSアドオンを使用したTridentのインストール時にとしてを指定して `AWS`ください。

Install the Astra<xmt-block0> Trident</xmt-block> EKS add-on

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

Astra Trident EKSアドオンの更新

EKSクラスタ

お使いの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    v24.6.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 v24.6.1-eksbuild.1 --cluster my-cluster --force

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

管理コンソール

Amazon EKSコンソールを開き https://console.aws.amazon.com/eks/home#/clustersます。
左側のナビゲーションペインで、*[クラスタ]*をクリックします。
NetApp Trident CSIアドオンを更新するクラスタの名前をクリックします。
[アドオン]タブをクリックします。
をクリックし、[Edit]*をクリックします。
[Configure Astra 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 v24.6.1-eksbuild.1 \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts --preserve

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

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

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

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

EKSクラスタ

次のコマンドは、Astra Trident EKSアドオンをアンインストールします。
eksctl delete addon --cluster K8s-arm --name netapp_trident-operator

管理コンソール

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

AWS CLI

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

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

Astra Trident をインストール

Creating your file...

Helmを使用してAstra Tridentをインストール

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

前提条件

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

Astra Trident EKSアドオンの更新

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