Skip to content

Commit 63261e2

Browse files
authored
Merge pull request #50375 from dlipovetsky/install-kubeadm-check-kernel-version
Document kubeadm OS version requirement
2 parents 51588d5 + 6e8297e commit 63261e2

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

content/en/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,41 @@ that provides the expected symbols.
3838

3939
<!-- steps -->
4040

41+
## Check your OS version
42+
43+
{{% thirdparty-content %}}
44+
45+
{{< tabs name="operating_system_version_check" >}}
46+
{{% tab name="Linux" %}}
47+
48+
* The kubeadm project supports LTS kernels. See [List of LTS kernels](https://www.kernel.org/category/releases.html).
49+
* You can get the kernel version using the command `uname -r`
50+
51+
For more information, see [Linux Kernel Requirements](/docs/reference/node/kernel-version-requirements/).
52+
53+
{{% /tab %}}
54+
55+
{{% tab name="Windows" %}}
56+
57+
* The kubeadm project supports recent kernel versions. For a list of recent kernels, see [Windows Server Release Information](https://learn.microsoft.com/en-us/windows/release-health/windows-server-release-info).
58+
* You can get the kernel version (also called the OS version) using the command `systeminfo`
59+
60+
For more information, see [Windows OS version compatibility](/docs/concepts/windows/intro/#windows-os-version-support).
61+
62+
{{% /tab %}}
63+
{{< /tabs >}}
64+
65+
A Kubernetes cluster created by kubeadm depends on software that use kernel features.
66+
This software includes, but is not limited to the
67+
{{< glossary_tooltip text="container runtime" term_id="container-runtime" >}},
68+
the {{< glossary_tooltip term_id="kubelet" text="kubelet">}}, and a {{< glossary_tooltip text="Container Network Interface" term_id="cni" >}} plugin.
69+
70+
To help you avoid unexpected errors as a result of an unsupported kernel version, kubeadm runs the `SystemVerification`
71+
pre-flight check. This check fails if the kernel version is not supported.
72+
73+
You may choose to skip the check, if you know that your kernel
74+
provides the required features, even though kubeadm does not support its version.
75+
4176
## Verify the MAC address and product_uuid are unique for every node {#verify-mac-address}
4277

4378
* You can get the MAC address of the network interfaces using the command `ip link` or `ifconfig -a`

0 commit comments

Comments
 (0)