ISD-Argo Installation with Argo CD and Argo Rollouts
Last updated
Was this helpful?
Last updated
Was this helpful?
This document provides step-by-step instructions for installing ISD-Argo with the ability to add additional Argo CD instances. The installation involves the following components:
ISD Platform
Argo CD and Rollout instances through
After successful installation, Argo CD will be integrated with ISD by default through an agent.
Argo CD -
Argo Rollouts -
Argo CLI - v2.8.4
It is assumed that you have a Kubernetes cluster with NGINX and cert-manager already installed. If not, refer to the document for more information on the Environment setup for ISD for Argo.
Following are the sequence of activities for ISD-Argo Installation with Argo CD and Argo Rollouts.
Create a namespace in your cluster by executing the below command.
Clone the enterprise Argo repo and change the directory to enterprise-argo by using below commands.
Configure URLs for ISD, Argo CD, Argo Rollouts, Keycloak and Vela as per your DNS record.
Update the URLs of ISD, Argo CD, Argo Rollouts, Keycloak and Vela as per your DNS records in all occurrences of the isd-argo-minimal-values.yaml. Optional: Update forwarder.externalName URL in isd-argo-minimal-values.yaml. The actual DNS needs to be created/updated after installation.
Add opsmx helm repo to your local machine.
Run the below command to install the application 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 file 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, Argo CD URLs by using the below command.
Access the URLs (ISD/Argo CD) 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.
Now go to the ISD UI and refresh it, you will see the Agent in healthy status, which means the agent is successfully connected to ISD and Argo CD is integrated with ISD by default. Refer to the image below.
Now you can create applications in Argo CD and they will automatically sync in ISD.
Everything is installed but I don't see any applications.
It automatically installs sample applications, including a working rollouts sample.
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".
After the successful installation, you can create an application and enable the verification for the deployment of your application.
Note: The isd-argo-minimal-values.yaml provided in the repo is adequate and recommended for “ISD-Argo Installation with Argo CD and Argo Rollouts” 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.
Optional: 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.
To create an application, refer .
To enable verification , refer .