Merge pull request #39441 from tengqm/zh-resync-qos

[zh] Resync QoS Pod page

Author: k8s-ci-robot

content/zh-cn/docs/tasks/configure-pod-container/quality-service-pod.md

@@ -14,39 +14,46 @@ weight: 30
 
 <!--
 This page shows how to configure Pods so that they will be assigned particular
-Quality of Service (QoS) classes. Kubernetes uses QoS classes to make decisions about
-scheduling and evicting Pods.
+{{< glossary_tooltip text="Quality of Service (QoS) classes" term_id="qos-class" >}}.
+Kubernetes uses QoS classes to make decisions about evicting Pods when Node resources are exceeded.
 -->
-本页介绍怎样配置 Pod 让其获得特定的服务质量（QoS）类。Kubernetes 使用 QoS 类来决定 Pod 的调度和驱逐策略。
+本页介绍怎样配置 Pod 以让其归属于特定的
+{{< glossary_tooltip text="服务质量类（Quality of Service class，QoS class）" term_id="qos-class" >}}.
+Kubernetes 在 Node 资源不足时使用 QoS 类来就驱逐 Pod 作出决定。
 
-## {{% heading "prerequisites" %}}
+<!--
+When Kubernetes creates a Pod it assigns one of these QoS classes to the Pod:
 
