From a7acfa8270a91a10830e541bdcbed921051e89bb Mon Sep 17 00:00:00 2001 From: Jamie Hannaford Date: Mon, 30 Oct 2017 18:44:30 +0100 Subject: [PATCH] Clarify minor version skew (#5819) --- docs/setup/independent/create-cluster-kubeadm.md | 3 +++ docs/setup/independent/install-kubeadm.md | 7 ++++++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/setup/independent/create-cluster-kubeadm.md b/docs/setup/independent/create-cluster-kubeadm.md index e5178d7a2d..46d59c0541 100644 --- a/docs/setup/independent/create-cluster-kubeadm.md +++ b/docs/setup/independent/create-cluster-kubeadm.md @@ -515,6 +515,9 @@ Due to that we can't see into the future, kubeadm CLI vX.Y may or may not be abl Example: kubeadm v1.8 can deploy both v1.7 and v1.8 clusters and upgrade v1.7 kubeadm-created clusters to v1.8. +Please also check our [installation guide](/docs/setup/independent/install-kubeadm/#installing-kubeadm-kubelet-and-kubectl) +for more information on the version skew between kubelets and the control plane. + ## kubeadm is multi-platform {#multi-platform} kubeadm deb/rpm packages and binaries are built for amd64, arm (32-bit), arm64, ppc64le, and s390x diff --git a/docs/setup/independent/install-kubeadm.md b/docs/setup/independent/install-kubeadm.md index d4ebe5f443..50d503a047 100644 --- a/docs/setup/independent/install-kubeadm.md +++ b/docs/setup/independent/install-kubeadm.md @@ -140,7 +140,12 @@ You will install these packages on all of your machines: kubeadm **will not** install or manage `kubelet` or `kubectl` for you, so you will need to ensure they match the version of the Kubernetes control panel you want kubeadm to install for you. If you do not, there is a risk of a version skew occurring that -can lead to unexpected, buggy behaviour. +can lead to unexpected, buggy behaviour. However, _one_ minor version skew between the +kubelet and the control plane is supported, but the kubelet version may never exceed the API +server version. For example, kubelets running 1.7.0 should be fully compatible with a 1.8.0 API server. + +For more information on version skews, please read our +[version skew policy](/docs/setup/independent/create-cluster-kubeadm/#version-skew-policy). Please proceed with executing the following commands based on your OS as `root`. You may become the `root` user by executing `sudo -i` after SSH-ing to each host.