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	Minikube	MicroK8s (experimental)	Minishift (experimental)
0.6.x / Control & Execution Plane	1.15.x - 1.13.x	1.15.x (1)	1.15 - 1.14	1.15.x - 1.14.x	3.11	-	-	1.34.2 (K8s: 1.11.x)
0.6.x / Control Plane	1.16.x - 1.13.x	1.16.x - 1.15.x	1.15 - 1.14 (2)	1.15.x - 1.14.x (2)	3.11	1.2 (K8s:1.15.x)	1.18.x	1.34.2 (K8s: 1.11.x)

Remarks:

(1): AKS with K8s version before 1.15 might fail #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

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.