Upgrading with the Trident Operator¶
Trident’s operator now supports brownfield installations and provides an easy upgrade path for users that seek to use the operator and greatly simplify Trident’s operation. This document shall talk about the prerequisites and how the upgrade will work.
To upgrade using the Trident operator:
- Only CSI based Trident Installation may exist. To check if you are running
CSI Trident, examine the pods in your Trident namespace. If they follow the
trident-csi-*naming pattern, you are running CSI Trident. Move on to step 2.
- Only CRD based Trident Installation may exist. This represents all Trident
19.07and above. If you passed step 1, you have most likely also cleared step 2.
- CRDs that exist as a result of Trident CSI uninstallation are supported. If you have uninstalled CSI Trident and the metadata from the installation persists, you can upgrade using the operator.
- Only one Trident installation should exist across all the namespaces in a given Kubernetes cluster.
- You must be using a Kubernetes cluster that runs version
1.14and above. See Requirements
- Alpha Snapshot CRDs should not be present. If they are present, you must
remove them with
tridentctl obliviate alpha-snapshot-crd. This will delete the CRDs for the alpha snapshot spec. For existing snapshots that should be deleted/migrated, please read this blog.
Initiating the upgrade¶
After confirming that you meet the Prerequisites, you are good to go ahead and upgrade using the operator.
Upgrading from the operator¶
First, begin by removing any existing Trident Operator deployments. If you have an instance of the Trident Operator running (of the previous release, for example), you must remove it.
$ cd trident-installer $ kubectl delete -f deploy/bundle.yaml
Following this, you can now install the latest release of the operator by fetching the latest installer bundle and then installing the operator.
# Have you updated the yaml manifests? Generate your bundle.yaml # using the kustomization.yaml kubectl kustomize deploy/ > deploy/bundle.yaml # Create the resources and deploy the operator kubectl create -f deploy/bundle.yaml
You do not have to create the Operator CRDs nor the
again. Just deploy the operator with the respective Trident Operator image and
you are good to go.
Upgrading from a non-operator install¶
If you have a CSI Trident instance that has satisfied the Prerequisites, you can upgrade to the latest release of the Trident Operator by following the instructions provided in the Operator deployment. You must:
- Download the latest Trident release.
- Create the
tridentProvisionerCRD from the manifest.
- Deploy the operator.
- Create a
TridentProvisionerCR for installing Trident.
- Existing backends and PVCs will be automatically available.
All of this is documented in thoroughly in the Operator deployment section.
You will need to remove alpha snapshot CRDs (if they exist) before upgrading
using the operator. Use
tridentctl obliviate alpha-snapshot-crd to