Switch language name 'zh' to 'zh-cn'

This is the first step to rename 'zh' to 'zh-cn'. There are several reasons why we rename the language name. - The upstream docsy theme changed the language name, leading to many warnings during site build; The side-effect is that the i18n strings are no longer working. - We believe renaming the language is the right thing to do, because this move can make room for other variants of Chinese language, such as 'zh-tw', 'zh-sg' etc. There would be several follow-ups to this PR, such as fixing the intra-site links, adding redirects etc. We will lock up changes to zh/zh-cn pages for the moment, until this one gets in. This PR is based on commit cdad0a7342.
2022-06-10 20:25:27 +08:00
parent 3d345b1816
commit c52818c03d
1347 changed files with 8 additions and 6 deletions
@@ -0,0 +1,289 @@
+---
+title: 为命名空间配置内存和 CPU 配额
+content_type: task
+weight: 50
+description: >-
+  为命名空间定义总的 CPU 和内存资源限制。
+---
+
+<!--
+title: Configure Memory and CPU Quotas for a Namespace
+content_type: task
+weight: 50
+description: >-
+  Define overall memory and CPU resource limits for a namespace.
+-->
+
+<!-- overview -->
+
+<!--
+This page shows how to set quotas for the total amount memory and CPU that
+can be used by all Pods running in a {{< glossary_tooltip text="namespace" term_id="namespace" >}}.
+You specify quotas in a
+[ResourceQuota](/docs/reference/kubernetes-api/policy-resources/resource-quota-v1/)
+object.
+-->
+本文介绍如何为{{< glossary_tooltip text="命名空间" term_id="namespace" >}}下运行的所有 Pod 设置总的内存和 CPU 配额。
+你可以通过使用
+[ResourceQuota](/docs/reference/kubernetes-api/policy-resources/resource-quota-v1/)
+对象设置配额.
+
+## {{% heading "prerequisites" %}}
+
+{{< include "task-tutorial-prereqs.md" >}}
+
+<!--
+You must have access to create namespaces in your cluster.
+
+Each node in your cluster must have at least 1 GiB of memory.
+-->
+在你的集群里你必须要有创建命名空间的权限。
+
+集群中每个节点至少有 1 GiB 的内存。
+
+<!-- steps -->
+
+<!--
+## Create a namespace
+
+Create a namespace so that the resources you create in this exercise are
+isolated from the rest of your cluster.
+-->
+
+## 创建命名空间
+
+创建一个命名空间，以便本练习中创建的资源和集群的其余部分相隔离。
+
+```shell
+kubectl create namespace quota-mem-cpu-example
+```
+
+<!--
+## Create a ResourceQuota
+
+Here is a manifest for an example ResourceQuota:
+-->
+## 创建 ResourceQuota
+
+下面是 ResourceQuota 的示例清单：
+
+{{< codenew file="admin/resource/quota-mem-cpu.yaml" >}}
+
+<!--
+Create the ResourceQuota:
+-->
+创建 ResourceQuota
+
+```shell
+kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu.yaml --namespace=quota-mem-cpu-example
+```
+
+<!--
+View detailed information about the ResourceQuota:
+-->
+查看 ResourceQuota 详情：
+
+```shell
+kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example --output=yaml
+```
+
+<!--
+The ResourceQuota places these requirements on the quota-mem-cpu-example namespace:
+
+* For every Pod in the namespace, each container must have a memory request, memory limit, cpu request, and cpu limit.
+* The memory request total for all Pods in that namespace must not exceed 1 GiB.
+* The memory limit total for all Pods in that namespace must not exceed 2 GiB.
+* The CPU request total for all Pods in that namespace must not exceed 1 cpu.
+* The CPU limit total for all Pods in that namespace must not exceed 2 cpu.
+
+See [meaning of CPU](/docs/concepts/configuration/manage-resources-containers/#meaning-of-cpu)
+to learn what Kubernetes means by “1 CPU”.
+-->
+ResourceQuota 在 quota-mem-cpu-example 命名空间中设置了如下要求：
+
+* 在该命名空间中的每个 Pod 的所有容器都必须要有内存请求和限制，以及 CPU 请求和限制。
+* 在该命名空间中所有 Pod 的内存请求总和不能超过 1 GiB。
+* 在该命名空间中所有 Pod 的内存限制总和不能超过 2 GiB。
+* 在该命名空间中所有 Pod 的 CPU 请求总和不能超过 1 cpu。
+* 在该命名空间中所有 Pod 的 CPU 限制总和不能超过 2 cpu。
+
+请阅读 [CPU 的含义](/zh/docs/concepts/configuration/manage-resources-containers/#meaning-of-cpu)
+理解 "1 CPU" 在 Kubernetes 中的含义。
+<!--
+## Create a Pod
+
+Here is a manifest for an example Pod:
+-->
+## 创建 Pod
+
+以下是 Pod 的示例清单：
+
+{{< codenew file="admin/resource/quota-mem-cpu-pod.yaml" >}}
+
+<!--
+Create the Pod:
+-->
+创建 Pod：
+
+```shell
+kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu-pod.yaml --namespace=quota-mem-cpu-example
+```
+
+<!--
+Verify that the Pod is running and that its (only) container is healthy:
+-->
+确认 Pod 正在运行，并且其容器处于健康状态：
+
+```shell
+kubectl get pod quota-mem-cpu-demo --namespace=quota-mem-cpu-example
+```
+
+<!--
+Once again, view detailed information about the ResourceQuota:
+-->
+再查看 ResourceQuota 的详情：
+
+```shell
+kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example --output=yaml
+```
+
+<!--
+The output shows the quota along with how much of the quota has been used.
+You can see that the memory and CPU requests and limits for your Pod do not
+exceed the quota.
+-->
+输出结果显示了配额以及有多少配额已经被使用。你可以看到 Pod 的内存和 CPU 请求值及限制值没有超过配额。
+
+```
+status:
+  hard:
+    limits.cpu: "2"
+    limits.memory: 2Gi
+    requests.cpu: "1"
+    requests.memory: 1Gi
+  used:
+    limits.cpu: 800m
+    limits.memory: 800Mi
+    requests.cpu: 400m
+    requests.memory: 600Mi
+```
+
+<!--
+If you have the `jq` tool, you can also query (using [JSONPath](/docs/reference/kubectl/jsonpath/))
+for just the `used` values, **and** pretty-print that that of the output. For example:
+-->
+如果有 `jq` 工具的话，你可以通过（使用 [JSONPath](/zh/docs/reference/kubectl/jsonpath/)）
+直接查询 `used` 字段的值，并且输出整齐的 JSON 格式。
+
+```shell
+kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example -o jsonpath='{ .status.used }' | jq .
+```
+
+<!--
+## Attempt to create a second Pod
+
+Here is a manifest for a second Pod:
+-->
+## 尝试创建第二个 Pod
+
+以下为第二个 Pod 的清单：
+
+{{< codenew file="admin/resource/quota-mem-cpu-pod-2.yaml" >}}
+
+<!--
+In the manifest, you can see that the Pod has a memory request of 700 MiB.
+Notice that the sum of the used memory request and this new memory
+request exceeds the memory request quota: 600 MiB + 700 MiB > 1 GiB.
+
+Attempt to create the Pod:
+-->
+
+在清单中，你可以看到 Pod 的内存请求为 700 MiB。
+请注意新的内存请求与已经使用的内存请求之和超过了内存请求的配额：
+600 MiB + 700 MiB > 1 GiB。
+
+尝试创建 Pod：
+
+```shell
+kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu-pod-2.yaml --namespace=quota-mem-cpu-example
+```
+
+<!--
+The second Pod does not get created. The output shows that creating the second Pod
+would cause the memory request total to exceed the memory request quota.
+-->
+第二个 Pod 不能被创建成功。输出结果显示创建第二个 Pod 会导致内存请求总量超过内存请求配额。
+
+```
+Error from server (Forbidden): error when creating "examples/admin/resource/quota-mem-cpu-pod-2.yaml":
+pods "quota-mem-cpu-demo-2" is forbidden: exceeded quota: mem-cpu-demo,
+requested: requests.memory=700Mi,used: requests.memory=600Mi, limited: requests.memory=1Gi
+```
+
+<!--
+## Discussion
+
+As you have seen in this exercise, you can use a ResourceQuota to restrict
+the memory request total for all Pods running in a namespace.
+You can also restrict the totals for memory limit, cpu request, and cpu limit.
+
+Instead of managing total resource use within a namespace, you might want to restrict
+individual Pods, or the containers in those Pods. To achieve that kind of limiting, use a
+[LimitRange](/docs/concepts/policy/limit-range/).
+-->
+## 讨论
+
+如你在本练习中所见，你可以用 ResourceQuota 限制命名空间中所有 Pod 的内存请求总量。
+同样你也可以限制内存限制总量、CPU 请求总量、CPU 限制总量。
+
+除了可以管理命名空间资源使用的总和，如果你想限制单个 Pod，或者限制这些 Pod 中的容器资源，
+可以使用 [LimitRange](/zh/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/) 实现这类的功能。
+
+<!--
+## Clean up
+
+Delete your namespace:
+-->
+## 清理
+
+删除你的命名空间：
+
+```shell
+kubectl delete namespace quota-mem-cpu-example
+```
+
+## {{% heading "whatsnext" %}}
+
+<!--
+### For cluster administrators
+
+* [Configure Default Memory Requests and Limits for a Namespace](/docs/tasks/administer-cluster/memory-default-namespace/)
+* [Configure Default CPU Requests and Limits for a Namespace](/docs/tasks/administer-cluster/cpu-default-namespace/)
+* [Configure Minimum and Maximum Memory Constraints for a Namespace](/docs/tasks/administer-cluster/memory-constraint-namespace/)
+* [Configure Minimum and Maximum CPU Constraints for a Namespace](/docs/tasks/administer-cluster/cpu-constraint-namespace/)
+* [Configure a Pod Quota for a Namespace](/docs/tasks/administer-cluster/quota-pod-namespace/)
+* [Configure Quotas for API Objects](/docs/tasks/administer-cluster/quota-api-object/)
+-->
+
+### 集群管理员参考
+
+* [为命名空间配置默认内存请求和限制](/zh/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/)
+* [为命名空间配置内存限制的最小值和最大值](/zh/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/)
+* [为命名空间配置 CPU 限制的最小值和最大值](/zh/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/)
+* [为命名空间配置内存和 CPU 配额](/zh/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)
+* [为命名空间配置 Pod 配额](/zh/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/)
+* [为 API 对象配置配额](/zh/docs/tasks/administer-cluster/quota-api-object/)
+
+<!--
+### For app developers
+
+* [Assign Memory Resources to Containers and Pods](/docs/tasks/configure-pod-container/assign-memory-resource/)
+* [Assign CPU Resources to Containers and Pods](/docs/tasks/configure-pod-container/assign-cpu-resource/)
+* [Configure Quality of Service for Pods](/docs/tasks/configure-pod-container/quality-service-pod/)
+-->
+### 应用开发者参考
+
+* [为容器和 Pod 分配内存资源](/zh/docs/tasks/configure-pod-container/assign-memory-resource/)
+* [为容器和 Pod 分配 CPU 资源](/zh/docs/tasks/configure-pod-container/assign-cpu-resource/)
+* [为 Pod 配置服务质量](/zh/docs/tasks/configure-pod-container/quality-service-pod/)
+