Skip to content

Commit

Permalink
Merge pull request #97 from saitejaopsmx/v4.1.2
Browse files Browse the repository at this point in the history
Improvemts in the document and cleaned values files
  • Loading branch information
saitejaopsmx authored Feb 10, 2023
2 parents 0b9e1ef + 91836f6 commit 803c942
Show file tree
Hide file tree
Showing 8 changed files with 76 additions and 34 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/release.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: Release Charts
on:
push:
branches:
- main
- v4.1.2
paths:
- 'charts/isdargo/Chart.yaml'
- 'charts/isdargo/Chart.lock'
Expand Down
28 changes: 27 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,30 @@ For more information, visit https://www.opsmx.com

- Kubernetes cluster 1.20 or later with at least 4 cores and 16 GB memory
- Helm 3 is setup on the client system with 3.10.3 or later
- Ensure that this URLs(ISD,KeyCloak,Argo CD,Argo Rollouts,Vela) is reachable from your browser. Either DNS name server record must exist or "hosts" file must be updated.
- Please use below steps:

The IP address is the “ingress-nginx-controller” service external IP map them to the hostnames you defined for URLs

```console
Ip-address ISD.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address KEYCLOAK.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address ARGO.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address ROLLOUTS.REPLACE.THIS.WITH.YOURCOMPANY.COM
```
`E.g.: isd.isd-argo.opsmx.com`

- Vela Service requires the “Wild-card ingress” and “Wild-card TLS certificates to be provided to the ingress”

Please use below blog to create a Wild-card TLS certificates to provide for the Ingress

https://www.linkedin.com/pulse/wildcard-certificates-using-lets-encrypt-certbot-pallavi-udhane/


Use below command to check if helm is installed or not
```console
helm version
```
Expand Down Expand Up @@ -55,7 +79,9 @@ For more information, visit https://www.opsmx.com
isd-rollouts-values.yaml | This file is used for Installing ISD and Argo Rollouts without Argo CD
onlyargorollouts-values.yaml | This file is used for Installing only Argo Rollouts without Argo CD and ISD
argocd-rollouts-values.yaml | This file is used for Installing Argo CD and Argo Rollouts without ISD


**NOTE**: In all the values.yaml please read inline comments and update it accordingly.

- Use below command to install the helm chart:

```console
Expand Down
2 changes: 1 addition & 1 deletion charts/isdargo/Chart.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
apiVersion: v2
name: isdargo
version: 4.1.2
version: 4.1.3
appVersion: 4.1.2
description: "ISD-Argo with v2.5.4 with KeyCloak,RBAC features and Improvements of Kubernetes Job for Delivery Verification"
icon: https://raw.githubusercontent.com/OpsMx/enterprise-argo/main/img/opsmx.png
Expand Down
65 changes: 45 additions & 20 deletions charts/isdargo/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,21 +6,38 @@

For more information, visit https://www.opsmx.com

## TL;DR;
Install OpsMx Enterprise for Argo
```console
$ helm repo add isdargo https://opsmx.github.io/enterprise-argo/
$ helm install <release-name> isdargo/isdargo --timeout 6m
```

## Setup Instructions

### Prerequisites

- Kubernetes cluster 1.19 or later with at least 4 cores and 16 GB memory
- Helm 3 is setup on the client system
- Kubernetes cluster 1.20 or later with at least 4 cores and 16 GB memory
- Helm 3 is setup on the client system with 3.10.3 or later
- Ensure that this URLs(ISD,KeyCloak,Argo CD,Argo Rollouts,Vela) is reachable from your browser. Either DNS name server record must exist or "hosts" file must be updated.
- Please use below steps:

The IP address is the “ingress-nginx-controller” service external IP map them to the hostnames you defined for URLs

```console
Ip-address ISD.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address KEYCLOAK.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address ARGO.REPLACE.THIS.WITH.YOURCOMPANY.COM

