Skip to content

Commit 51f2625

Browse files
committed
Clarify repositories structure in install kubeadm document
Signed-off-by: Marko Mudrinić <[email protected]>
1 parent 072e031 commit 51f2625

File tree

1 file changed

+34
-10
lines changed

1 file changed

+34
-10
lines changed

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

Lines changed: 34 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,14 @@ This page shows how to install the `kubeadm` toolbox.
1515
For information on how to create a cluster with kubeadm once you have performed this installation process,
1616
see the [Creating a cluster with kubeadm](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/) page.
1717

18+
This installation guide is for Kubernetes {{< skew currentVersion >}}. If you want to use a different
19+
Kubernetes version, please refer to the following pages instead:
20+
21+
- [Installing kubeadm for Kubernetes {{< skew currentVersionAddMinor -1 "." >}}](https://v{{< skew currentVersionAddMinor -1 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
22+
- [Installing kubeadm for Kubernetes {{< skew currentVersionAddMinor -2 "." >}}](https://v{{< skew currentVersionAddMinor -2 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
23+
- [Installing kubeadm for Kubernetes {{< skew currentVersionAddMinor -3 "." >}}](https://v{{< skew currentVersionAddMinor -3 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
24+
- [Installing kubeadm for Kubernetes {{< skew currentVersionAddMinor -4 "." >}}](https://v{{< skew currentVersionAddMinor -4 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
25+
1826
## {{% heading "prerequisites" %}}
1927

2028
* A compatible Linux host. The Kubernetes project provides generic instructions for Linux distributions
@@ -163,6 +171,13 @@ have been frozen starting from September 13, 2023. Please read our
163171
for more details.
164172
{{< /note >}}
165173

174+
{{< note >}}
175+
There's a dedicated package repository for each Kubernetes minor version. If you want to install
176+
a minor version other than {{< skew currentVersion >}}, please see the installation guide for
177+
your desired minor version. The official Kubernetes package repositories provide downloads for
178+
Kubernetes versions starting with v1.24.0.
179+
{{< /note >}}
180+
166181
{{< tabs name="k8s_install" >}}
167182
{{% tab name="Debian-based distributions" %}}
168183

@@ -183,7 +198,11 @@ These instructions are for Kubernetes {{< skew currentVersion >}}.
183198
curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
184199
```
185200

186-
3. Add the appropriate Kubernetes `apt` repository:
201+
3. Add the appropriate Kubernetes `apt` repository. Please note that this repository have packages
202+
only for Kubernetes {{< skew currentVersion >}}; for other Kubernetes minor versions, you need to
203+
change the Kubernetes minor version in the URL to match your desired minor version
204+
(you should also check that you are reading the documentation for the version of Kubernetes
205+
that you plan to install).
187206

188207
```shell
189208
# This overwrites any existing configuration in /etc/apt/sources.list.d/kubernetes.list
@@ -216,19 +235,24 @@ you can create it by running `sudo mkdir -m 755 /etc/apt/keyrings`
216235
sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config
217236
```
218237

219-
{{< caution >}}
220-
- Setting SELinux in permissive mode by running `setenforce 0` and `sed ...`
221-
effectively disables it. This is required to allow containers to access the host
222-
filesystem; for example, some cluster network plugins require that. You have to
223-
do this until SELinux support is improved in the kubelet.
224-
- You can leave SELinux enabled if you know how to configure it but it may require
225-
settings that are not supported by kubeadm.
226-
{{< /caution >}}
238+
{{< caution >}}
239+
- Setting SELinux in permissive mode by running `setenforce 0` and `sed ...`
240+
effectively disables it. This is required to allow containers to access the host
241+
filesystem; for example, some cluster network plugins require that. You have to
242+
do this until SELinux support is improved in the kubelet.
243+
- You can leave SELinux enabled if you know how to configure it but it may require
244+
settings that are not supported by kubeadm.
245+
{{< /caution >}}
227246

228247
2. Add the Kubernetes `yum` repository. The `exclude` parameter in the
229248
repository definition ensures that the packages related to Kubernetes are
230249
not upgraded upon running `yum update` as there's a special procedure that
231-
must be followed for upgrading Kubernetes.
250+
must be followed for upgrading Kubernetes. Please note that this repository
251+
have packages only for Kubernetes {{< skew currentVersion >}}; for other
252+
Kubernetes minor versions, you need to change the Kubernetes minor version
253+
in the URL to match your desired minor version (you should also check that
254+
you are reading the documentation for the version of Kubernetes that you
255+
plan to install).
232256

233257
```shell
234258
# This overwrites any existing configuration in /etc/yum.repos.d/kubernetes.repo

0 commit comments

Comments
 (0)