Kubernetes Support

This document describes the maximum version skew supported between Keptn and Kubernetes.

Supported Versions

Keptn versions are expressed as x.y.z, where x is the major version, y is the minor version, and z is the patch version, following Semantic Versioning terminology. Please refer to the table below to determine what Keptn version is compatible with your cluster.

Keptn Installations:

Control Plane: Keptn components to run a Keptn and to manage projects, stages, and services, to handle events, and to provide integration points. Install option: keptn install --use-case=quality-gates
Control & Execution Plane: Keptn control plane including all Keptn-services for continuous delivery and automated operations. Install option: keptn install

Keptn Version / Installation	Kubernetes	AKS	EKS	GKE	OpenShift	K3s	Minikube	MicroK8s	Minishift
0.7.x / Control & Execution Plane	1.18 - 1.14	1.16 - 1.15 see: (1)	1.16 - 1.14	1.16 - 1.14	3.11	-	-	-	1.34.2 (K8s: 1.11)
0.7.x / Control Plane	1.18 - 1.14	1.16 - 1.15 see: (1)	1.16 - 1.14	1.16 - 1.14	3.11	1.18 - 1.16	1.10.1 (K8s:1.18.2) - 1.3.1 (K8s:1.15)	1.18 - 1.16	1.34.2 (K8s: 1.11)
0.6.x / Control & Execution Plane	1.15 - 1.13	1.15 see: (1)	1.15 - 1.14 see: (2)	1.15 - 1.14 see: (2)	3.11	-	-	-	1.34.2 (K8s: 1.11)
0.6.x / Control Plane	1.16 - 1.13	1.16 - 1.15 see: (1)	1.15 - 1.14 see: (2)	1.15 - 1.14 see: (2)	3.11	-	1.2 (K8s:1.15)	1.18	1.34.2 (K8s: 1.11)

Remarks

(1): AKS with K8s version before 1.15 might fail (see: #1429), due to a known AKS issue: #69262
(2): EKS and GKE do not provide K8s 1.16 clusters (checked on: 9th April, 2020)

Notes:

It is not recommended to use Keptn with a version of Kubernetes that is newer than the version it was tested against, as Keptn does not make any forward-compatibility guarantees.
If you choose to use Keptn with a version of Kubernetes that it does not support, you are using it at your own risk.

Abbreviations:

AKS … Azure Kubernetes Service
EKS … Amazon Elastic Kubernetes Service
GKE … Google Kubernetes Engine
K3s … A certified Kubernetes distribution built for IoT & Edge computing: k3s.io

Test Strategy for Kubernetes support

With a new Keptn release, Keptn is tested based on the default K8s version of each Cloud Provider: AKS, EKS and GKE available at the release date.
Internally, a test pipeline with newer Kubernetes versions is verifying the master branch of Keptn. Known-limitations identified by these tests are referenced at the corresponding Keptn release.