@@ -46,7 +46,26 @@ tmpfs, Secrets use a tmpfs, etc.)
4646Some popular filesystems that support idmap mounts in Linux 6.3 are: btrfs,
4747ext4, xfs, fat, tmpfs, overlayfs.
4848
49- In addition, support is needed in the
49+ In addition, the container runtime and its underlying OCI runtime must support
50+ user namespaces. The following OCI runtimes offer support:
51+
52+ * [ crun] ( https://github.com/containers/crun ) version 1.9 or greater (it's recommend version 1.13+).
53+
54+ <!-- ideally, update this if a newer minor release of runc comes out, whether or not it includes the idmap support -->
55+ {{< note >}}
56+ Many OCI runtimes do not include the support needed for using user namespaces in
57+ Linux pods. If you use a managed Kubernetes, or have downloaded it from packages
58+ and set it up, it's likely that nodes in your cluster use a runtime that doesn't
59+ include this support. For example, the most widely used OCI runtime is ` runc ` ,
60+ and version ` 1.1.z ` of runc doesn't support all the features needed by the
61+ Kubernetes implementation of user namespaces.
62+
63+ If there is a newer release of runc than 1.1 available for use, check its
64+ documentation and release notes for compatibility (look for idmap mounts support
65+ in particular, because that is the missing feature).
66+ {{< /note >}}
67+
68+ To use user namespaces with Kubernetes, you also need to use a CRI
5069{{< glossary_tooltip text="container runtime" term_id="container-runtime" >}}
5170to use this feature with Kubernetes pods:
5271
0 commit comments