Skip to main content

Install Astra Trident

Contributors netapp-aruldeepa

Astra Trident streamlines Amazon FSx for NetApp ONTAP storage management in Kubernetes to enable your developers and administrators focus on application deployment.

You can install Astra Trident using one of the following methods:

  • Helm

  • EKS add-on

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.

Install Astra Trident via helm

Set the values for cloud provider and cloud identity flags using the following environment variables:

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

The following example installs Astra Trident and sets the cloud-provider flag to $CP, and cloud-identity to $CI:

helm install trident trident-operator-100.2406.0.tgz --set cloudProvider=$CP --set cloudIdentity=$CI -–namespace trident

Install Astra Trident via the EKS add-on

The Astra Trident EKS add-on includes the latest security patches, bug fixes, and is validated by AWS to work with Amazon EKS. The EKS add-on enables you to consistently ensure that your Amazon EKS clusters are secure and stable and reduce the amount of work that you need to do in order to install, configure, and update add-ons.

Prerequisites

Ensure that you have the following before configuring the Astra Trident add-on for AWS EKS:

  • An Amazon EKS cluster account with add-on subscription

  • AWS permissions to the AWS marketplace:
    "aws-marketplace:ViewSubscriptions",
    "aws-marketplace:Subscribe",
    "aws-marketplace:Unsubscribe

  • AMI type: Amazon Linux 2 (AL2_x86_64) or Amazon Linux 2 Arm(AL2_ARM_64)

  • Node type: AMD or ARM

  • An existing Amazon FSx for NetApp ONTAP file system

Enable the Astra Trident add-on for AWS

EKS cluster

The following example commands install the Astra Trident EKS add-on:

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 (with a dedicated version)

Management console

  1. Open the Amazon EKS console at https://console.aws.amazon.com/eks/home#/clusters.

  2. On the left navigation pane, click Clusters.

  3. Click the name of the cluster that you want to configure the NetApp Trident CSI add-on for.

  4. Click Add-ons and then click Get more add-ons.

  5. On the S*elect add-ons page, do the following:

    1. In the AWS Marketplace EKS-addons section, select the Astra Trident by NetApp check box.

    2. Click Next.

  6. On the Configure selected add-ons settings page, do the following:

    1. Select the Version you would like to use.

    2. For Select IAM role, leave at Not set.

    3. Expand the Optional configuration settings, follow the Add-on configuration schema and set the configurationValues parameter on the Configuration values section to the role-arn you created on the previous step (value should be in the following format: eks.amazonaws.com/role-arn: arn:aws:iam::464262061435:role/AmazonEKS_FSXN_CSI_DriverRole). If you select Override for the Conflict resolution method, one or more of the settings for the existing add-on can be overwritten with the Amazon EKS add-on settings. If you don't enable this option and there's a conflict with your existing settings, the operation fails. You can use the resulting error message to troubleshoot the conflict. Before selecting this option, make sure that the Amazon EKS add-on doesn't manage settings that you need to self-manage.

  7. Choose Next.

  8. On the Review and add page, choose Create.

    After the add-on installation is complete, you see your installed add-on.

AWS CLI

  1. Create the add-on.json file:

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

  2. Install the Astra Trident EKS add-on"

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

Update the Astra Trident EKS add-on

EKS cluster

  • Check the current version of your FSxN Trident CSI add-on. Replace my-cluster with your cluster name.
    eksctl get addon --name netapp_trident-operator --cluster my-cluster

    Example output:

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 the add-on to the version returned under UPDATE AVAILABLE in the output of the previous step.
    eksctl update addon --name netapp_trident-operator --version v24.2.0-eksbuild.1 --cluster my-cluster --force

    If you remove the --force option and any of the Amazon EKS add-on settings conflict with your existing settings, then updating the Amazon EKS add-on fails; you receive an error message to help you resolve the conflict. Before specifying this option, make sure that the Amazon EKS add-on does not manage settings that you need to manage, because those settings are overwritten with this option.
    For more information about other options for this setting, see Addons.
    For more information about Amazon EKS Kubernetes field management, see Kubernetes field management.

Management console

  1. Open the Amazon EKS console https://console.aws.amazon.com/eks/home#/clusters.

  2. On the left navigation pane, click Clusters.

  3. Click the name of the cluster that you want to update the NetApp Trident CSI add-on for.

  4. Click the Add-ons tab.

  5. Click Astra Trident by NetApp and then click Edit.

  6. On the Configure Astra Trident by NetApp page, do the following:

    1. Select the Version you would like to use.

    2. (Optional) You can expand the Optional configuration settings and modify as needed.

    3. Click Save changes.

AWS CLI

The following example updates the EKS add-on:

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

Uninstall/remove the Astra Trident EKS add-on

You have two options for removing an Amazon EKS add-on:

  • Preserve add-on software on your cluster – This option removes Amazon EKS management of any settings. It also removes the ability for Amazon EKS to notify you of updates and automatically update the Amazon EKS add-on after you initiate an update. However, it preserves the add-on software on your cluster. This option makes the add-on a self-managed installation, rather than an Amazon EKS add-on. With this option, there's no downtime for the add-on. Retain the --preserve option in the command to preserve the add-on.

  • Remove add-on software entirely from your cluster – We recommend that you remove the Amazon EKS add-on from your cluster only if there are no resources on your cluster that are dependent on it. Remove the --preserve option from the delete command to remove the add-on.

Note If the add-on has an IAM account associated with it, the IAM account is not removed.
EKS cluster

The following command uninstalls the Astra Trident EKS add-on:
eksctl delete addon --cluster K8s-arm --name netapp_trident-operator

Management console

  1. Open the Amazon EKS console at https://console.aws.amazon.com/eks/home#/clusters.

  2. In the left navigation pane, click Clusters.

  3. Click the name of the cluster that you want to remove the NetApp Trident CSI add-on for.

  4. Click the Add-ons tab and then click Astra Trident by NetApp.*

  5. Click Remove.

  6. In the Remove netapp_trident-operator confirmation dialog, do the following:

    1. If you want Amazon EKS to stop managing settings for the add-on, select Preserve on cluster. Do this if you want to retain the add-on software on your cluster so that you can manage all of the settings of the add-on on your own.

    2. Enter netapp_trident-operator.

    3. Click Remove.

AWS CLI

Replace my-cluster with the name of your cluster, and then run the following command.

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