Upgrade ISD-Argo Platform from v4.1.2 to v4.1.3
This document describes how to upgrade the ISD-Argo Platform from v4.1.2 to v4.1.3 on a Kubernetes cluster.
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.
Following are the sequence of activities to perform the upgrade.
Pre-requisites:
Users need to have access to the Kubernetes Cluster and namespace where “ISD-Argo with Argo CD and Argo Rollouts” is running i.e v4.1.2 is running.
Users need to have access to GitHub and be able to clone enterprise-argo repo.
Cloning the Repo and update values file:
Clone the enterprise-argo repo by using the below command
git clone https://github.com/OpsMx/enterprise-argo.git cd enterprise-argo/charts/isdargo/
You need to use isd-argo-minimal-values.yaml file for upgrading to v4.1.3.
Configure URLs for ISD-Argo Platform, Keycloak and Vela as per your DNS record.
Update the URLs of ISD-Argo Platform, Keycloak and Vela as per your DNS records in all occurrences of the isd-minimal-values.yaml
Update forwarder.externalName URL in isd-minimal-values.yaml. The actual DNS needs to be created/updated after installation.
Helm upgrade
Add OpsMx helm repo to your local machine.
helm repo add isdargo https://opsmx.github.io/enterprise-argo/
helm repo update
Execute the below command to upgrade.
helm upgrade isd isdargo/isdargo -f isd-minimal-values.yaml -n opsmx-argo
--timeout=15m --debug
Wait for 15 minutes till the helm upgrade completes.
helm upgrade isd isdargo/isdargo -f isd-minimal-values.yaml -n opsmx-argo
--timeout=15m --debug
Release "isd" has been upgraded. Happy Helming!
NAME: isd
LAST DEPLOYED: Mon Feb 6 19:40:34 2023
NAMESPACE: opsmx-argo
STATUS: deployed
REVISION: 2
TEST SUITE: None
Please use the below command to check the pods in your namespace.
kubectl -n opsmx-argo get pods
Once installation is completed, please create/update the DNS, based on the loadbalancer created using instructions here.
Post Installation Steps
Vela Service requires the “Wild-card ingress” and “Wild-card TLS certificates to be provided to the ingress”. If you are using the cert-manager, please use this blog to create a Wild-card TLS certificate. Else please contact your certificate provider for the certificates for your URL equivalent for "*.VELA.REPLACE.THIS.WITH.YOURCOMPANY.COM".
Create vela-ingress tls secret using the wild-card certificate and key. Replace cert1.pem and privkey1.pem file in the below command with the certificates you have created from cert manager or your certificate provider. For example,
kubectl create secret tls vela-ingress -n opsmx-argo --cert cert1.pem --key privkey1.pem
Login to ISD UI and check whether the ISD version is updated right after the help button in the top right corner.
Go to the Agent Screen in ISD UI and click on the three dots at the end of the row of the Agent entry and then click the Edit button as shown in the image below.
Click the Download Agent Manifest button to download the Agent Manifest file as shown in the image below.
Apply the Agent Manifest file where ISD-Argo Platform is running by using the below command.
kubectl apply -f isd-argo-agent.yml -n opsmx-argo
Delete the Agent pod by using the below command.
kubectl delete po -l agent.opsmx.com/role=agent -n opsmx-argo
Go to the “CD Integration” page and check whether the agent status is healthy(green) as shown in the image below.
Please verify all the screens in ISD UI.
If an upgrade fails
If anything goes wrong during upgrade, please use the below command to get the helm history.
helm history isd -n opsmx-argo
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION
1 Mon Oct 31 18:55:01 2022 superseded isdargo-4.1.0 4.1.0 Install complete
2 Wed Nov 16 16:10:13 2022 superseded isdargo-4.1.0 4.1.0 Upgrade complete
3 Fri Dec 2 14:11:53 2022 superseded isdargo-4.1.2 4.1.2 Upgrade complete
4 Wed Feb 15 11:21:32 2023 superseded isdargo-4.1.3 4.1.3 Upgrade complete
5 Wed Feb 15 11:38:59 2023 deployed isdargo-4.1.3 4.1.3 Upgrade complete
Use below command to rollback to the previous version
helm rollback isd -n opsmx-argo <version number>
Last updated
Was this helpful?