Skip to content

Commit 89e0ec8

Browse files
committed
content: Add OCI runtime requirements for userns
Signed-off-by: Rodrigo Campos <[email protected]>
1 parent b327397 commit 89e0ec8

File tree

1 file changed

+20
-1
lines changed

1 file changed

+20
-1
lines changed

content/en/docs/concepts/workloads/pods/user-namespaces.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,26 @@ tmpfs, Secrets use a tmpfs, etc.)
4646
Some popular filesystems that support idmap mounts in Linux 6.3 are: btrfs,
4747
ext4, 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" >}}
5170
to use this feature with Kubernetes pods:
5271

0 commit comments

Comments
 (0)