Skip to content

Latest commit

 

History

History
82 lines (70 loc) · 3.48 KB

README.md

File metadata and controls

82 lines (70 loc) · 3.48 KB
Raw

Helm Chart for Harness CD Community Edition

This page contains the instructions necessary to install and manage Harness CD Community Edition using a helm-chart. The steps below use minikube for simplicity but can be used any Kubernetes cluster.

Pre-requisites

  1. Install kubectl
  2. Install Docker
  3. Install minikube
  4. Install Helm

Hardware requirements

  • 2 CPUs or more
  • 3GB of free memory
  • 20GB of free disk space
  • Internet connection

Start Harness CD

  1. Start by cloning this repo. 
    git clone https://github.com/harness/harness-cd-community.git
cd harness-cd-community/helm
  2. Start minikube with slightly higher memory and cpu so that you can also deploy a workload into the same Kubernetes cluster. 
    minikube start --memory 4g --cpus 4
  3. If you are running Docker Desktop on Windows or Mac skip this step. If you are running on Linux or wish to run a production install then please see Advanced Configuration to set the hostname of your machine.
  4. Start Harness CD using the helm-chart 
    helm install harness ./harness --create-namespace --namespace harness

Use Harness CD

  1. Follow the notes printed by Helm to access the application. You should wait for the harness-cd application to start before moving to Step 2.
 kubectl wait --namespace harness --timeout 900s --selector app=proxy --for condition=Ready pods

You can also use the following commands to check status.

kubectl get pods -n harness
kubectl get services -n harness
  1. Open the link which is displayed and complete the registration form at <URL>/signup. Now your Harness CD account along with the first (admin) user is created. If you have already completed this step, then login to Harness CD at <URL>/signin.
  2. Follow the Harness CD Community Edition quickstart

Troubleshooting

If you run into issues when installing Harness this section will help identify where the issue is.

View running processes
kubectl get pods -n harness
View logs of processes
kubectl logs -n harness -f <POD-NAME>

Support

Join the Harness Community Slack Join the Harness Community Forum

Profiles

Harness CD Community Edition supports multiple hardware profiles. The default profile is laptop for low resource environments. There is also a production profile available for use in more demanding environments.

To run the production profile use this startup command

helm install -f harness/values-production.yaml harness ./harness --create-namespace --namespace harness

Remove Harness CD

helm uninstall harness -n harness

You can even delete the harness namespace altogether.

kubectl delete namespace harness

Advanced Configuration

How to deploy the Harness to a separate environment

You simply need to set the harness_host configuration parameter. This should be the IP address or hostname of the machine where you are deploying Harness. You cannot use localhost for this parameter. Open values.yaml in your editor and update the harness_host parameter.