forked from 2i2c-org/infrastructure
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add k8s version skew policy notes
- Loading branch information
1 parent
1ef4c7f
commit 18956d8
Showing
2 changed files
with
22 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
(upgrade-cluster:k8s-version-skew)= | ||
# About Kubernetes' version skew policy | ||
|
||
When we upgrade our Kubernetes clusters, we upgrade the k8s control plane (k8s | ||
api-server etc.), the cloud providers managed workloads (`calico-node` etc.), | ||
and the k8s node's software (`kubelet` etc.). Since these upgrades aren't done | ||
at the exact same time, there are known constraints on how the various versions | ||
can _skew_ in relation to each other. | ||
|
||
When we upgrade, we are practically constrained by [Kubernetes' version skew | ||
policy] in the following ways: | ||
|
||
1. Highly available clusters' control planes can only be upgraded one minor | ||
version at the time (`api-server` requirement). | ||
|
||
All of our new clusters and most of our old clusters are regional, so our | ||
documentation assumes we need to respect this constraint. | ||
2. Nodes' k8s version must not be newer than the control plane, and be at most | ||
three minor versions older (`kubelet` requirement). | ||
|
||
[Kubernetes' version skew policy]: https://kubernetes.io/releases/version-skew-policy/#supported-version-skew |