Upgrade ISD-Argo Platform from v4.1.1 to v4.1.2

This document describes how to upgrade the ISD-Argo Platform from v4.1.1 to v4.1.2 on a Kubernetes cluster.

WARNING: Before starting the upgrade, take a backup of all the databases, particularly the Postgres DB. The backup procedures may vary depending on your usage of external DBs for Autopilot Services.

NOTE: Please note that v4.1.1 to v4.1.2 upgrade does not depend on or use an external script for db upgrade or data migration. So upgrading the helm chart would be enough.

Following are the sequence of activities to perform the upgrade.

• Pre-requisites

• Cloning the Repo and update values file

• Helm upgrade

• Post Installation Steps

• If an upgrade fails

Pre-requisites:

• Users need to have access to the Kubernetes Cluster and namespace where ISD-Argo Platform is running i.e v4.1.1 is running.

• Users need to have access to GitHub and be able to clone enterprise-argo repo.

Cloning the Repo and update values file:

1. Clone the enterprise-argo repo by using the below command:

   git clone https://github.com/OpsMx/enterprise-argo.git

2. You need to use isd-minimal-values.yaml file for upgrading to v4.1.2. Update the isd-minimal-values.yaml file with specifically ISD URL, Vela URL, Keycloak URL by using the below commands.

   sed -i "s/ISD.REPLACE.THIS.WITH.YOURCOMPANY.COM/<Provide your ISD url here>/g" isd-minimal-values.yaml

   sed -i "s/VELA.REPLACE.THIS.WITH.YOURCOMPANY.COM/<Provide your VELA url here>/g" isd-minimal-values.yaml

   sed -i "s/KEYCLOAK.REPLACE.THIS.WITH.YOURCOMPANY.COM/<Provide your Keycloak url here>/g" isd-minimal-values.yaml

   Note: The isd-minimal-values.yaml provided in the repo is adequate and recommended for ISD-Argo Platform standard Installation. If you would like to have some advanced-level configurations for secret management, cluster configuration, etc, you can use values.yaml. If you need any additional clarifications with respect to values.yaml for installation, please contact OpsMx support. Full values.yaml is available at: https://github.com/OpsMx/enterprise-argo/blob/main/charts/isdargo/values.yaml

Helm upgrade

Go to the cloned repo, for eg: cd enterprise-argo and execute the below command

helm upgrade <release name> charts/isdargo/ -f charts/isdargo/isd-minimal-values.yaml -n <namespace> --timeout=10m --debug

Wait for 10 minutes till the helm upgrade completes.

helm upgrade <release name> charts/isdargo/ -f charts/isdargo/isd-minimal-values.yaml -n <namespace> --timeout=10m --debug
Release "<release name>" has been upgraded. Happy Helming!
NAME: <release name>
LAST DEPLOYED: Mon Feb  6 19:40:34 2023
NAMESPACE: <namespace>
STATUS: deployed
REVISION: 2
TEST SUITE: None

Post Installation Steps

1. Login to ISD UI and check whether the ISD version is updated right after the help button in the top right corner. Refer to the image below.

   
2. Go to the Agent Screen in ISD UI and click on the three dots at end of the row of the Agent entry and then click on the “Edit” button. Refer to the image below.

   
3. Click the "Download Agent Manifest" button to download the Agent Manifest file as shown in the image below.

   
4. Apply the Agent Manifest file where ISD-Argo is running.

5. Go to the “CD Integration” page and check whether the agent status is healthy(green). Refer to the image below.

   
6. Please verify all the screens in ISD UI.

If an upgrade fails

If anything goes wrong during upgrade, please Rollback to the previous version using the below command:

helm rollback <release name> -n <namespace> <version number>