Keptn v1 reached EOL December 22, 2023. For more information see https://bit.ly/keptn

Installation

How to install and configure your Keptn environment. Scroll down for a reference list of tasks.

Create or bring a Kubernetes cluster

Install Keptn on your Kubernetes cluster and expose it

Kubernetes support & Cluster size

Keptn and Kubernetes compatibility overview and required cluster size.

Choose access options

Choose the method to use to access Keptn

Install Keptn CLI

Install binaries for the Keptn CLI

Install Keptn using the Helm chart

Install Keptn on a single cluster using the Helm chart

Multi-cluster setup

Install Keptn control-plane and execution-plane on separate clusters

Authenticate Keptn CLI and Bridge

Authenticate the Keptn CLI and Bridge to your Keptn cluster

Install Job Executor

Install the Job Executor Service to run Keptn customizable tasks as Kubernetes jobs

Install and configure Istio

Configure Istio and create a ConfigMap to expose services deployed by Keptn.

Monitoring

Install service to attach observability platform as data source for quality gates

Configure Webhook Service

Configuration for Webhook Service.

Troubleshooting the installation

Tips for troubleshooting installation problems.

Upgrade Keptn

Upgrade your Keptn

Uninstall Keptn

Uninstall Keptn from a Kubernetes cluster.

The steps to install and configure your Keptn instance are:

  1. Keptn can run on existing Kubernetes clusters or you can create a Kubernetes cluster just for Keptn.

  2. Decide how you want to access Keptn. Kubernetes supports exposing Keptn via a LoadBalancer, a NodePort, an Ingress or using Port-forwarding. You need this information when you install Keptn.

  3. Install Keptn CLI on the cloud shell machine that is used to access your cloud provider, Kubernetes cluster, etc (recommended).

  4. Install the Helm CLI.

  5. Install Keptn using a Helm chart:

    • Helm chart gives instructions for installing all of Keptn on one Kubernetes cluster.
    • Multi-cluster setup gives instructions for installing Keptn so that the Keptn Control Plane is installed in one Kubernetes cluster and the Keptn Execution Plane is installed in one or more other Kubernetes clusters.
  6. Authenticate CLI and Bridge

  7. Install software to run Keptn tasks

  8. If your project does Deployment with Helm, install Istio.

  9. If you are using Quality Gates, install the monitoring service you want to use.

  10. Configure webhooks (optional)

  11. If you have problems with your installation, check out the hints in Troubleshooting the installation

You may also be interested in the following topics: