Quick Start

Learn how to get Keptn running in five minutes. We'll run Keptn on a local k3d cluster.

Prerequisites

Docker
kubectl
helm when running the demos in step 5

Install Keptn

Create local k3d cluster. Therefore, you need to install k3d if not already present on your machine. You can skip this if k3d is already available on your machine.
```
curl -s https://raw.githubusercontent.com/rancher/k3d/main/install.sh | TAG=v4.4.4 bash
```
Now, let’s start a cluster for Keptn!
```
k3d cluster create mykeptn -p "8082:80@agent[0]" --k3s-server-arg '--no-deploy=traefik' --agents 1
```
Download and install the Keptn CLI
```
curl -sL https://get.keptn.sh | bash
```

Install Keptn control-plane and execution-plane for continuous delivery use case

keptn install --use-case=continuous-delivery

Keptn comes with different installation options, please have a look at the installation documentation for more details on cluster requirements, resource consumption, supported Kubernetes versions, and more.

Installation logs

The installation logs will print the following output:

Installing Keptn …
Helm Chart used for Keptn installation: https://storage.googleapis.com/keptn-installer/keptn-0.8.3.tgz
Start upgrading Helm Chart keptn in namespace keptn
Finished upgrading Helm Chart keptn in namespace keptn
Keptn control plane has been successfully set up on your cluster.
Installing execution plane services for continuous-delivery use case.
Start upgrading Helm Chart helm-service in namespace keptn
Finished upgrading Helm Chart helm-service in namespace keptn
Start upgrading Helm Chart jmeter-service in namespace keptn
Finished upgrading Helm Chart jmeter-service in namespace keptn
 —————————————————
 * To quickly access Keptn, you can use a port-forward and then authenticate your Keptn CLI:
 - kubectl -n keptn port-forward service/api-gateway-nginx 8080:80
 - keptn auth –endpoint=http://localhost:8080/api –api-token=$(kubectl get secret keptn-api-token -n keptn -ojsonpath={.data.keptn-api-token} | base64 –decode)
 * Alternatively, follow the instructions provided at: https://keptn.sh/docs/0.8.x/operate/install/#authenticate-keptn-cli
 * To expose Keptn on a public endpoint, please continue with the installation guidelines provided at:
 - https://keptn.sh/docs/0.8.x/operate/install#install-keptn

There is no need to follow the instructions from the installation log - the quickstart guide will cover this!

Install and configure Istio for Ingress + continuous delivery use-case

curl -SL https://raw.githubusercontent.com/keptn/keptn.github.io/master/content/docs/quickstart/exposeKeptnConfigureIstio.sh | bash

(Optional but recommended) Create a demo project with multi-stage pipeline + SLO-based quality gates

curl -SL https://raw.githubusercontent.com/keptn/keptn.github.io/master/content/docs/quickstart/get-demo.sh | bash

Explore Keptn! Please have a look at our tutorials and documentation to learn how you can use Keptn.
If you are finished exploring Keptn, you can always stop and start the cluster and delete it eventually.
```
k3d cluster stop mykeptn
k3d cluster start mykeptn
```
Or delete it if you don’t need it anymore
```
k3d cluster delete mykeptn
```

Explore tutorials to learn more about the Keptn use cases

With Keptn installed, have a look at the different tutorials to learn hands-on about the Keptn use cases:

A full tour through Keptn: Continuous Delivery & Automated Operations Learn how to setup Keptn for a sample cloud native app where Keptn deploys, tests, validates, promotes and auto-remediates
Continuous Delivery with Deployment Validation Keptn deploys, tests, validates and promotes your artifacts across a multi-stage delivery process		Automated Operations Keptn automates problem remediation in production through self-healing and runbook automation
Performance as a Self-Service Keptn deploys, tests and provides automated performance feedback of your artifacts	Performance Testing as a Self-Service Let Keptn execute performance tests against your deployed software and provide automatic SLI/SLO based feedback		Deployment Validation (aka Quality Gates) Integrate Keptn into your existing CI/CD by automatically validating your monitored environment based on SLIs/SLOs

Learn how Keptn works and how it can be adapted to your use cases

Review the documentation for a full reference on all Keptn capabilities and components and how they can be combined/extended to your needs:

Do you need help?

Join our slack channel for any questions that may arise.