@@ -46,7 +46,26 @@ tmpfs, Secrets use a tmpfs, etc.)
46
46
Some popular filesystems that support idmap mounts in Linux 6.3 are: btrfs,
47
47
ext4, xfs, fat, tmpfs, overlayfs.
48
48
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
50
69
{{< glossary_tooltip text="container runtime" term_id="container-runtime" >}}
51
70
to use this feature with Kubernetes pods:
52
71
0 commit comments