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
see: (3)
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.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)
  • (3): Requires sufficient CPU (>= 4 vCPUs) and memory (>= 12 GB, more depending on your workloads) for the cluster.

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.