Merge pull request #34248 from tengqm/zh-34221-concepts-2

[zh] Resync concepts pages after lang renaming (concepts-2)

Author: k8s-ci-robot

content/zh-cn/docs/concepts/scheduling-eviction/resource-bin-packing.md

@@ -17,75 +17,119 @@ weight: 80
 
 <!-- overview -->
 
-{{< feature-state for_k8s_version="1.16" state="alpha" >}}
+<!--
+In the [scheduling-plugin](/docs/reference/scheduling/config/#scheduling-plugins)  `NodeResourcesFit` of kube-scheduler, there are two 
+scoring strategies that support the bin packing of resources: `MostAllocated` and `RequestedToCapacityRatio`.
+-->
+在 kube-scheduler 的[调度插件](/zh-cn/docs/reference/scheduling/config/#scheduling-plugins)
+`NodeResourcesFit` 中存在两种支持资源装箱（bin packing）的策略：`MostAllocated` 和
+`RequestedToCapacityRatio`。
+
+<!-- body -->
 
 <!--
-The kube-scheduler can be configured to enable bin packing of resources along with extended resources using `RequestedToCapacityRatioResourceAllocation` priority function. Priority functions can be used to fine-tune the kube-scheduler as per custom needs.
+## Enabling bin packing using MostAllocated strategy
+
+The `MostAllocated` strategy scores the nodes based on the utilization of resources, favoring the ones with higher allocation.
+For each resource type, you can set a weight to modify its influence in the node score.
+
+To set the `MostAllocated` strategy for the `NodeResourcesFit` plugin, use a
+[scheduler configuration](/docs/reference/scheduling/config) similar to the following:
 -->
+## 使用 MostAllocated 策略启用资源装箱   {#enabling-bin-packing-using-mostallocated-strategy}
 
-使用 `RequestedToCapacityRatioResourceAllocation` 优先级函数，可以将 kube-scheduler
-配置为支持包含扩展资源在内的资源装箱操作。
-优先级函数可用于根据自定义需求微调 kube-scheduler 。
+`MostAllocated` 策略基于资源的利用率来为节点计分，优选分配比率较高的节点。
+针对每种资源类型，你可以设置一个权重值以改变其对节点得分的影响。
 
-<!-- body -->
+要为插件 `NodeResourcesFit` 设置 `MostAllocated` 策略，
+可以使用一个类似于下面这样的[调度器配置](/zh-cn/docs/reference/scheduling/config/)：
+
+```yaml
+apiVersion: kubescheduler.config.k8s.io/v1beta3
+kind: KubeSchedulerConfiguration
+profiles:
+- pluginConfig:
+  - args:
+      scoringStrategy:
+        resources:
+        - name: cpu
+          weight: 1
+        - name: memory
+          weight: 1
+        - name: intel.com/foo
+          weight: 3
+        - name: intel.com/bar
+          weight: 3
+        type: MostAllocated
+    name: NodeResourcesFit
+```
+
+<!--
+To learn more about other parameters and their default configuration, see the API documentation for 
+[`NodeResourcesFitArgs`](/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-NodeResourcesFitArgs).
+-->
+要进一步了解其它参数及其默认配置，请参阅
+[`NodeResourcesFitArgs`](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-NodeResourcesFitArgs)
+的 API 文档。
 
 <!--
-## Enabling Bin Packing using RequestedToCapacityRatioResourceAllocation
+## Enabling bin packing using RequestedToCapacityRatio
 
-Kubernetes allows the users to specify the resources along with weights for
+The `RequestedToCapacityRatio` strategy allows the users to specify the resources along with weights for
 each resource to score nodes based on the request to capacity ratio. This
 allows users to bin pack extended resources by using appropriate parameters
-and improves the utilization of scarce resources in large clusters. The
-behavior of the `RequestedToCapacityRatioResourceAllocation` priority function
-can be controlled by a configuration option called `RequestedToCapacityRatioArgs`. 
-This argument consists of two parameters `shape` and `resources`. The `shape` 
+to improve the utilization of scarce resources in large clusters. It favors nodes according to a
+configured function of the allocated resources. The behavior of the `RequestedToCapacityRatio` in
+the `NodeResourcesFit` score function can be controlled by the
+[scoringStrategy](/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-ScoringStrategy) field.
+Within the `scoringStrategy` field, you can configure two parameters: `requestedToCapacityRatioParam` and
+`resources`. The `shape` in `requestedToCapacityRatioParam` 
 parameter allows the user to tune the function as least requested or most 
 requested based on `utilization` and `score` values.  The `resources` parameter 
 consists of `name` of the resource to be considered during scoring and `weight` 
 specify the weight of each resource.
-
 -->
-
-## 使用 RequestedToCapacityRatioResourceAllocation 启用装箱
-
-Kubernetes 允许用户指定资源以及每类资源的权重，
-以便根据请求数量与可用容量之比率为节点评分。
-这就使得用户可以通过使用适当的参数来对扩展资源执行装箱操作，从而提高了大型集群中稀缺资源的利用率。
-`RequestedToCapacityRatioResourceAllocation` 优先级函数的行为可以通过名为
-`RequestedToCapacityRatioArgs` 的配置选项进行控制。
-该标志由两个参数 `shape` 和 `resources` 组成。
-`shape` 允许用户根据 `utilization` 和 `score` 值将函数调整为
-最少请求（least requested）或最多请求（most requested）计算。
-`resources` 包含由 `name` 和  `weight` 组成，`name` 指定评分时要考虑的资源，
-`weight` 指定每种资源的权重。
+## 使用 RequestedToCapacityRatio 策略来启用资源装箱 {#enabling-bin-packing-using-requestedtocapacityratio}
+
+`RequestedToCapacityRatio` 策略允许用户基于请求值与容量的比率，针对参与节点计分的每类资源设置权重。
+这一策略是的用户可以使用合适的参数来对扩展资源执行装箱操作，进而提升大规模集群中稀有资源的利用率。
+此策略根据所分配资源的一个配置函数来评价节点。
+`NodeResourcesFit` 计分函数中的 `RequestedToCapacityRatio` 可以通过字段
+[scoringStrategy](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-ScoringStrategy)
+来控制。
+在 `scoringStrategy` 字段中，你可以配置两个参数：`requestedToCapacityRatioParam`
+和 `resources`。`requestedToCapacityRatioParam` 参数中的 `shape`
+设置使得用户能够调整函数的算法，基于 `utilization` 和 `score` 值计算最少请求或最多请求。
+`resources` 参数中包含计分过程中需要考虑的资源的 `name`，以及用来设置每种资源权重的 `weight`。
 
 <!--
 Below is an example configuration that sets
-`requestedToCapacityRatioArguments` to bin packing behavior for extended
-resources `intel.com/foo` and `intel.com/bar`.
+the bin packing behavior for extended resources `intel.com/foo` and `intel.com/bar`
+using the `requestedToCapacityRatio` field.
 -->
-
-以下是一个配置示例，该配置将 `requestedToCapacityRatioArguments` 设置为对扩展资源
-`intel.com/foo` 和 `intel.com/bar` 的装箱行为
+下面是一个配置示例，使用 `requestedToCapacityRatio` 字段为扩展资源 `intel.com/foo`
+和 `intel.com/bar` 设置装箱行为：
 
 ```yaml
 apiVersion: kubescheduler.config.k8s.io/v1beta3
 kind: KubeSchedulerConfiguration
 profiles:
-# ...
-  pluginConfig:
-  - name: RequestedToCapacityRatio
-    args: 
-      shape:
-      - utilization: 0
-        score: 10
-      - utilization: 100
-        score: 0
-      resources:
-      - name: intel.com/foo
-        weight: 3
-      - name: intel.com/bar
-        weight: 5
+- pluginConfig:
+  - args:
+      scoringStrategy:
+        resources:
+        - name: intel.com/foo
+          weight: 3
+        - name: intel.com/bar
+          weight: 3
+        requestedToCapacityRatioParam:
+          shape:
+          - utilization: 0
+            score: 0
+          - utilization: 100
+            score: 10
+        type: RequestedToCapacityRatio
+    name: NodeResourcesFit
 ```
 
 <!--
@@ -94,22 +138,24 @@ flag `--config=/path/to/config/file` will pass the configuration to the
 scheduler.
 -->
 使用 kube-scheduler 标志 `--config=/path/to/config/file` 
-引用 `KubeSchedulerConfiguration` 文件将配置传递给调度器。
+引用 `KubeSchedulerConfiguration` 文件，可以将配置传递给调度器。
 
 <!--
-**This feature is disabled by default**
+To learn more about other parameters and their default configuration, see the API documentation for 
+[`NodeResourcesFitArgs`](/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-NodeResourcesFitArgs).
 -->
-
-**默认情况下此功能处于被禁用状态**
+要进一步了解其它参数及其默认配置，可以参阅
+[`NodeResourcesFitArgs`](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-NodeResourcesFitArgs)
+的 API 文档。
 
 <!--
-### Tuning RequestedToCapacityRatioResourceAllocation Priority Function
+### Tuning the score function
 
-`shape` is used to specify the behavior of the `RequestedToCapacityRatioPriority` function.
+`shape` is used to specify the behavior of the `RequestedToCapacityRatio` function.
 -->
-### 调整 RequestedToCapacityRatioResourceAllocation 优先级函数
+### 调整计分函数    {#tuning-the-score-function}
 
-`shape` 用于指定 `RequestedToCapacityRatioPriority` 函数的行为。
+`shape` 用于指定 `RequestedToCapacityRatio` 函数的行为。
 
 ```yaml
 shape:
@@ -120,9 +166,10 @@ shape:
 ```
 
 <!--
-The above arguments give the node a score of 0 if utilization is 0% and 10 for utilization 100%, thus enabling bin packing behavior. To enable least requested the score value must be reversed as follows.
+The above arguments give the node a `score` of 0 if `utilization` is 0% and 10 for
+`utilization` 100%, thus enabling bin packing behavior. To enable least
+requested the score value must be reversed as follows.
 -->
-
 上面的参数在 `utilization` 为 0% 时给节点评分为 0，在 `utilization` 为
 100% 时给节点评分为 10，因此启用了装箱行为。
 要启用最少请求（least requested）模式，必须按如下方式反转得分值。
@@ -151,7 +198,7 @@ resources:
 <!--
 It can be used to add extended resources as follows:
 -->
-它可以用来添加扩展资源，如下所示：
+它可以像下面这样用来添加扩展资源：
 
 ```yaml
 resources:
@@ -164,10 +211,11 @@ resources:
 ```
 
 <!--
-The weight parameter is optional and is set to 1 if not specified. Also, the weight cannot be set to a negative value.
+The `weight` parameter is optional and is set to 1 if not specified. Also, the
+`weight` cannot be set to a negative value.
 -->
-weight 参数是可选的，如果未指定，则设置为 1。
-同时，weight 不能设置为负值。
+`weight` 参数是可选的，如果未指定，则设置为 1。
+同时，`weight` 不能设置为负值。
 
 <!--
 ### Node scoring for capacity allocation
@@ -176,29 +224,43 @@ This section is intended for those who want to understand the internal details
 of this feature.
 Below is an example of how the node score is calculated for a given set of values.
 -->
-
-### 节点容量分配的评分
+### 节点容量分配的评分   {#node-scoring-for-capacity-allocation}
 
 本节适用于希望了解此功能的内部细节的人员。
 以下是如何针对给定的一组值来计算节点得分的示例。
 
-```
-请求的资源
+<!--
+Requested resources:
+-->
+请求的资源：
 
+```
 intel.com/foo : 2
 memory: 256MB
 cpu: 2
+```
 
-资源权重
+<!--
+Resource weights:
+-->
+资源权重：
 
+```
 intel.com/foo : 5
 memory: 1
 cpu: 3
+```
 
+```
 FunctionShapePoint {{0, 0}, {100, 10}}
+```
 
-节点 Node 1 配置
+<!--
+Node 1 spec:
+-->
+节点 1 配置：
 
+```
 可用：
   intel.com/foo : 4
   memory : 1 GB
@@ -208,34 +270,43 @@ FunctionShapePoint {{0, 0}, {100, 10}}
   intel.com/foo: 1
   memory: 256MB
   cpu: 1
+```
 
+<!--
+Node score:
+-->
 节点得分：
 
+```
 intel.com/foo  = resourceScoringFunction((2+1),4)
                = (100 - ((4-3)*100/4)
                = (100 - 25)
-               = 75
-               = rawScoringFunction(75)
-               = 7
+               = 75                       # requested + used = 75% * available
+               = rawScoringFunction(75) 
+               = 7                        # floor(75/10) 
 
 memory         = resourceScoringFunction((256+256),1024)
                = (100 -((1024-512)*100/1024))
-               = 50
+               = 50                       # requested + used = 50% * available
                = rawScoringFunction(50)
-               = 5
+               = 5                        # floor(50/10)
 
 cpu            = resourceScoringFunction((2+1),8)
                = (100 -((8-3)*100/8))
-               = 37.5
+               = 37.5                     # requested + used = 37.5% * available
                = rawScoringFunction(37.5)
-               = 3
+               = 3                        # floor(37.5/10)
 
 NodeScore   =  (7 * 5) + (5 * 1) + (3 * 3) / (5 + 1 + 3)
             =  5
+```
 
+<!--
+Node 2 spec:
+-->
+节点 2 配置：
 
-节点 Node 2 配置
-
+```
 可用：
   intel.com/foo: 8
   memory: 1GB
@@ -245,9 +316,14 @@ NodeScore   =  (7 * 5) + (5 * 1) + (3 * 3) / (5 + 1 + 3)
   intel.com/foo: 2
   memory: 512MB
   cpu: 6
+```
 
+<!--
+Node score:
+-->
 节点得分：
 
+```
 intel.com/foo  = resourceScoringFunction((2+2),8)
                = (100 - ((8-4)*100/8)
                = (100 - 50)
@@ -270,3 +346,13 @@ cpu            = resourceScoringFunction((2+6),8)
 NodeScore   =  (5 * 5) + (7 * 1) + (10 * 3) / (5 + 1 + 3)
             =  7
 ```
+
+## {{% heading "whatsnext" %}}
+
+<!--
+- Read more about the [scheduling framework](/docs/concepts/scheduling-eviction/scheduling-framework/)
+- Read more about [scheduler configuration](/docs/reference/scheduling/config/)
+-->
+- 继续阅读[调度器框架](/zh-cn/docs/concepts/scheduling-eviction/scheduling-framework/)
+- 继续阅读[调度器配置](/zh-cn/docs/reference/scheduling/config/)
+