Merge pull request #36525 from peizhouyu/zh-user-namespace

[zh] Updated content/zh-cn/docs/tasks/configure-pod-container/user-namespaces.md

content/zh-cn/docs/tasks/configure-pod-container/user-namespaces.md

@@ -0,0 +1,176 @@
+---
+title: 为 Pod 配置用户名字空间
+reviewers:
+content_type: task
+weight: 160
+min-kubernetes-server-version: v1.25
+---
+
+<!--
+title: Use a User Namespace With a Pod
+reviewers:
+content_type: task
+weight: 160
+min-kubernetes-server-version: v1.25
+-->
+
+<!-- overview -->
+{{< feature-state for_k8s_version="v1.25" state="alpha" >}}
+
+<!--
+This page shows how to configure a user namespace for stateless pods. This
+allows to isolate the user running inside the container from the one in the
+host.
+-->
+本页展示如何为无状态 Pod 配置用户名字空间。可以将容器内的用户与主机上的用户隔离开来。
+
+<!--
+A process running as root in a container can run as a different (non-root) user
+in the host; in other words, the process has full privileges for operations
+inside the user namespace, but is unprivileged for operations outside the
+namespace.
+-->
+在容器中以 root 用户运行的进程可以以不同的（非 root）用户在宿主机上运行；换句话说，
+进程在用户名字空间内部拥有执行操作的全部特权，但在用户名字空间外部并没有执行操作的特权。
+
+<!--
+You can use this feature to reduce the damage a compromised container can do to
+the host or other pods in the same node. There are [several security
+vulnerabilities][KEP-vulns] rated either **HIGH** or **CRITICAL** that were not
+exploitable when user namespaces is active. It is expected user namespace will
+mitigate some future vulnerabilities too.
+-->
+你可以使用这个特性来减少有害的容器对同一宿主机上其他容器的影响。
+[有些安全脆弱性问题][KEP-vulns]被评为 **HIGH** or **CRITICAL**，但当用户名字空间被启用时，
+它们是无法被利用的。相信用户名字空间也能减轻一些未来的漏洞的影响。
+
+<!--
+Without using a user namespace a container running as root, in the case of a
+container breakout, has root privileges on the node. And if some capability were
+granted to the container, the capabilities are valid on the host too. None of
+this is true when user namespaces are used.
+-->
+在不使用用户名字空间的情况下，对于以 root 用户运行的容器而言，发生容器逃逸时，
+容器将拥有在宿主机上的 root 特权。如果容器被赋予了某些权限，则这些权限在宿主机上同样有效。
+当使用用户名字空间时这些都不可能发生。
+
+[KEP-vulns]: https://github.com/kubernetes/enhancements/tree/217d790720c5aef09b8bd4d6ca96284a0affe6c2/keps/sig-node/127-user-namespaces#motivation
+
+## {{% heading "prerequisites" %}}
+
+{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+
+{{% thirdparty-content single="true" %}}
+<!-- if adding another runtime in the future, omit the single setting -->
+
+<!--
+* The node OS needs to be Linux
+* You need to exec commands in the host
+* You need to be able to exec into pods
+* Feature gate `UserNamespacesStatelessPodsSupport` need to be enabled.
+-->
+* 节点上的操作系统必须为 Linux
+* 你需要在宿主机上执行命令
+* 你需要能够通过 exec 操作进入 Pod
+* 特性 `UserNamespacesStatelessPodsSupport` 需要被启用。
+
+<!--
+In addition, support is needed in the
+{{< glossary_tooltip text="container runtime" term_id="container-runtime" >}}
+to use this feature with Kubernetes stateless pods:
+-->
+此外, 需要{{< glossary_tooltip text="容器运行时" term_id="container-runtime" >}}提供相应的支持，
+才能将此特性与 Kubernetes 无状态 Pod 一起使用：
+
+<!--
+* CRI-O: v1.25 has support for user namespaces.
+-->
+* CRI-O: v1.25 支持用户名字空间。
+
+<!--
+Please note that **if your container runtime doesn't support user namespaces, the
+new `pod.spec` field will be silently ignored and the pod will be created without
+user namespaces.**
+-->
+请注意 **如果你的容器运行时环境不支持用户名字空间，字段 `pod.spec` 将被忽略，
+并且系统会在没有用户名字空间的环境中创建 Pod。**
+
+<!-- steps -->
+
+<!--
+## Run a Pod that uses a user namespace {#create-pod}
+-->
+## 运行一个使用用户名字空间的 Pod {#create-pod}
+
+<!--
+A user namespace for a stateless pod is enabled setting the `hostUsers` field of
+`.spec` to `false`. For example:
+-->
+为一个无状态的 Pod 启用用户名字空间需要设置 `.spec` 的 `hostUsers` 字段
+为 `false`. 例如:
+
+{{< codenew file="pods/user-namespaces-stateless.yaml" >}}
+
+<!--
+1. Create the pod on your cluster:
+-->
+1. 在你的集群上创建 Pod：
+
+   ```shell
+   kubectl apply -f https://k8s.io/examples/pods/user-namespaces-stateless.yaml
+   ```
+
+<!--
+1. Attach to the container and run `readlink /proc/self/ns/user`:
+-->
+2. 挂接到容器上并执行 `readlink /proc/self/ns/user`：
+
+   ```shell
+   kubectl attach -it userns bash
+   ```
+
+<!--
+And run the command. The output is similar to this:
+-->
+执行命令的输出类似于：
+
+```none
+readlink /proc/self/ns/user
+user:[4026531837]
+cat /proc/self/uid_map
+0          0 4294967295
+```
+
+<!--
+Then, open a shell in the host and run the same command.
+-->
+然后，在主机中打开一个 Shell 并运行相同的命令。
+
+<!--
+The output must be different. This means the host and the pod are using a
+different user namespace. When user namespaces are not enabled, the host and the
+pod use the same user namespace.
+-->
+输出一定是不同的。这意味着主机和 Pod 使用不同的用户名字空间。当未启用用户名字空间时，
+宿主机和 Pod 使用相同的用户名字空间。
+
+<!--
+If you are running the kubelet inside a user namespace, you need to compare the
+output from running the command in the pod to the output of running in the host:
+-->
+如果你在用户名字空间中运行 kubelet，则需要将在 Pod 中运行命令的输出与在主机中运行的输出进行比较：
+
+<!--
+```none
+readlink /proc/$pid/ns/user
+user:[4026534732]
+
+
+replacing `$pid` with the kubelet PID.
+-->
+```none
+readlink /proc/$pid/ns/user
+user:[4026534732]
+
+
+使用 kubelet 的进程号代替 `$pid`

content/zh-cn/examples/pods/user-namespaces-stateless.yaml

@@ -0,0 +1,10 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: userns
+spec:
+  hostUsers: false
+  containers:
+  - name: shell
+    command: ["sleep", "infinity"]
+    image: debian