​​​​

Devtron Installation

Prerequisites

You will need to be ready with following prerequisites before Devtron installation

• A Kubernetes cluster (preferably K8s 1.16 or above) created on AWS (EKS or KOPS) or on AZURE (AKS or KOPS). Check Creating a Production grade EKS cluster using EKSCTL​

• An Nginx ingress controller pre-configured within the cluster either exposed as LoadBalancer or NodePort.

• 2 S3 buckets/ AZURE Blob storage containers for ci-caching and ci-logs and their access permissions added to the cluster role. You will need to put these in configs here​

Introduction

This installer bootstraps deployment of all required components for installation of Devtron Platform on a Kubernetes cluster using the Helm package manager or kubectl cli.

It packages third party components like:

• ​Grafana for displaying application metrics

• ​Argocd for gitops

• ​Argo workflows for CI

• ​Clair & Guard for image scanning

• ​Kubernetes External Secrets for integrating with external secret management stores like AWS Secrets Manager or HashiCorp Vault​

• ​Nats for event streaming

• ​Postgres as datastore

• Fork of Argo Rollout​

How to use it

Install with Helm

Helm 3

git clone https://github.com/devtron-labs/devtron-installation-script.git
cd devtron-installation-script/charts

Copy and edit the devtron/values.yaml to configure your Devtron installation.

cp devtron/values.yaml devtron/install-values.yaml
vim devtron/install-values.yaml

For more details about configuration see the helm chart configuration Once your configurations are ready, continue with following steps

#Create devtroncd namespace
kubectl create ns devtroncd
helm install devtron devtron/ --namespace devtroncd -f devtron/install-values.yaml

Helm 2

git clone https://github.com/devtron-labs/devtron-installation-script.git
cd devtron-installation-script/charts
#Create CRDs manually when using Helm2
kubectl apply -f https://raw.githubusercontent.com/devtron-labs/devtron-installation-script/main/charts/devtron/crds/crd-devtron.yaml

Copy and edit the devtron/values.yaml to configure your Devtron installation.

cp devtron/values.yaml devtron/install-values.yaml
vim devtron/install-values.yaml

For more details about configuration see the helm chart configuration Once your configurations are ready, continue with following steps

#Create devtroncd namespace
kubectl create ns devtroncd
helm install devtron/ --name devtron --namespace devtroncd -f devtron/install-values.yaml

Install with kubectl

If you don't want to install helm and just want to use kubectl to install devtron platform, then please follow the steps mentioned below:

git clone https://github.com/devtron-labs/devtron-installation-script.git
cd devtron-installation-script/
#Use a preferred editor to edit the values in install/devtron-operator-configs.yaml
vim install/devtron-operator-configs.yaml

Edit the install/devtron-operator-configs.yaml to configure your Devtron installation. For more details about it, see configuration Once your configurations are ready, continue with following steps

kubectl create ns devtroncd
kubectl -n devtroncd apply -f charts/devtron/crds
# wait for crd to install
kubectl apply -n devtroncd -f charts/devtron/templates/install.yaml
#edit install/devtron-operator-configs.yaml and input the
kubectl apply -n devtroncd -f install/devtron-operator-configs.yaml
kubectl apply -n devtroncd -f charts/devtron/templates/devtron-installer.yaml

Installation status

Run following command

kubectl -n devtroncd get installers installer-devtron -o jsonpath='{.status.sync.status}'

Once installation process is complete, above command will print Applied It may take around 30 minutes for installation to complete.

Access devtron dashboard

Dashboard URL

Devtron dashboard in now available at the BASE_URL/dashboard, where BASE_URL is same as provided in values.yaml in case of installation via helm chart OR provided in install/devtron-operator-configs.yaml in case of installation via kubectl.

Run following command to get dashboard

scheme=`kubectl -n devtroncd get cm devtron-operator-cm -o jsonpath='{.data.BASE_URL_SCHEME}'` && url=`kubectl -n devtroncd get cm devtron-operator-cm -o jsonpath='{.data.BASE_URL}'` && echo "$scheme://$url/dashboard"

Please Note: URL should be pointing to the cluster on which you have installed the platform. For example if you have directed domain devtron.example.com to the cluster and ingress controller is listening on port 32080 then url will be devtron.example.com:32080

Login credentials

For login use username:admin and for password run command mentioned below.

kubectl -n devtroncd get secret devtron-secret -o jsonpath='{.data.ACD_PASSWORD}' | base64 -d

Access grafana

Grafana URL

grafana is available at BASE_URL/grafana

Login credentials

To log into grafana use username: admin and for password run command mentioned below.

kubectl -n devtroncd get secret devtron-grafana-cred-secret -o jsonpath='{.data.admin-password}' | base64 -d

Configuration

Configure Secrets

For helm installation this section referes to secrets.env section of values.yaml. For kubectl based installation it refers to kind: secret in install/devtron-operator-configs.yaml.

Following properties should be configured

Configure ConfigMaps

For helm installation this section referes to configs section of values.yaml. For kubectl based installation it refers to kind: ConfigMap in install/devtron-operator-configs.yaml.

Following properties should be configured

Storage for Logs and Cache

AWS SPECIFIC

AZURE SPECIFIC

To convert string to base64 use

echo -n "string" | base64 -d

Please Note: 1) Ensure that the cluster has read and write access to the S3 buckets/Azure Blob storage container mentioned in DEFAULT_CACHE_BUCKET, DEFAULT_BUILD_LOGS_BUCKET or AZURE_BLOB_CONTAINER_CI_LOG, AZURE_BLOB_CONTAINER_CI_CACHE 2) Ensure that cluster has read access to AWS secrets backends (SSM & secrets manager)

Cleanup

Run following commands to delete all the components installed by devtron

cd devtron-installation-script/
kubectl delete -n devtroncd -f yamls/
kubectl delete -n devtroncd -f charts/devtron/templates/devtron-installer.yaml
kubectl delete -n devtroncd -f charts/devtron/templates/install.yaml
kubectl delete -n devtroncd -f charts/devtron/crds
kubectl delete ns devtroncd

Cleaning Installer Helm3

cd devtron-installation-script/
helm delete devtron --namespace devtroncd

Cleaning Installer Helm2

cd devtron-installation-script/
helm delete devtron --purge
#Deleting CRDs manually
kubectl delete -f https://raw.githubusercontent.com/devtron-labs/devtron-installation-script/main/charts/devtron/crds/crd-devtron.yaml

Trouble shooting steps

1. How do I know when installation is complete?

Run following command

kubectl -n devtroncd get installers installer-devtron -o jsonpath='{.status.sync.status}'

Once installation process is complete, above command will print Applied It may take around 30 mins for installation to complete

2. How do I track progress of installation?

Run following command to check logs of the pod

pod=$(kubectl -n devtroncd get po -l app=inception -o jsonpath='{.items[0].metadata.name}')&& kubectl -n devtroncd logs -f $pod

3. devtron installer logs have error and I want to restart installation.

Run following command to clean up components installed by devtron installer

cd devtron-installation-script/
kubectl delete -n devtroncd -f yamls/
kubectl -n devtroncd patch installer installer-devtron --type json -p '[{"op": "remove", "path": "/status"}]'

In case you are still facing issues please feel free to reach out to us on discord​