If you navigate to this repository because you are part of a Cloud Automation Workshop then check out the following resources
Keptn now requires a Git upstream for every new project. If use any of the demo options (dynatrace, prometheus, cloudautomation) the installation script will automatically use the --with-gitea option to install a Gitea git repository and also installs the Gitea Provisioner Service.
Before you start - make sure to pick the right branch for your Keptn Version!
| Authors | Tutorial Version | Keptn Version | Comment |
|---|---|---|---|
| @thschue | release-0.6.2 | 0.6.2 | Initial Release |
| @grabnerandi | release-0.7.3 | 0.7.3 | Adding Dynatrace Use Cases |
| @grabnerandi | release-0.8.0 | 0.8.0 | Updates to Keptn 0.8 |
| @grabnerandi | release-0.9.0 | 0.9.1 | Updates to Keptn 0.9.x |
| @grabnerandi | release-0.10.0 | 0.10.0 | Updates to Keptn 0.10.x |
| @grabnerandi | release-0.11.0 | 0.11.0 | Updates to Keptn 0.11.x |
| @grabnerandi | release-0.12.0 | 0.12.0 | Updates to Keptn 0.12.x |
| @grabnerandi | release-0.13.1 | 0.13.1 | Updates to Keptn 0.13.1 |
| @grabnerandi | release-0.13.4 | 0.13.4 | Updates to Keptn 0.13.4 + adding Job Executor |
| @grabnerandi | release-0.14.1 | 0.14.1 | Updates to Keptn 0.14.1 |
| @grabnerandi | release-0.17.0 | 0.17.0 | Updates to Keptn 0.17.0 |
This repo automates the installation of Keptn's Control Plane, Delivery or Execution. For that it will automatically install a k3s. This is your fastest way to explore the following use cases:
- SLI/SLO-based Quality Gates
- Performance as a Self-Service
- Multi-Stage Delivery
- Automated Operation (aka Auto-Remediation).
Depending on which options you choose the script will install
- JMeter Service as a testing service
- Istio as Service Mesh for Blue/Green
- Argo Rollouts for Canary Deployments
- Generic Executor to execute remediation scripts
- Monaco Service to automate Dynatrace Monitoring Configuration
This tutorial was heavily driven to use cases that integrate with Dynatrace which is why Dynatrace is prominently featured as a monitoring solution. You can however also run the script using Prometheus to provide SLIs for your quality gates!
After the installation is complete you are free to install any additional Keptn Services such as Notification, Jenkins, Grafana, Jira ... service. Find those services in the Keptn-Contrib organization or Keptn-Sandbox
-
If you want to watch our Keptn on k3s webinar click here!
-
If you want to use Keptn with Dynatrace check out Keptn for Dynatrace in 5 Minutes or watch the specific tutorials
- You want to try out Keptn
- You don't want to deal with installing Kubernetes
- You have access to a Linux host
- You don't want to use this in production (currently)
- You don't plan to upgrade this installation (currently, but maybe reinstall)
- A machine which is able to execute bash scripts and that allows incoming HTTP (80) & HTTPS (443) traffic. I have tested all this on EC2 AWS Linux machines
To install you need the following tools on your machine: git, curl, tree, jq, tree, yq! Here instructions on how to download on an EC2 Linux
sudo yum update -y
sudo yum install git -y
sudo yum install curl -y
sudo yum install jq -y
sudo yum install tree -y
sudo wget https://github.com/mikefarah/yq/releases/download/3.4.1/yq_linux_amd64 -O /usr/bin/yq && sudo chmod +x /usr/bin/yq
git clone https://github.com/keptn-sandbox/keptn-on-k3s
cd keptn-on-k3s
git checkout release-0.17.0- Amazon Linux 2
ATTENTION: if you try this on an EC2, GCP, ... instance please make sure to allow inbound traffic for HTTP & HTTPS!
- Basic install (for quality gates only) works on a machine with 2 (v)CPU and 8GB of memory, e.g: t3.large
- Advanced install (with delivery & testing) needs a machine with at least 8 (v)CPU and 32GB of memory, e.g: t3.2xlarge
The script allows a couple of parameters
| Parameter Name | Values | Comment |
|---|---|---|
--type |
all (default), k3s, keptn, demo, gitus | Will either install everything (all), just k3s, just keptn (assuming that kubectl is pointing to a k8s cluster), demo (just the demo components), gitus (will create Git Upstreams for each Keptn Project) |
--controlplane |
This is default, it will just install Keptn Control Plane on this k3s allowing Quality Gates & Auto-Remediation | |
--deliveryplane |
This option will install Keptn Delivery Plane - that is Control Plane + Helm (for Deployment) + JMeter (for Testing). This will also install Istio | |
--executionplane |
This option only installs Keptn's Execution Plane + Helm (for Deployment) + JMeter (for Testing) + Istio. This also requires you to set some Env-Variables pointing to the Keptn Control Plane | |
--with-prometheus |
Will enable Prometheus Support and install Prometheus in the prometheus namespace. |
|
--with-dynatrace |
Will enable Dynatrace Support. Requires DT_API_TOKEN and DT_TENANT env variables to be set |
|
--with-jmeter |
Will make sure to install JMeter Service in case not already selected by another option, e.g: deliveryplane or execution plane | |
--with-slackbot |
Will install the Keptn slackbot. Requires SLACKBOT_TOKEN env variable to be set |
|
--use-xip |
Will use a xip.io domain, e.g: your.ip.xip.io | |
--use-nip |
Will use a nip.io domain which is sometimes more reliable than using xip.io. Will also be used when LE_STAGE=staging and no FQDN is specified | |
--provider |
aws gcp digitalocean EMPTY |
handles IP gathering based on provider or uses hostname in case its empty |
--ip |
"YOURIP" | Allows you to pass your own IP of your host, use double quotation marks |
--letsencrypt |
Will create a Letsencrypt certificate | |
--fqdn |
YOURFQDN | Allows you to pass your own hostname, allows you to create production LetsEncrypt Certificates, You need to create your own DNS entry |
--with-demo |
dynatrace prometheus cloudautomation | Will install demo projects for Dynatrace, Prometheus or Cloud Automation |
--with-gitea |
Will install Gitea and upstream Git repos for every Keptn project | |
--disable-bridge-auth |
Will disable the password check when accessing Keptn Bridge (not recommended for anything else than demo purposes) |
keptn-on-k3s comes with cert-manager. By default, a self-signed certificate is generated. By adding --letsencrypt as a parameter, and a CERT_EMAIL is exported, you will create a LetsEncrypt-Staging certificate. By additionally exporting LE_STAGE=production, a LetsEncypt Production certificate will be issued (will not work with xip.io and nip.io).
For all details please check out Keptn for Dynatrace in 5 Minutes
Here are three common installation scenarios:
The installation scripts for Dynatrace needs a couple of env-variables:
$ export DT_TENANT=abc12345.live.dynatrace.com # Host name of your Dynatrace Tenant
$ export DT_API_TOKEN=YOURTOKEN # Dynatrace API token to let Keptn pull SLIs from Dynatrace
$ export DT_OPERATOR_TOKEN=YOURK8STOKEN # BASE64-Encoded Dynatrace k8s Operator token as script uses to install OneAgent Operator (follow k8s install screen in dynatrace to get those tokens)
$ export DT_INGEST_TOKEN=YOURINGESTTOKEN # BASE64-Encoded Dynatrace k8s ingest token as script will use to configure k8s ingest
$ export OWNER_EMAIL=yourdynatraceuser@yourmail.com # Your username in Dynatrace
$ export LE_STAGE=staging # This is needed for certificate creationATTENTION DT_OPERATOR_TOKEN and DT_INGEST_TOKEN need to be the BASE64-Encoded version of the tokens. If you follow the Install Wizard for the OneAgent Operator you can download the dynakube.yaml and copy/paste the BASE64-encoded version from that file. Otherwise you need to encode it yourself!
When you have an EC2 machine you can run the following script which will install Keptn using the EC2 machines public IP to expose the keptn services via e.g: http://keptn.YOUR.IP.nip.io
./install-keptn-on-k3s.sh --deliveryplane --provider aws --with-dynatrace --with-demo dynatrace --letsencrypt --with-giteaIf you create your own DNS Entry for your IP, e.g: Using Route53 to map to your public IP of your EC2 instance then you can run this
./install-keptn-on-k3s.sh --deliveryplane --provider aws --with-dynatrace --with-demo dynatrace --letsencrypt --with-gitea --fqdn yourkeptndomain.abcIf you just want quality gates then do this
./install-keptn-on-k3s.sh --controlplane --provider aws --with-dynatrace --with-demo dynatrace --letsencrypt --with-giteaHere are a couple of installation examples
This option will auto-detect your IP address by using hostname -I
# For the brave, with Prometheus-Service and SLI Provider
./install-keptn-on-k3s.sh --with-prometheusThis option passes the --provider gcp* option. In this case the script queries the external IP address of your GCP instance.
./install-keptn-on-k3s.sh --provider gcpThis option allows you to specify which IP address to be used to expose Keptn services (API, Bridge ...) on this machine!
./install-keptn-on-k3s.sh --ip <IP>k3s-uninstall.shAlso make sure to remove any other potentially created files as part of the demo installations!