This documentation is under develop and not officially released.

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

  • Control & Execution Plane: Keptn control plane including all Keptn-services for continuous delivery and automated operations. Install option: keptn install --use-case=continuous-delivery

Keptn Version /
Installation
Kubernetes AKS EKS GKE OpenShift K3s Minikube MicroK8s Minishift
0.8.x /
Control & Execution Plane
see: (3)
1.19 - 1.14 1.16 - 1.15
see: (1)
1.16 - 1.14 1.16 - 1.14 4, 3.11 1.19 - 1.16 1.10.1
(K8s:1.18.2) -
1.3.1
(K8s:1.15)
- 1.34.2
(K8s: 1.11)
0.8.x /
Control Plane
1.19 - 1.14 1.16 - 1.15
see: (1)
1.16 - 1.14 1.16 - 1.14 4, 3.11 1.19 - 1.16 1.10.1
(K8s:1.18.2) -
1.3.1
(K8s:1.15)
1.19 - 1.16 1.34.2
(K8s: 1.11)
0.7.x /
Control & Execution Plane
see: (3)
1.19 - 1.14 1.16 - 1.15
see: (1)
1.16 - 1.14 1.16 - 1.14 4, 3.11 1.19 - 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.19 - 1.14 1.16 - 1.15
see: (1)
1.16 - 1.14 1.16 - 1.14 4, 3.11 1.19 - 1.16 1.10.1
(K8s:1.18.2) -
1.3.1
(K8s:1.15)
1.19 - 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.