Astra Trident をインストール
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をインストール
次の環境変数を使用して、* 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をインストールして cloud-provider
フラグの対象 $CP`および `cloud-identity
終了: $CI
:
helm install trident trident-operator-100.2406.0.tgz --set cloudProvider=$CP --set cloudIdentity=$CI -–namespace trident
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アドオンを有効にする
次のコマンド例は、Astra Trident EKSアドオンをインストールします。
eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.02.0-eksbuild.
eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.02.0-eksbuild.1
(専用バージョンを使用)
-
でAmazon EKSコンソールを開きます https://console.aws.amazon.com/eks/home#/clusters。
-
左側のナビゲーションペインで、*[クラスタ]*をクリックします。
-
NetApp Trident CSIアドオンを設定するクラスタの名前をクリックします。
-
をクリックし、[その他のアドオンの入手]*をクリックします。
-
[* S * elect add-ons *]ページで、次の手順を実行します。
-
[AWS Marketplace EKS-addons]セクションで、* Astra Trident by NetApp *チェックボックスを選択します。
-
「 * 次へ * 」をクリックします。
-
-
[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アドオンが自己管理に必要な設定を管理していないことを確認してください。
-
-
[次へ]*を選択します。
-
[確認して追加]ページで、*[作成]*を選択します。
アドオンのインストールが完了すると、インストールされているアドオンが表示されます。
-
ファイルを作成し
add-on.json
ます。add-on.json { "clusterName": "<eks-cluster>", "addonName": "netapp_trident-operator", "addonVersion": "v24.2.0-eksbuild.1", "serviceAccountRoleArn": "arn:aws:iam::123456:role/astratrident-role", "configurationValues": "{"cloudIdentity": "'eks.amazonaws.com/role-arn: arn:aws:iam::123456:role/astratrident-role'"}" }
-
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アドオンの更新
-
お使いの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.2.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 v24.2.0-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 *]ページで、次の手順を実行します。
-
使用する*バージョン*を選択します。
-
(オプション)* Optional configuration settings *を展開し、必要に応じて変更できます。
-
[ 変更の保存 *] をクリックします。
-
次の例では、EKSアドオンを更新します。
aws eks update-addon --cluster-name my-cluster netapp_trident-operator vpc-cni --addon-version v24.2.0-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アカウントは削除されません。 |
次のコマンドは、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]*ダイアログで、次の手順を実行します。
-
Amazon EKSでアドオンの設定を管理しないようにするには、*[クラスタに保持]*を選択します。クラスタにアドオンソフトウェアを残して、アドオンのすべての設定を自分で管理できるようにする場合は、この手順を実行します。
-
「netapp_trident -operator *」と入力します。
-
[ 削除( Remove ) ] をクリックします。
-
をクラスタの名前に置き換え my-cluster
、次のコマンドを実行します。
aws eks delete-addon --cluster-name my-cluster --addon-name netapp_trident-operator --preserve