From 29b15075bed457ac81aa2dc79ba11bee856f0031 Mon Sep 17 00:00:00 2001 From: Andrew Burden Date: Fri, 24 Nov 2017 15:06:20 +1100 Subject: [PATCH 1/2] Added versioning information based on https://github.com/kubernetes/community/blob/master/contributors/design-proposals/release/versioning.md --- docs/home/index.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/home/index.md b/docs/home/index.md index 983c9fae1e..36b64f7992 100644 --- a/docs/home/index.md +++ b/docs/home/index.md @@ -34,3 +34,21 @@ The [Tools](/docs/tools/) page contains a list of native and third-party tools f ## Troubleshooting The [Troubleshooting](/docs/tasks/debug-application-cluster/troubleshooting) page outlines some resources for troubleshooting and finding help. + +## Supported Versions + +Kubernetes has a _X.Y.Z_ versioning scheme, where _X_ is the major version, _Y_ is the minor version, and _Z_ is the patch version. + +Kubernetes is supported for three minor versions at a time. This includes the current release version and two previous versions. + +See the [Kubernetes Release](https://github.com/kubernetes/kubernetes/releases) page on GitHub for the latest release information. + +### Minor Versions + +Different components are expected to be compatible across different version skew relative to the master. Nodes may lag master by up to two versions, but not exceed the master version. Clients may lag master by one version and may exceed master up to one version. + +For example, a v1.8 master is expected to be compatible with v1.6, v1.7, and v1.8 nodes, and compatible with v1.7, v1.8, and v1.9 clients. + +### Patch Versions + +Patch releases often include critical bug fixes. You should be running the latest patch release of a given minor release. From c96acf5303cc94dc9bd12c5ebd09481bfa7ba422 Mon Sep 17 00:00:00 2001 From: aburdenthehand Date: Tue, 28 Nov 2017 15:46:43 +1000 Subject: [PATCH 2/2] Update index.md Updated version skew sentence for clarity. From review. --- docs/home/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/home/index.md b/docs/home/index.md index 36b64f7992..34cf0b0296 100644 --- a/docs/home/index.md +++ b/docs/home/index.md @@ -45,7 +45,7 @@ See the [Kubernetes Release](https://github.com/kubernetes/kubernetes/releases) ### Minor Versions -Different components are expected to be compatible across different version skew relative to the master. Nodes may lag master by up to two versions, but not exceed the master version. Clients may lag master by one version and may exceed master up to one version. +A certain amount of version skew is permissible between master components, node components, and the kubectl client. Nodes may lag master by up to two versions, but not exceed the master version. Clients may lag master by one version and may exceed master up to one version. For example, a v1.8 master is expected to be compatible with v1.6, v1.7, and v1.8 nodes, and compatible with v1.7, v1.8, and v1.9 clients.