ISD-Argo Rollouts Installation

Introduction

This document provides step-by-step instructions for Installing ISD-Argo Rollouts on a Kubernetes cluster.

The installation involves the following components:

• ISD-UI and associated components (Audit, Platform, Autopilot) and OpenLDAP for authentication of ISD.

• Argo Rollouts

• Additional supporting/common components (DB, Redis)

Note: ISD-Argo Rollouts Installation v4.1.1 supports the following Argo Components:

• Argo Rollouts - v1.2.0

Environment requirements:

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

• For production grade installation, please refer to the Infrastructure requirements here.

ISD-Argo Rollouts Installation Steps:

Follow the instructions below for installation of ISD-Argo Rollouts:

1. Create a namespace in your cluster.

   kubectl create ns <namespace name>

2. Clone the enterprise Argo repo and change the directory to enterprise-argo by using below commands.

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

   Note: The isd-argo-minimal-values.yaml provided in the repo is adequate and recommended for ISD 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 contact OpsMx support.

3. Run the below commands in your terminal.

   sed -i "s/installArgoCD: true/installArgoCD: false/g" isd-argo-minimal-values.yaml
   sed -i "s/installdemoapps: true/installdemoapps: false/g" isd-argo-minimal-values.yaml
   sed -i "s/autoconfigureagent: true/autoconfigureagent: false/g" isd-argo-minimal-values.yaml

4. Configure URLs for ISD, and Argo Rollouts as per your DNS record.

5. Modify the below commands by replacing the URLs that you have configured and run those commands from your terminal.

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

6. Run the below command to install the application.

   helm install <release name> . -n <namespace name> -f isd-argo-minimal-values.yaml

   Update the following information in the above command: Release name: You can give any name as release name (better to give namespace name as release name).

   Namespace name: Give the namespace name which you have created before.

7. After successful installation, you can see the pods in your namespace. Use the below command to check the pods in your namespace.

   kubectl get pods -n <namespace name>

8. Once all the pods are up and running, you can access the applications with URLs you have configured before. Use the below command to get those URLs.

   kubectl get ing -n <namespace name>

9. Access the ISD URL through browser & login into application using the credentials listed below:

   • User Name: admin

   • Password: Execute the following command to retrieve the password

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

10. Now you can create any Rollouts and enable verification for them and they will appear in ISD dashboard. Refer to the image below.

    

Note: If you are facing any Issues during installation, refer to the Troubleshooting page.