Skip to content

Commit 9ded84a

Browse files
authored
Merge pull request #42124 from mrgiles/39444_kubeadm_install_no_pkg_mgr_info
Add note for Linux distros that don't include glibc
2 parents f8da02e + d263d8c commit 9ded84a

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
@@ -33,6 +33,14 @@ see the [Creating a cluster with kubeadm](/docs/setup/production-environment/too
3333
will disable swapping temporarily. To make this change persistent across reboots, make sure swap is disabled in
3434
config files like `/etc/fstab`, `systemd.swap`, depending how it was configured on your system.
3535

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

3846
## Verify the MAC address and product_uuid are unique for every node {#verify-mac-address}
@@ -289,6 +297,10 @@ sudo mkdir -p /etc/systemd/system/kubelet.service.d
289297
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
290298
```
291299

300+
{{< note >}}
301+
Please refer to the note in the [Before you begin](#before-you-begin) section for Linux distributions that do not include `glibc` by default.
302+
{{< /note >}}
303+
292304
Install `kubectl` by following the instructions on [Install Tools page](/docs/tasks/tools/#kubectl).
293305

294306
Enable and start `kubelet`:

0 commit comments

Comments
 (0)