This document explains how to use Helm to install, upgrade or uninstall Harness Self-Managed Enterprise Edition. This document describes an installation on Google Kubernetes Engine (GKE). The same installation process, however, applies to installations on Kubernetes versions 1.x and later.
Helm package manager provides a declarative approach to Kubernetes application management in which software packages are specified as “charts.” For more information, see the Helm documentation.
Download Harness Helm chart
To download Harness Helm chart for the installation of Self-Managed Enterprise Edition, see https://github.com/harness/helm-charts.
Harness Helm chart is available for demonstration and production environments.
Update the override.yaml file
Depending on your target environment, you'll need to update the override.yaml file to specify a load balancer or to specify the Harness modules to be deployed.
Add a load balancer
Use the following procedure to add a load balancer.
To add the URL for a load balancer
In the values.yaml file, set the
global.loadbalancerURLfield to the URL of your load balancer. This is the URL you use for Harness.
# -- Harness Application URL
host_namefield to the IP address of the load balancer.
Save the file.
Deploy Harness modules
Harness Helm chart includes Harness Platform components. You can add modules by editing the override.yaml file.
The following components are enabled by default:
- Harness CD - Next Generation
- Harness CI
- Harness Security Testing Orchestration (STO)
You can conditionally disable or enable the CI and STO modules by specifying a boolean value in the
enabled field of the YAML:
# -- Enable to deploy CI to your cluster
# -- Enable to deploy STO to your cluster
Install the Helm chart
To use the charts, you must install Helm. To get started with Helm, see the Helm documentation. After you install Helm, follow the instructions below.
To install the Helm chart
Add the repository.
$ helm repo add harness https://harness.github.io/helm-charts
Create a namespace for your installation.
$ kubectl create namespace <namespace>
Modify the override.yaml file with your environment settings.
Install the Helm chart.
$ helm install my-release harness/harness-prod -n <namespace> -f override.yaml
After the installation completes, the services that were installed are enumerated with their status.
The services that appear depend on the modules that were installed.
To verify installation
Review the list of services.
In your browser, type the following instruction:
If the installation was successful, the Harness Sign up page appears.
Upgrade the Helm chart
Use the following instructions to upgrade the chart to a new release.
To upgrade the chart
Use the following command to obtain the release name for the earlier release.
$ helm ls -n <namespace>
Retrieve the values for the earlier release.
$ helm get values my-release > old_values.yaml
Change the values of the old_values.yaml file as required.
helm upgradecommand to update the chart.
$ helm upgrade my-release harness/harness-demo -n <namespace> -f old_values.yaml
Uninstall the Helm chart
To remove the Kubernetes components associated with the chart and delete the release, uninstall the chart.
To uninstall the chart
Uninstall and delete the
$ helm uninstall my-release -n <namespace>