In this tutorial we are going to learn how to install Keptn in your Kubernetes cluster running in Google Kubernetes Engine in the Google Cloud.

Please download and install the following tools if you do not have them installed on your machine already.

We are going to setup a Kubernetes cluster in the Google Cloud Platform.

  1. Install local tools
  2. Create GKE cluster
    • Master version >= 1.15.x (tested version: 1.15.9-gke.22)
    • One n1-standard-8 node
    • Image type ubuntu or cos (Note: If you plan to use Dynatrace monitoring, select ubuntu for a more convenient setup.)
    • Sample script to create such cluster:
      // set environment variables
      PROJECT=nameofgcloudproject
      CLUSTER_NAME=nameofcluster
      ZONE=us-central1-a
      REGION=us-central1
      GKE_VERSION="1.15"
      
      gcloud container clusters create $CLUSTER_NAME --project $PROJECT --zone $ZONE --no-enable-basic-auth --cluster-version $GKE_VERSION --machine-type "n1-standard-8" --image-type "UBUNTU" --disk-type "pd-standard" --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 "1" --enable-stackdriver-kubernetes --no-enable-ip-alias --network "projects/$PROJECT/global/networks/default" --subnetwork "projects/$PROJECT/regions/$REGION/subnetworks/default" --addons HorizontalPodAutoscaling,HttpLoadBalancing --no-enable-autoupgrade
      

Find a full compatibility matrix for supported Kubernetes versions here.

Every release of Keptn provides binaries for the Keptn CLI. These binaries are available for Linux, macOS, and Windows.

There are multiple options how to get the Keptn CLI on your machine.

Now, you should be able to run the Keptn CLI:

To install the latest release of Keptn in your GKE cluster, execute the keptn install command with the platform flag specifying the target platform you would like to install Keptn on.

keptn install --platform=gke

Installation details

In the Kubernetes cluster, this command creates the keptn, keptn-datastore, and istio-system namespace. While istio-system contains all Istio related resources, keptn and keptn-datastore contain the complete infrastructure to run Keptn.

Now that you have installed Keptn you can take a look at its user interace aka the Keptn's Bridge.

Expose the bridge via the following command to be able to access on localhost:

kubectl port-forward svc/bridge -n keptn 9000:8080

Open a browser and navigate to http://localhost:9000 to take look. The bridge will be empty at this point but when using Keptn it will be populated with events.

empty bridge

Now that you have successfully installed Keptn, you can explore other tutorials!

Here are some possibilities: