ISD-Argo Platform Standard Installation
Last updated
Was this helpful?
Last updated
Was this helpful?
This document provides step-by-step instructions for installing the ISD Platform and ability to add existing Argo CD instances via an agent in the target Kubernetes cluster.
It is assumed that you have installed a Kubernetes cluster with NGINX and cert-manager. If not, refer to the document for more information on the Environment setup for ISD for Argo.
Following are the sequence of activities to install ISD-Argo platform.
Create a namespace in your cluster using the below command. This is the name where we will install the ISD-Argo Platform.
Clone the Repo with ISD-Argo platform installation helm charts and change the directory to enterprise-argo by using below commands.
Configure URLs for ISD-Argo Platform, Keycloak and Vela as per your DNS record.
Update forwarder.externalName URL in isd-minimal-values.yaml. The actual DNS needs to be created/updated after installation.
Update the URLs of ISD-Argo Platform, Keycloak and Vela as per your DNS records in all occurrences of the isd-minimal-values.yaml
Add OpsMx helm repo to your local machine
Run the below command to install the ISD-Argo Platform using the helm chart.
Create vela-ingress tls secret using the wild-card certificate and key. For example, kubectl create secret tls vela-ingress -n opsmx-argo --cert cert1.pem --key privkey1.pem
Replace cert1.pem and privkey1.pem files in the above command with the certificates you have created from cert manager or your certificate provider.
Please use the below command to check the pods in your namespace.
Get the ISD-Argo Platform URL by using the below command.
Access the ISD-Argo Platform URL through browser and login into application using the credentials listed below:
User Name: admin
Password: Execute the following command to retrieve the password
In case "base64 command not found": Please execute the below command.
After the successful installation of ISD-Argo Platform and integration of existing Argo CD instances, you will see the applications defined in the Argo CD instances in the application dashboard of ISD-Argo Platform.
Everything installed but I don't see any applications.
If connecting to an existing Argo or adding a new Argo, please ensure that the user-token generated has admin RBAC permissions.
Clicking on an application in Home-screen takes me to a blank page or a page with an error.
Vela service needs wild-card DNS and wild-card TLS certificates for this to work due to restrictions in Argo CD.
We can test it by opening another tab in the browser and placing the "isd.VELA.REPLACE.THIS.WITH.YOURCOMPANY.COM" URL. It should load and say "Failed to load".
Note: The isd-argo-minimal-values.yaml provided in the repo is adequate and recommended for 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 OpsMx support.
Once installation is completed, please create/update the DNS, based on the loadbalancer created using instructions .
After executing the above command, copy the output and decode it using any online decoding site such as.
Once the ISD-Argo Platform installation is completed and the user is able to login to ISD-Argo Platform, the next step is to integrate existing Argo CD instances with ISD-Argo Platform. For more information regarding Integration of Argo CD with ISD, refer to the section “”.