Skip to content

Commit d263d8c

Browse files
committed
Add note for Linux distros that don't include glibc
Reorder sentence
1 parent 91e986e commit d263d8c

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

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

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,14 @@ see the [Creating a cluster with kubeadm](/docs/setup/production-environment/too
2929
* Swap disabled. You **MUST** disable swap in order for the kubelet to work properly.
3030
* For example, `sudo swapoff -a` will disable swapping temporarily. To make this change persistent across reboots, make sure swap is disabled in config files like `/etc/fstab`, `systemd.swap`, depending how it was configured on your system.
3131

32+
{{< note >}}
33+
The `kubeadm` installation is done via binaries that use dynamic linking and assumes that your target system provides `glibc`.
34+
This is a reasonable assumption on many Linux distributions (including Debian, Ubuntu, Fedora, CentOS, etc.)
35+
but it is not always the case with custom and lightweight distributions which don't include `glibc` by default, such as Alpine Linux.
36+
The expectation is that the distribution either includes `glibc` or a [compatibility layer](https://wiki.alpinelinux.org/wiki/Running_glibc_programs)
37+
that provides the expected symbols.
38+
{{< /note >}}
39+
3240
<!-- steps -->
3341

3442
## Verify the MAC address and product_uuid are unique for every node {#verify-mac-address}
@@ -259,6 +267,10 @@ sudo mkdir -p /etc/systemd/system/kubelet.service.d
259267
curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/kubepkg/templates/latest/deb/kubeadm/10-kubeadm.conf" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /etc/systemd/system/kubelet.service.d/10-kubeadm.conf
260268
```
261269

270+
{{< note >}}
271+
Please refer to the note in the [Before you begin](#before-you-begin) section for Linux distributions that do not include `glibc` by default.
272+
{{< /note >}}
273+
262274
Install `kubectl` by following the instructions on [Install Tools page](/docs/tasks/tools/#kubectl).
263275

264276
Enable and start `kubelet`:

0 commit comments

Comments
 (0)