Install in Google Kubernetes Engine (GKE)

Learn how to install Harness Self-Managed Enterprise Edition in GCP.

This topic explains how to use Helm to install the Harness Self-Managed Enterprise Edition in Google Cloud Platform (GCP).

For Helm installation instructions, go to Helm installation or the Harness Helm chart readme.

Prerequisites

This topic assumes you have experience with GCP, such as setting up projects, namespaces, and clusters.

In addition to a Harness account, you need the following:

• Access to Helm charts

• An external static IP address

GCP

To install in GCP manually, you first reserve your static IP, then install Harness Self-Managed Enterprise Edition.

Reserve an external static IP

To reserve an external static IP in GCP, do the following:

1. Go to your GCP project.

2. Select VPC network. The VPC networks page opens.

3. In the left nav, select IP addresses. The IP addresses page opens.

4. Select Reserve External Static IP Address, then select the following.

   1. Network Service Tier: Premium.

   2. IP Version: IPv4.

   3. Type: Regional.

      Make sure the IP address is in the same region as your cluster. Make a note of or copy the IP address. You'll need it later in the installation process.

5. Select Reserve.

Install Harness Self-Managed Enterprise Edition in GCP

1. Create a new cluster or use an existing one.

2. Create a new namespace:

   1. Set your Kubernetes context to the GCP project you are using.

   2. Run the following

      kubectl create ns <namespace name>

3. Download the latest charts from the Harness Helm chart repo.

   Charts are located under Assets. The file name looks like harness-0.15.0.tgz.

4. Extract the *.tgz file.

5. Open the override-demo.yaml file in a file editor.

6. Add your external static IP address in the following fields.

   loadbalancerURL: http://xx.xx.xx.xx

   loadBalancerIP: xx.xx.xx.xx

7. Set the following fields.

   loadbalancerURL: http://xx.xx.xx.xx
     ingress:
       # --- Enable Nginx ingress controller gateway
       enabled: true
       annotations: {}
       loadBalancerIP: xx.xx.xx.xx
       className: "harness"
       loadBalancerEnabled: true
       useSelfSignedCert: false
       ingressGatewayServiceUrl: ''
       hosts:
         - ""

8. Search for "nginx:", and set create: to true.

    nginx:
      create: true

9. Search for "defaultbackend:", and set create: to true.

    defaultbackend:
      create: true

10. Save the file and exit.

11. Run the following from your terminal.

    helm install <YOUR_RELEASE_NAME> <path to Harness directory> -n <YOUR_NAMESPACE_NAME> -f override.demo.yaml

    for example:

    helm install test-release harness/ -n smp-test -f harness/override-demo.yaml

12. After the installation is complete, paste the loadbalancerURL in your browser's address bar, and then sign in to the Harness UI.

13. Complete to the post-install next steps.

GKE with gcloud CLI

To install in GKE using the gcloud CLI, you first create your test cluster, then install Harness Self-Managed Enterprise Edition.

Create a test cluster

To create your test cluster in GKE using the gcloud CLI, do the following:

1. Configure the gcloud CLI with your Google Cloud account.

   These can also be run in the Google Cloud Shell. For more information, go to Google Cloud Shell.

2. Run the following GKE cluster configuration, modifying the < > enclosed values with those from your own environment.

   gcloud beta container --project <gcp_project> clusters create "<cluster_name>" --no-enable-basic-auth --cluster-version "1.27.8-gke.1067004" --release-channel "regular" --machine-type "e2-standard-8" --image-type "COS_CONTAINERD" --disk-type "pd-balanced" --disk-size "100" --metadata disable-legacy-endpoints=true --scopes "https://www.googleapis.com/auth/devstorage.read_only","https://www.googleapis.com/auth/logging.write","https://www.googleapis.com/auth/monitoring","https://www.googleapis.com/auth/servicecontrol","https://www.googleapis.com/auth/service.management.readonly","https://www.googleapis.com/auth/trace.append" --num-nodes "7" --logging=SYSTEM,WORKLOAD --monitoring=SYSTEM --enable-ip-alias --network "projects/<gcp_project>/global/networks/default" --subnetwork "projects/<gcp_project>/regions/us-central1/subnetworks/default" --no-enable-intra-node-visibility --default-max-pods-per-node "110" --security-posture=standard --workload-vulnerability-scanning=disabled --no-enable-master-authorized-networks --addons HorizontalPodAutoscaling,HttpLoadBalancing,GcePersistentDiskCsiDriver --enable-autoupgrade --enable-autorepair --max-surge-upgrade 1 --max-unavailable-upgrade 0 --binauthz-evaluation-mode=DISABLED --enable-managed-prometheus --enable-shielded-nodes --node-locations "<zone, example: us-central1-c>" --zone <zone, example: us-central1-c>

3. Create a Static IP in the same zone as your GKE cluster.

   gcloud compute addresses create smp-test-ip --project=<gcp_project> --region=<example: us-central1>

4. Retrieve and note your IP address.

   gcloud compute addresses describe smp-test-ip --region <region>

5. Get a Kubernetes config for your new cluster.

   gcloud container clusters get-credentials smp-cluster --zone <zone, example: us-central1-c> --project <gcp_project>

Install Harness Self-Managed Enterprise Edition in GKE

1. Create a namespace for your deployment.

   kubectl create namespace harness

2. Retrieve and extract the latest Harness Helm charts. The harness charts will look like harness-<version_number>.

3. Open the harness/override-demo.yaml file in any editor, and modify the following values.

   Key	Value
   global.ingress.enabled	true
   global.loadbalancerURL	"https://<YOUR_IP_ADDRESS>"
   global.ingress.hosts	""
   global.ingress.loadBalancerIP	<YOUR_IP_ADDRESS>
   global.ingress.loadBalancerEnabled	true
   platform.bootstrap.networking.defaultbackend.create	true
   platform.bootstrap.networking.nginx.create	true
   platform.bootstrap.networking.nginx.loadBalancerEnabled	true
   platform.bootstrap.networking.nginx.loadBalancerIP	<YOUR_IP_ADDRESS>

4. Install the Helm chart.

    helm install harness harness/ -f override-demo.yaml -n harness

5. Navigate to the sign up UI at https://<YOUR_IP_ADDRESS>/auth/#/signup to create your admin user.

6. Complete to the post-install next steps.

1. Deploy the Harness modules you want to use. For more information, go to Deploy Harness modules.

2. Add your Harness license. For more information, go to Add a Harness license.

3. Configure SMTP to allow for additional user invitations. For more information, go to Add SMTP configuration.