Ip-address ROLLOUTS.REPLACE.THIS.WITH.YOURCOMPANY.COM
```
`E.g.: isd.isd-argo.opsmx.com`

- Vela Service requires the “Wild-card ingress” and “Wild-card TLS certificates to be provided to the ingress”

Please use below blog to create a Wild-card TLS certificates to provide for the Ingress

https://www.linkedin.com/pulse/wildcard-certificates-using-lets-encrypt-certbot-pallavi-udhane/


Use below command to check if helm is installed or not
```console
$ helm version
helm version
```
If helm is not setup, follow <https://helm.sh/docs/intro/install/> to install helm.

Expand All @@ -29,13 +46,13 @@ Install OpsMx Enterprise for Argo
- Add opsmx helm repo to your local machine

```console
$ helm repo add isdargo https://opsmx.github.io/enterprise-argo/
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

```console
$ helm repo update
helm repo update
```

- Your Kubernetes cluster shall support persistent volumes
Expand All @@ -51,14 +68,24 @@ Install OpsMx Enterprise for Argo
- Helm v3 expects the namespace to be present before helm install command is run. If it does not exists,

```console
$ kubectl create namespace mynamespace
kubectl create namespace opsmx-argo
```
- There are different flavours for Installing ISD-ARGO

- To install the chart with the release name `my-release`:
Values yamls | Description
--------------| -----------
isd-argo-minimal-values.yaml | This file is used for Installing ISD,Argo CD and Argo Rollouts
isd-minimal-values.yaml | This file is used for Installing ISD without Argo CD and Argo Rollouts
isd-rollouts-values.yaml | This file is used for Installing ISD and Argo Rollouts without Argo CD
onlyargorollouts-values.yaml | This file is used for Installing only Argo Rollouts without Argo CD and ISD
argocd-rollouts-values.yaml | This file is used for Installing Argo CD and Argo Rollouts without ISD

**NOTE**: In all the values.yaml please read inline comments and update it accordingly.

- Use below command to install the helm chart:

Helm v3.x
```console
$ helm install my-release isdargo/isdargo [--namespace mynamespace] --timeout 6m
helm install isdargo isdargo/isdargo -f isd-argo-minimal-values.yaml -n opsmx-argo --timeout 15m
```

The command deploys ISD-ARGO on the Kubernetes cluster in the default configuration. The [configuration](#configuration) section lists the parameters that can be configured during installation.
Expand All @@ -67,10 +94,8 @@ The command deploys ISD-ARGO on the Kubernetes cluster in the default configurat
### Uninstalling the Chart

To uninstall/delete the `my-release` deployment:
To uninstall/delete the deployment:

Helm v3.x
```console
$ helm uninstall my-release [--namespace mynamespace]
helm uninstall isdargo -n opsmx-argo
```

3 changes: 0 additions & 3 deletions charts/isdargo/isd-argo-minimal-values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,6 @@ global:
# Update the below entry for establishing communication for ISD and Argo CD
host: VELA.REPLACE.THIS.WITH.YOURCOMPANY.COM

# Set it to false if own LDAP is to be configured
installOpenLdap: true

###################################################
# argo-cd configuration
#######################
Expand Down
3 changes: 0 additions & 3 deletions charts/isdargo/isd-minimal-values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,6 @@ global:
# Please below string for all occurences in this file with proper dns entry to access the ISD UI eg: keycloak.example.ops.com$
host: VELA.REPLACE.THIS.WITH.YOURCOMPANY.COM

# Set it to false if own LDAP is to be configured
installOpenLdap: true

#######################################################################################################################
# Values of OES Database
db:
Expand Down
4 changes: 0 additions & 4 deletions charts/isdargo/isd-rollouts-values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,6 @@ global:
#specify the argorollouts url like argorollouts.ninja-test.opsmx.net
host: "ROLLOUTS.REPLACE.THIS.WITH.YOURCOMPANY.COM"

###############################################################################
# Set it to false if own LDAP is to be configured
installOpenLdap: true

#################################################################################
argo-rollouts:
# Default set to true . Set to false if crds already exists in the cluster instead of deleting the CRDs
Expand Down
3 changes: 2 additions & 1 deletion charts/isdargo/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -289,6 +289,7 @@ global:
argo-cd:
crds:
install: true

configs:
cm:
# Argo CD's externally facing base URL. Required when configuring SSO
Expand Down Expand Up @@ -1663,7 +1664,7 @@ sapor:
## Image specific details
image:
repository: ubi8-oes-sapor
tag: v4.1.2
tag: v4.1.2.1
pullPolicy: IfNotPresent

annotations:
Expand Down

0 comments on commit 803c942

Please sign in to comment.