ISD-Argo Platform Standard Installation

Note: This Installation is only for ISD Platform which connects to existing OSS Argo CD instances.

Introduction:

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.

Environment Requirements:

It is assumed that you have installed a Kubernetes cluster with NGINX and cert-manager. If not, refer to the document here for more information on the Environment setup for ISD for Argo.

ISD-Argo Platform Installation Steps:

Following are the sequence of activities to install ISD-Argo platform.

1. Create Namespace

2. Clone the Repo

3. Configure URL

4. Install ISD-Argo Platform

5. Confirm Installation

6. Integrate with existing Argo CD Instances

7. Troubleshooting

Step:1 Create Namespace

Create a namespace in your cluster using the below command. This is the name where we will install the ISD-Argo Platform.

kubectl create ns opsmx-argo

Step:2 Clone the Installation Helm Charts Repo

Clone the Repo with ISD-Argo platform installation helm charts and change the directory to enterprise-argo by using below commands.

git clone https://github.com/OpsMx/enterprise-argo.git -b v4.1.6
cd enterprise-argo/charts/isdargo/

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 contact OpsMx support.

Step:3 Configure URLs

1. Configure URLs for ISD-Argo Platform, Keycloak and Vela as per your DNS record.

2. Update forwarder.externalName URL in isd-minimal-values.yaml. The actual DNS needs to be created/updated after installation.

3. Update the URLs of ISD-Argo Platform, Keycloak and Vela as per your DNS records in all occurrences of the isd-minimal-values.yaml

Step:4 Install ISD-Argo Platform

1. Add OpsMx helm repo to your local machine

   helm repo add isdargo https://opsmx.github.io/enterprise-argo/

   Note: If OpsMx helm repo is already added, do a repo update before installing the chart by executing the below command.

   helm repo update

2. Run the below command to install the ISD-Argo Platform using the helm chart.

   helm install isd isdargo/isdargo -f isd-minimal-values.yaml -n opsmx-argo --timeout 15m

3. Once installation is completed, please create/update the DNS, based on the loadbalancer created using instructions here.

4. 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.

Step:5 Confirm Installation

1. Please use the below command to check the pods in your namespace.

   kubectl -n opsmx-argo get pods

2. Get the ISD-Argo Platform URL by using the below command.

   kubectl -n opsmx-argo get ing

3. 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

     kubectl -n opsmx-argo get secret openldap -o jsonpath='{.data.LDAP_ADMIN_PASSWORD}'| base64 -d

   In case "base64 command not found": Please execute the below command.

   kubectl -n opsmx-argo get secret openldap -o jsonpath='{.data.LDAP_ADMIN_PASSWORD}'

   After executing the above command, copy the output and decode it using any online decoding site such as https://www.base64decode.org/.

Integrate with existing Argo CD Instances

1. 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 “ArgoCD Integration with ISD”.

2. 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.

Troubleshooting

1. 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.

2. 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".