Prerequisites

Before proceeding, ensure you have the following prerequisites in place:

1. Create two K8s node groups (for application & analysis workloads) and label the nodes in the node groups (eg: workload: deepsource-application & workload: deepsource-analysis)
2. Create two namespaces
   1. deepsource - kubectl create ns deepsource
   2. atlas-jobs - kubectl create ns atlas-jobs
3. Create an external database using the following guide: https://docs.deepsource.com/docs/enterprise-server-configuration#bring-your-own-database
4. Obtain the registry username and password by reaching out to [email protected]
5. Make sure to use at least helm v3.8.0, prior versions require HELM_EXPERIMENTAL_OCI=1environment variable to be set.

Installation

Login to the registry using the obtained credentials

helm registry login registry.replicated.com --username <username> —password <password>

Pull the helm chart

helm pull oci://registry.replicated.com/deepsource-fowl/experimental/deepsource

Extract the helm chart and edit the values.yaml

tar -xvzf deepsource-*.tar.gz
cd deepsource
vim values.yaml

Install DeepSource Enterprise Server

helm install deepsource —n deepsource .

Upgrade

To upgrade DeepSource Enterprise Server you can use thehelm upgrade command

helm upgrade deepsource -f <path-to-values.yaml> -n deepsource oci://registry.replicated.com/deepsource-fowl/experimental/deepsource

Notes

1. For using Bitbucket with DeepSource edit the asgard.licenseFields.customerName in values.yaml OR set the value using --set asgard.licenseFields.customerName=<customer-name>
2. To generate random passwords and keys for fields with the value xxxxx, you can use Python (python3 -c "import secrets; print(secrets.token_hex(20))") or shell ( date | md5)

Contact [email protected] if you face any issues during the installing or upgrading process.