Upgrade Portworx Backup Using Argo CD
This topic details how to upgrade Portworx Backup using Argo CD.
Prerequisites
Before you upgrade Portworx Backup using Argo CD, ensure that:
-
Your cluster meets the Requirements for Upgrading Portworx Backup.
-
Portworx Backup is already deployed using Argo CD. For initial installation steps, see Install Portworx Backup using Argo CD.
-
Argo CD is running at the version qualified for the Portworx Backup release you are upgrading to. Portworx Backup qualifies a specific Argo CD version for each release; for Portworx Backup 3.2.x, the qualified version is v3.2.5. For the full list, see Portworx Backup Argo CD compatibility matrix.
-
You have generated the Portworx Backup spec and created the
pxc-credentialssecret. For more information, see Generate Portworx Backup Spec. -
The
installCRDsparameter is removed from your Argo CD application values (values-px-central.yaml). Starting with Portworx Backup 3.2.0, this parameter is removed because Portworx Backup installs the required CRDs as part of the upgrade. Remove it before you upgrade to Portworx Backup 3.2.0 or later. For more information, see The installCRDs parameter. -
If your Portworx Enterprise clusters still use a license server that you installed with Portworx Backup 3.1.1 or earlier. Then you have to annotate the license server resources, so that Argo CD doesn't prune them during the upgrade:
kubectl annotate -n <pxb-namespace> \deploy/pxcentral-license-server svc/pxcentral-license \secret/px-license-secret cm/pxcentral-ls-configmap \argocd.argoproj.io/sync-options=Prune=false \argocd.argoproj.io/compare-options=IgnoreExtraneous --overwriteReplace
<pxb-namespace>with the namespace where Portworx Backup is deployed.
Upgrade Portworx Backup using Argo CD
To upgrade Portworx Backup using Argo CD, follow these steps:
-
Log in and access the Argo CD web console.
-
Navigate to Applications > Portworx Backup application card > Details > MANIFEST > Edit.
-
Set the
isUpgradeparameter totrue.Argo CD renders the pre-upgrade hook only when
isUpgradeistrue. -
Set the
targetRevisionparameter value to the required Portworx Backup version.noteFor air-gapped environments, ensure that you download, extract, and commit the required
px-central-<pxb-version>.tgzpackage to the git branch specified intargetRevisionparameter. -
Click Save.
-
Click SYNC.
-
Select the Prune option and start the sync.
Argo CD web console upgrades Portworx Backup version to the required version. Argo CD also deletes the license server resources from Portworx Backup 3.1.1 or earlier, so that they aren't left
OutOfSync. If you annotated the license server resources as described in Prerequisites, Argo CD keeps them.
What to do next
On each application cluster that you back up, upgrade Stork to a version compatible with your upgraded Portworx Backup version.