Skip to main content
A newer release of this product is available.

Deploy Trident operator using Helm (Offline mode)

Contributors juliantap

You can deploy the Trident operator and install Astra Trident using Helm. This process applies to installations where the container images required by Astra Trident are stored in a private registry. If you do not have a private image registry, use the process for standard deployment.

Critical information about Astra Trident 23.07

You must read the following critical information about Astra Trident.

Critical information about Astra Trident
  • Kubernetes 1.27 is now supported in Trident. Upgrade Trident prior to upgrading Kubernetes.

  • Astra Trident strictly enforces the use of multipathing configuration in SAN environments, with a recommended value of find_multipaths: no in multipath.conf file.

    Use of non-multipathing configuration or use of find_multipaths: yes or find_multipaths: smart value in multipath.conf file will result in mount failures. Trident has recommended the use of find_multipaths: no since the 21.07 release.

Deploy the Trident operator and install Astra Trident using Helm

Using the Trident Helm Chart you can deploy the Trident operator and install Trident in one step.

Review the installation overview to ensure you've met installation prerequisites and selected the correct installation option for your environment.

Before you begin

In addition to the deployment prerequisites you need Helm version 3.

Steps
  1. Add the Astra Trident Helm repository:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart
  2. Use helm install and specify a name for your deployment and image registry location. Your Trident and CSI images can be located in one registry or different registries, but all CSI images must be located in the same registry. In the examples, 23.07.1 is the version of Astra Trident you are installing.

    Images in one registry
    helm install <name> netapp-trident/trident-operator --version 23.07.1 --set imageRegistry=<your-registry> --create-namespace --namespace <trident-namespace>
    Images in different registries

    You must append sig-storage to the imageRegistry to use different registry locations.

    helm install <name> netapp-trident/trident-operator --version 23.07.1 --set imageRegistry=<your-registry>/sig-storage --set operatorImage=<your-registry>/netapp/trident-operator:23.07.1 --set tridentAutosupportImage=<your-registry>/netapp/trident-autosupport:23.07 --set tridentImage=<your-registry>/netapp/trident:23.07.1 --create-namespace --namespace <trident-namespace>
    Note If you already created a namespace for Trident, the --create-namespace parameter will not create an additional namespace.

You can use helm list to review installation details such as name, namespace, chart, status, app version, and revision number.

Pass configuration data during install

There are two ways to pass configuration data during the install:

Option Description

--values (or -f)

Specify a YAML file with overrides. This can be specified multiple times and the rightmost file will take precedence.

--set

Specify overrides on the command line.

For example, to change the default value of debug, run the following --set command where 23.07.1 is the version of Astra Trident you are installing:

helm install <name> netapp-trident/trident-operator --version 23.07.1  --create-namespace --namespace trident --set tridentDebug=true

Configuration options

This table and the values.yaml file, which is part of the Helm chart, provide the list of keys and their default values.

Option Description Default

nodeSelector

Node labels for pod assignment

podAnnotations

Pod annotations

deploymentAnnotations

Deployment annotations

tolerations

Tolerations for pod assignment

affinity

Affinity for pod assignment

tridentControllerPluginNodeSelector

Additional node selectors for pods. Refer to [Understanding controller pods and node pods] for details.

tridentControllerPluginTolerations

Overrides Kubernetes tolerations for pods. Refer to [Understanding controller pods and node pods] for details.

tridentNodePluginNodeSelector

Additional node selectors for pods. Refer to [Understanding controller pods and node pods] for details.

tridentNodePluginTolerations

Overrides Kubernetes tolerations for pods. Refer to [Understanding controller pods and node pods] for details.

imageRegistry

Identifies the registry for the trident-operator, trident, and other images. Leave empty to accept the default.

""

imagePullPolicy

Sets the image pull policy for the trident-operator.

IfNotPresent

imagePullSecrets

Sets the image pull secrets for the trident-operator, trident, and other images.

kubeletDir

Allows overriding the host location of kubelet's internal state.

'"/var/lib/kubelet"`

operatorLogLevel

Allows the log level of the Trident operator to be set to: trace, debug, info, warn, error, or fatal.

"info"

operatorDebug

Allows the log level of the Trident operator to be set to debug.

true

operatorImage

Allows the complete override of the image for trident-operator.

""

operatorImageTag

Allows overriding the tag of the trident-operator image.

""

tridentIPv6

Allows enabling Astra Trident to work in IPv6 clusters.

false

tridentK8sTimeout

Overrides the default 30-second timeout for most Kubernetes API operations (if non-zero, in seconds).

0

tridentHttpRequestTimeout

Overrides the default 90-second timeout for the HTTP requests, with 0s being an infinite duration for the timeout. Negative values are not allowed.

"90s"

tridentSilenceAutosupport

Allows disabling Astra Trident periodic AutoSupport reporting.

false

tridentAutosupportImageTag

Allows overriding the tag of the image for Astra Trident AutoSupport container.

<version>

tridentAutosupportProxy

Allows Astra Trident AutoSupport container to phone home via an HTTP proxy.

""

tridentLogFormat

Sets the Astra Trident logging format (text or json).

"text"

tridentDisableAuditLog

Disables Astra Trident audit logger.

true

tridentLogLevel

Allows the log level of Astra Trident to be set to: trace, debug, info, warn, error, or fatal.

"info"

tridentDebug

Allows the log level of Astra Trident to be set to debug.

false

tridentLogWorkflows

Allows specific Astra Trident workflows to be enabled for trace logging or log suppression.

""

tridentLogLayers

Allows specific Astra Trident layers to be enabled for trace logging or log suppression.

""

tridentImage

Allows the complete override of the image for Astra Trident.

""

tridentImageTag

Allows overriding the tag of the image for Astra Trident.

""

tridentProbePort

Allows overriding the default port used for Kubernetes liveness/readiness probes.

""

windows

Allows Astra Trident to be installed on Windows worker node.

false

enableForceDetach

Allows enabling the force detach feature.

false

excludePodSecurityPolicy

Excludes the operator pod security policy from creation.

false

What's next