-{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+* [Guaranteed](/docs/concepts/workloads/pods/pod-qos/#guaranteed)
+* [Burstable](/docs/concepts/workloads/pods/pod-qos/#burstable)
+* [BestEffort](/docs/concepts/workloads/pods/pod-qos/#besteffort)
+-->
+Kubernetes 创建 Pod 时，会将如下 QoS 类之一设置到 Pod 上：
 
-<!-- steps -->
+* [Guaranteed](/zh-cn/docs/concepts/workloads/pods/pod-qos/#guaranteed)
+* [Burstable](/zh-cn/docs/concepts/workloads/pods/pod-qos/#burstable)
+* [BestEffort](/zh-cn/docs/concepts/workloads/pods/pod-qos/#besteffort)
 
-<!--
-## QoS classes
+## {{% heading "prerequisites" %}}
 
-When Kubernetes creates a Pod it assigns one of these QoS classes to the Pod:
--->
-## QoS 类  {#qos-classes}
+{{< include "task-tutorial-prereqs.md" >}}
 
-Kubernetes 创建 Pod 时就给它指定了下列一种 QoS 类：
+<!--
+You also need to be able to create and delete namespaces.
+-->
+你还需要能够创建和删除名字空间。
 
-* Guaranteed
-* Burstable
-* BestEffort
+<!-- steps -->
 
 <!--
 ## Create a namespace
 
 Create a namespace so that the resources you create in this exercise are
 isolated from the rest of your cluster.
 -->
-## 创建命名空间  {#create-a-namespace}
+## 创建名字空间  {#create-a-namespace}
 
-创建一个命名空间，以便将本练习所创建的资源与集群的其余资源相隔离。
+创建一个名字空间，以便将本练习所创建的资源与集群的其余资源相隔离。
 
 ```shell
 kubectl create namespace qos-example
@@ -62,10 +69,6 @@ For a Pod to be given a QoS class of Guaranteed:
 * Every Container in the Pod must have a CPU limit and a CPU request.
 * For every Container in the Pod, the CPU limit must equal the CPU request.
 
-These restrictions apply to init containers and app containers equally.
-
-Here is the configuration file for a Pod that has one Container. The Container has a memory limit and a
-memory request, both equal to 200 MiB. The Container has a CPU limit and a CPU request, both equal to 700 milliCPU:
 -->
 ## 创建一个 QoS 类为 Guaranteed 的 Pod  {#create-a-pod-that-gets-assigned-a-qos-class-of-guaranteed}
 
@@ -76,11 +79,21 @@ memory request, both equal to 200 MiB. The Container has a CPU limit and a CPU r
 * Pod 中的每个容器都必须指定 CPU 限制和 CPU 请求。
 * 对于 Pod 中的每个容器，CPU 限制必须等于 CPU 请求。
 
+<!--
+These restrictions apply to init containers and app containers equally.
+[Ephemeral containers](/docs/concepts/workloads/pods/ephemeral-containers/)
+cannot define resources so these restrictions do not apply.
+
+Here is a manifest for a Pod that has one Container. The Container has a memory limit and a
+memory request, both equal to 200 MiB. The Container has a CPU limit and a CPU request, both equal to 700 milliCPU:
+-->
+
 这些限制同样适用于初始化容器和应用程序容器。
+[临时容器（Ephemeral Container）](/zh-cn/docs/concepts/workloads/pods/ephemeral-containers/)
+无法定义资源，因此不受这些约束限制。
 
-下面是包含一个容器的 Pod 配置文件。
-该容器设置了内存请求和内存限制，值都是 200 MiB。
-该容器设置了 CPU 请求和 CPU 限制，值都是 700 milliCPU：
+下面是包含一个 Container 的 Pod 清单。该 Container 设置了内存请求和内存限制，值都是 200 MiB。
+该 Container 设置了 CPU 请求和 CPU 限制，值都是 700 milliCPU：
 
 {{< codenew file="pods/qos/qos-pod.yaml" >}}
 
@@ -133,10 +146,16 @@ automatically assigns a memory request that matches the limit. Similarly, if a C
 CPU limit, but does not specify a CPU request, Kubernetes automatically assigns a CPU request that matches
 the limit.
 -->
-如果容器指定了自己的内存限制，但没有指定内存请求，Kubernetes 会自动为它指定与内存限制匹配的内存请求。
-同样，如果容器指定了自己的 CPU 限制，但没有指定 CPU 请求，Kubernetes 会自动为它指定与 CPU 限制匹配的 CPU 请求。
+如果某 Container 指定了自己的内存限制，但没有指定内存请求，Kubernetes
+会自动为它指定与内存限制相等的内存请求。同样，如果容器指定了自己的 CPU 限制，
+但没有指定 CPU 请求，Kubernetes 会自动为它指定与 CPU 限制相等的 CPU 请求。
 {{< /note >}}
 
+<!--
+#### Clean up {#clean-up-guaranteed}
+-->
+#### 清理 {#clean-up-guaranteed}
+
 <!--
 Delete your Pod:
 -->
@@ -149,23 +168,23 @@ kubectl delete pod qos-demo --namespace=qos-example
 <!--
 ## Create a Pod that gets assigned a QoS class of Burstable
 
-A Pod is given a QoS class of Burstable if:
+A Pod is given a QoS class of `Burstable` if:
 
-* The Pod does not meet the criteria for QoS class Guaranteed.
+* The Pod does not meet the criteria for QoS class `Guaranteed`.
 * At least one Container in the Pod has a memory or CPU request or limit.
 
-Here is the configuration file for a Pod that has one Container. The Container has a memory limit of 200 MiB
+Here is a manifest for a Pod that has one Container. The Container has a memory limit of 200 MiB
 and a memory request of 100 MiB.
 -->
 ## 创建一个 QoS 类为 Burstable 的 Pod  {#create-a-pod-that-gets-assigned-a-qos-class-of-burstable}
 
-如果满足下面条件，将会指定 Pod 的 QoS 类为 Burstable：
+如果满足下面条件，Kubernetes 将会指定 Pod 的 QoS 类为 `Burstable`：
 
-* Pod 不符合 Guaranteed QoS 类的标准。
-* Pod 中至少一个容器具有内存或 CPU 的请求或限制。
+* Pod 不符合 `Guaranteed` QoS 类的标准。
+* Pod 中至少一个 Container 具有内存或 CPU 的请求或限制。
 
-下面是包含一个容器的 Pod 配置文件。
-该容器设置了内存限制 200 MiB 和内存请求 100 MiB。
+下面是包含一个 Container 的 Pod 清单。该 Container 设置的内存限制为 200 MiB，
+内存请求为 100 MiB。
 
 {{< codenew file="pods/qos/qos-pod-2.yaml" >}}
 
@@ -188,9 +207,9 @@ kubectl get pod qos-demo-2 --namespace=qos-example --output=yaml
 ```
 
 <!--
-The output shows that Kubernetes gave the Pod a QoS class of Burstable.
+The output shows that Kubernetes gave the Pod a QoS class of `Burstable`:
 -->
-结果表明 Kubernetes 为 Pod 配置的 QoS 类为 Burstable。
+结果表明 Kubernetes 为 Pod 配置的 QoS 类为 `Burstable`。
 
 ```yaml
 spec:
@@ -208,6 +227,11 @@ status:
   qosClass: Burstable
 ```
 
+<!--
+#### Clean up {#clean-up-burstable}
+-->
+#### 清理  {#clean-up-burstable}
+
 <!--
 Delete your Pod:
 -->
@@ -220,18 +244,17 @@ kubectl delete pod qos-demo-2 --namespace=qos-example
 <!--
 ## Create a Pod that gets assigned a QoS class of BestEffort
 
-For a Pod to be given a QoS class of BestEffort, the Containers in the Pod must not
+For a Pod to be given a QoS class of `BestEffort`, the Containers in the Pod must not
 have any memory or CPU limits or requests.
 
 Here is the configuration file for a Pod that has one Container. The Container has no memory or CPU
 limits or requests:
 -->
 ## 创建一个 QoS 类为 BestEffort 的 Pod  {#create-a-pod-that-gets-assigned-a-qos-class-of-besteffort}
 
-对于 QoS 类为 BestEffort 的 Pod，Pod 中的容器必须没有设置内存和 CPU 限制或请求。
+对于 QoS 类为 `BestEffort` 的 Pod，Pod 中的 Container 必须没有设置内存和 CPU 限制或请求。
 
-下面是包含一个容器的 Pod 配置文件。
-该容器没有设置内存和 CPU 限制或请求。
+下面是包含一个 Container 的 Pod 清单。该 Container 没有设置内存和 CPU 限制或请求。
 
 {{< codenew file="pods/qos/qos-pod-3.yaml" >}}
 
@@ -254,9 +277,9 @@ kubectl get pod qos-demo-3 --namespace=qos-example --output=yaml
 ```
 
 <!--
-The output shows that Kubernetes gave the Pod a QoS class of BestEffort.
+The output shows that Kubernetes gave the Pod a QoS class of `BestEffort`:
 -->
-结果表明 Kubernetes 为 Pod 配置的 QoS 类为 BestEffort。
+结果表明 Kubernetes 为 Pod 配置的 QoS 类为 `BestEffort`。
 
 ```yaml
 spec:
@@ -268,6 +291,11 @@ status:
   qosClass: BestEffort
 ```
 
+<!--
+#### Clean up {#clean-up-besteffort}
+-->
+#### 清理   {#clean-up-besteffort}
+
 <!--
 Delete your Pod:
 -->
@@ -285,20 +313,19 @@ request of 200 MiB. The other Container does not specify any requests or limits.
 -->
 ## 创建包含两个容器的 Pod  {#create-a-pod-that-has-two-containers}
 
-下面是包含两个容器的 Pod 配置文件。
-一个容器指定了内存请求 200 MiB。
-另外一个容器没有指定任何请求和限制。
+下面是包含两个 Container 的 Pod 配置文件。一个 Container 指定内存请求为 200 MiB。
+另外一个 Container 没有指定任何请求或限制。
 
 {{< codenew file="pods/qos/qos-pod-4.yaml" >}}
 
 <!--
-Notice that this Pod meets the criteria for QoS class Burstable. That is, it does not meet the
+Notice that this Pod meets the criteria for QoS class `Burstable`. That is, it does not meet the
 criteria for QoS class Guaranteed, and one of its Containers has a memory request.
 
 Create the Pod:
 -->
-注意此 Pod 满足 Burstable QoS 类的标准。
-也就是说它不满足 Guaranteed QoS 类标准，因为它的一个容器设有内存请求。
+注意此 Pod 满足 `Burstable` QoS 类的标准。也就是说它不满足 Guaranteed QoS 类标准，
+因为它的 Container 之一设有内存请求。
 
 创建 Pod：
 
@@ -316,9 +343,9 @@ kubectl get pod qos-demo-4 --namespace=qos-example --output=yaml
 ```
 
 <!--
-The output shows that Kubernetes gave the Pod a QoS class of Burstable:
+The output shows that Kubernetes gave the Pod a QoS class of `Burstable`:
 -->
-结果表明 Kubernetes 为 Pod 配置的 QoS 类为 Burstable：
+结果表明 Kubernetes 为 Pod 配置的 QoS 类为 `Burstable`：
 
 ```yaml
 spec:
@@ -336,6 +363,31 @@ status:
   qosClass: Burstable
 ```
 
+<!--
+## Retrieve the QoS class for a Pod
+
+Rather than see all the fields, you can view just the field you need:
+-->
+## 检视 Pod 的 QoS 类  {#retrieve-the-qos-class-for-a-pod}
+
+<!--
+Rather than see all the fields, you can view just the field you need:
+-->
+你也可以只查看你所需要的字段，而不是查看所有字段：
+
+```bash
+kubectl --namespace=qos-example get pod qos-demo-4 -o jsonpath='{ .status.qosClass}{"\n"}'
+```
+
+```none
+Burstable
+```
+
+<!--
+## Clean up
+-->
+## 清理  {#clean-up}
+
 <!--
 Delete your Pod:
 -->
@@ -352,7 +404,7 @@ Delete your namespace:
 -->
 ## 环境清理  {#clean-up}
 
-删除命名空间：
+删除名字空间：
 
 ```shell
 kubectl delete namespace qos-example
@@ -370,44 +422,28 @@ kubectl delete namespace qos-example
 ### 应用开发者参考
 
 * [为 Pod 和容器分配内存资源](/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource/)
-
 * [为 Pod 和容器分配 CPU 资源](/zh-cn/docs/tasks/configure-pod-container/assign-cpu-resource/)
 
 <!--
 ### For cluster administrators
 
 * [Configure Default Memory Requests and Limits for a Namespace](/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/)
-
 * [Configure Default CPU Requests and Limits for a Namespace](/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/)
-
 * [Configure Minimum and Maximum Memory Constraints for a Namespace](/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/)
-
 * [Configure Minimum and Maximum CPU Constraints for a Namespace](/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/)
-
 * [Configure Memory and CPU Quotas for a Namespace](/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)
-
 * [Configure a Pod Quota for a Namespace](/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/)
-
 * [Configure Quotas for API Objects](/docs/tasks/administer-cluster/quota-api-object/)
-
 * [Control Topology Management policies on a node](/docs/tasks/administer-cluster/topology-manager/)
 -->
-
 ### 集群管理员参考
 
-* [为命名空间配置默认的内存请求和限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/)
-
-* [为命名空间配置默认的 CPU 请求和限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/)
-
-* [为命名空间配置最小和最大内存限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/)
-
-* [为命名空间配置最小和最大 CPU 限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/)
-
-* [为命名空间配置内存和 CPU 配额](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)
-
-* [为命名空间配置 Pod 配额](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/)
-
+* [为名字空间配置默认的内存请求和限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/)
+* [为名字空间配置默认的 CPU 请求和限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/)
+* [为名字空间配置最小和最大内存限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/)
+* [为名字空间配置最小和最大 CPU 限制](/zh-cn/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/)
+* [为名字空间配置内存和 CPU 配额](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)
+* [为名字空间配置 Pod 配额](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/)
 * [为 API 对象配置配额](/zh-cn/docs/tasks/administer-cluster/quota-api-object/)
-
 * [控制节点上的拓扑管理策略](/zh-cn/docs/tasks/administer-cluster/topology-manager/)