Black lives matter.
We stand in solidarity with the Black community.
Racism is unacceptable.
It conflicts with the core values of the Kubernetes project and our community does not tolerate it.
We stand in solidarity with the Black community.
Racism is unacceptable.
It conflicts with the core values of the Kubernetes project and our community does not tolerate it.
This document describes the maximum version skew supported between various Kubernetes components. Specific cluster deployment tools may place additional restrictions on version skew.
Kubernetes 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. For more information, see Kubernetes Release Versioning.
The Kubernetes project maintains release branches for the most recent three minor releases (1.18, 1.17, 1.16).
Applicable fixes, including security fixes, may be backported to those three release branches, depending on severity and feasibility. Patch releases are cut from those branches at a regular cadence, plus additional urgent releases, when required.
The Release Managers group owns this decision.
For more information, see the Kubernetes patch releases page.
In highly-available (HA) clusters, the newest and oldest kube-apiserver
instances must be within one minor version.
Example:
kube-apiserver
is at 1.18kube-apiserver
instances are supported at 1.18 and 1.17kubelet
must not be newer than kube-apiserver
, and may be up to two minor versions older.
Example:
kube-apiserver
is at 1.18kubelet
is supported at 1.18, 1.17, and 1.16Note: If version skew exists betweenkube-apiserver
instances in an HA cluster, this narrows the allowedkubelet
versions.
Example:
kube-apiserver
instances are at 1.18 and 1.17kubelet
is supported at 1.17, and 1.16 (1.18 is not supported because that would be newer than the kube-apiserver
instance at version 1.17)kube-controller-manager
, kube-scheduler
, and cloud-controller-manager
must not be newer than the kube-apiserver
instances they communicate with. They are expected to match the kube-apiserver
minor version, but may be up to one minor version older (to allow live upgrades).
Example:
kube-apiserver
is at 1.18kube-controller-manager
, kube-scheduler
, and cloud-controller-manager
are supported at 1.18 and 1.17Note: If version skew exists betweenkube-apiserver
instances in an HA cluster, and these components can communicate with anykube-apiserver
instance in the cluster (for example, via a load balancer), this narrows the allowed versions of these components.
Example:
kube-apiserver
instances are at 1.18 and 1.17kube-controller-manager
, kube-scheduler
, and cloud-controller-manager
communicate with a load balancer that can route to any kube-apiserver
instancekube-controller-manager
, kube-scheduler
, and cloud-controller-manager
are supported at 1.17 (1.18 is not supported because that would be newer than the kube-apiserver
instance at version 1.17)kubectl
is supported within one minor version (older or newer) of kube-apiserver
.
Example:
kube-apiserver
is at 1.18kubectl
is supported at 1.19, 1.18, and 1.17Note: If version skew exists betweenkube-apiserver
instances in an HA cluster, this narrows the supportedkubectl
versions.
Example:
kube-apiserver
instances are at 1.18 and 1.17kubectl
is supported at 1.18 and 1.17 (other versions would be more than one minor version skewed from one of the kube-apiserver
components)The supported version skew between components has implications on the order in which components must be upgraded. This section describes the order in which components must be upgraded to transition an existing cluster from version 1.17 to version 1.18.
Pre-requisites:
kube-apiserver
instance is 1.17kube-apiserver
instances are at 1.17 or 1.18 (this ensures maximum skew of 1 minor version between the oldest and newest kube-apiserver
instance)kube-controller-manager
, kube-scheduler
, and cloud-controller-manager
instances that communicate with this server are at version 1.17 (this ensures they are not newer than the existing API server version, and are within 1 minor version of the new API server version)kubelet
instances on all nodes are at version 1.17 or 1.16 (this ensures they are not newer than the existing API server version, and are within 2 minor versions of the new API server version)kube-apiserver
instance will send them:
ValidatingWebhookConfiguration
and MutatingWebhookConfiguration
objects are updated to include any new versions of REST resources added in 1.18 (or use the matchPolicy: Equivalent
option available in v1.15+)Upgrade kube-apiserver
to 1.18
Note: Project policies for API deprecation and API change guidelines requirekube-apiserver
to not skip minor versions when upgrading, even in single-instance clusters.
Pre-requisites:
kube-apiserver
instances these components communicate with are at 1.18 (in HA clusters in which these control plane components can communicate with any kube-apiserver
instance in the cluster, all kube-apiserver
instances must be upgraded before upgrading these components)Upgrade kube-controller-manager
, kube-scheduler
, and cloud-controller-manager
to 1.18
Pre-requisites:
kube-apiserver
instances the kubelet
communicates with are at 1.18Optionally upgrade kubelet
instances to 1.18 (or they can be left at 1.17 or 1.16)
Warning:Running a cluster with
kubelet
instances that are persistently two minor versions behindkube-apiserver
is not recommended:
- they must be upgraded within one minor version of
kube-apiserver
before the control plane can be upgraded- it increases the likelihood of running
kubelet
versions older than the three maintained minor releases