[zh-cn]sync runtime-class-v1

Signed-off-by: xin.li <xin.li@daocloud.io>

Author: my-git9

content/zh-cn/docs/reference/kubernetes-api/cluster-resources/runtime-class-v1.md

@@ -19,18 +19,20 @@ title: "RuntimeClass"
 weight: 9
 auto_generated: true
 -->
+
 `apiVersion: node.k8s.io/v1`
 
 `import "k8s.io/api/node/v1"`
 
 ## RuntimeClass {#RuntimeClass}
+
 <!--
 RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod. For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
 -->
 RuntimeClass 定义集群中支持的容器运行时类。
 RuntimeClass 用于确定哪个容器运行时用于运行某 Pod 中的所有容器。
 RuntimeClass 由用户或集群制备程序手动定义，并在 PodSpec 中引用。
-Kubelet 负责在运行 Pod 之前解析 RuntimeClassName 引用。
+kubelet 负责在运行 Pod 之前解析 RuntimeClassName 引用。
 有关更多详细信息，请参阅
 https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 
@@ -54,10 +56,10 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 
 - **handler** (string)，必需
 
- handler 指定底层运行时和配置，在 CRI 实现过程中将使用这些运行时和配置来处理这个类的 Pod。
+ `handler` 指定底层运行时和配置，在 CRI 实现过程中将使用这些运行时和配置来处理这个类的 Pod。
  可能的值特定于节点和 CRI 配置。
  假定所有 handler 可用于每个节点上，且同一名称的 handler 在所有节点上是等效的。
- 例如，一个名为 “runc” 的 handler 可能指定 runc OCI 运行时将（使用原生 Linux 容器）
+ 例如，一个名为 "runc" 的 handler 可能指定 runc OCI 运行时将（使用原生 Linux 容器）
  用于运行 Pod 中的容器。该 handler 必须采用小写，遵从 DNS Label (RFC 1123) 要求，且是不可变更的。
 
 <!--
@@ -70,7 +72,7 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 -->
 - **overhead** (Overhead)
 
- overhead 表示运行给定 RuntimeClass 的 Pod 时所关联的资源开销。有关更多详细信息，请参阅
+ `overhead` 表示运行给定 RuntimeClass 的 Pod 时所关联的资源开销。有关更多详细信息，请参阅
  https://kubernetes.io/zh-cn/docs/concepts/scheduling-eviction/pod-overhead/
 
  <a name="Overhead"></a>
@@ -84,7 +86,7 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 
  - **overhead.podFixed** (map[string]<a href="{{< ref "../common-definitions/quantity#Quantity" >}}">Quantity</a>)
 
- podFixed 表示与运行一个 Pod 所关联的资源开销。
+ `podFixed` 表示与运行一个 Pod 所关联的资源开销。
 
 <!--
 - **scheduling** (Scheduling)
@@ -95,8 +97,9 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 -->
 - **scheduling** (Scheduling)
 
- scheduling 包含调度约束，这些约束用来确保以这个 RuntimeClass 运行的 Pod 被调度到支持此运行时类的节点。
- 如果 scheduling 设为空，则假定所有节点支持此 RuntimeClass。
+ `scheduling` 包含调度约束，这些约束用来确保以这个 RuntimeClass 运行的
+ Pod 被调度到支持此运行时类的节点。
+ 如果 `scheduling` 设为空，则假定所有节点支持此 RuntimeClass。
 
  <a name="Scheduling"></a>
  **Scheduling 指定支持 RuntimeClass 的节点的调度约束。**
@@ -108,9 +111,9 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 
  - **scheduling.nodeSelector** (map[string]string)
 
- nodeSelector 列出支持此 RuntimeClass 的节点上必须存在的标签。
+ `nodeSelector` 列出支持此 RuntimeClass 的节点上必须存在的标签。
  使用此 RuntimeClass 的 Pod 只能调度到与这个选择算符匹配的节点上。
- RuntimeClass nodeSelector 与 Pod 现有的 nodeSelector 合并。
+ RuntimeClass `nodeSelector` 与 Pod 现有的 `nodeSelector` 合并。
  任何冲突均会使得该 Pod 在准入时被拒绝。
 
  <!--
@@ -127,57 +130,82 @@ https://kubernetes.io/zh-cn/docs/concepts/containers/runtime-class/
 
  **原子性：将在合并期间被替换**
 
- tolerations 在准入期间追加到以此 RuntimeClass 运行的 Pod（不包括重复项）上，
+ `tolerations` 在准入期间追加到以此 RuntimeClass 运行的 Pod（不包括重复项）上，
  本质上是求取 Pod 和 RuntimeClass 所容忍的节点并集。
 
  <a name="Toleration"></a>
  **附加此容忍度的 Pod 将容忍用匹配运算符 `operator` 运算后与三元组
- `<key,value,effect>` 匹配的任何污点。**
+ `<key,value,effect>` 匹配的任意污点。**
 
  <!--
  - **scheduling.tolerations.key** (string)
  Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
 
  - **scheduling.tolerations.operator** (string)
  Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.
+
+ Possible enum values:
+ - `"Equal"`
+ - `"Exists"
  -->
 
  - **scheduling.tolerations.key** (string)
 
- key 是容忍度所应用到的污点键。空意味着匹配所有污点键。
- 如果键为空，则运算符必须为 Exists；这个组合意味着匹配所有值和所有键。
+ `key` 是容忍度所应用到的污点键。空意味着匹配所有污点键。
+ 如果键为空，则运算符必须为 `Exists`；这个组合意味着匹配所有值和所有键。
 
  - **scheduling.tolerations.operator** (string)
 
- operator 表示一个键与值的关系。有效的运算符为 Exists 和 Equal。默认为 Equal。
- Exists 等价于将值设置为通配符的情况，因此一个 Pod 可以容忍特定类别的所有污点。
+ `operator` 表示一个键与值的关系。有效的运算符为 `Exists` 和 `Equal`。默认为 `Equal`。
+ `Exists` 等价于将值设置为通配符的情况，因此一个 Pod 可以容忍特定类别的所有污点。
+
+ 可能的枚举值：
+ 
+ - `"Equal"`
+ - `"Exists"`
 
  <!--
  - **scheduling.tolerations.value** (string)
  Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
 
  - **scheduling.tolerations.effect** (string)
  Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
+
+ Possible enum values:
+ - `"NoExecute"` Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController.
+ - `"NoSchedule"` Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.
+ - `"PreferNoSchedule"` Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.
  
  - **scheduling.tolerations.tolerationSeconds** (int64)
  TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system.
  -->
 
  - **scheduling.tolerations.value** (string)
 
- value 是容忍度匹配到的污点值。如果运算符为 Exists，则值应为空，否则就是一个普通字符串。
+ `value` 是容忍度匹配到的污点值。如果运算符为 `Exists`，则值应为空，否则就是一个普通字符串。
 
  - **scheduling.tolerations.effect** (string)
 
- effect 表示匹配度污点效果。空意味着匹配所有污点效果。
- 当指定值时，允许的值为 NoSchedule、PreferNoSchedule 或 NoExecute。
+ `effect` 表示匹配度污点效果。空意味着匹配所有污点效果。
+ 当指定值时，允许的值为 `NoSchedule`、`PreferNoSchedule` 或 `NoExecute`。
+
+ 可能的枚举值：
+ 
+ - `"NoExecute"` 驱逐已经在运行且不容忍污点的所有 Pod。
+ 当前由 NodeController 执行。
+ - `"NoSchedule"` 不允许新的 Pod 调度到该节点上，除非它们容忍此污点，
+ 但允许所有直接提交给 kubelet 而不经过调度器的 Pod 启动，
+ 并允许所有已经在运行的 Pod 继续运行。由调度器执行。
+ - `"PreferNoSchedule"` 类似于 `NoSchedule`，但是调度器尝试避免将新 Pod 
+ 调度到该节点上，而不是完全禁止新 Pod 调度到节点。由调度器执行。
 
  - **scheduling.tolerations.tolerationSeconds** (int64)
 
- tolerationSeconds 表示容忍度容忍污点的时间段（必须是 NoExecute 的效果，否则忽略此字段）。
+ `tolerationSeconds` 表示容忍度容忍污点的时间段（必须是 NoExecute 的效果，否则忽略此字段）。
  默认情况下，不设置此字段，这意味着永远容忍污点（不驱逐）。零和负值将被系统视为 0（立即驱逐）。
 
 ## RuntimeClassList {#RuntimeClassList}
+
 <!--
 RuntimeClassList is a list of RuntimeClass objects.
 -->
@@ -203,18 +231,21 @@ RuntimeClassList 是 RuntimeClass 对象的列表。
 
 - **items** ([]<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>)，必需
 
- items 是 schema 对象的列表。
+ `items` 是 schema 对象的列表。
 
 <!--
 ## Operations {#Operations}
 ### `get` read the specified RuntimeClass
 #### HTTP Request
 -->
 ## 操作 {#Operations}
+
 <hr>
 
 ### `get` 读取指定的 RuntimeClass
+
 #### HTTP 请求
+
 GET /apis/node.k8s.io/v1/runtimeclasses/{name}
 
 <!--
@@ -224,9 +255,10 @@ GET /apis/node.k8s.io/v1/runtimeclasses/{name}
 - **pretty** (*in query*): string
 -->
 ##### 参数
+
 - **name** (**路径参数**): string，必需
 
- RuntimeClass 的名称
+ RuntimeClass 的名称。
 
 - **pretty** (**查询参数**): string
 
@@ -236,6 +268,7 @@ GET /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): OK
 
 401: Unauthorized
@@ -245,7 +278,9 @@ GET /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### HTTP Request
 -->
 ### `list` 列出或监视 RuntimeClass 类别的对象
+
 #### HTTP 请求
+
 GET /apis/node.k8s.io/v1/runtimeclasses
 
 <!--
@@ -263,6 +298,7 @@ GET /apis/node.k8s.io/v1/runtimeclasses
 - **watch** (*in query*): boolean
 -->
 ##### 参数
+
 - **allowWatchBookmarks** (**查询参数**): boolean
 
  <a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks</a>
@@ -311,6 +347,7 @@ GET /apis/node.k8s.io/v1/runtimeclasses
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClassList" >}}">RuntimeClassList</a>): OK
 
 401: Unauthorized
@@ -320,8 +357,11 @@ GET /apis/node.k8s.io/v1/runtimeclasses
 #### HTTP Request
 -->
 ### `create` 创建 RuntimeClass
+
 #### HTTP 请求
+
 POST /apis/node.k8s.io/v1/runtimeclasses
+
 <!--
 #### Parameters
 - **body**: <a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>, required
@@ -331,6 +371,7 @@ POST /apis/node.k8s.io/v1/runtimeclasses
 - **pretty** (*in query*): string
 -->
 ##### 参数
+
 - **body**: <a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>，必需
 
 - **dryRun** (**查询参数**): string
@@ -353,6 +394,7 @@ POST /apis/node.k8s.io/v1/runtimeclasses
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): OK
 
 201 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): Created
@@ -366,7 +408,9 @@ POST /apis/node.k8s.io/v1/runtimeclasses
 #### HTTP Request
 -->
 ### `update` 替换指定的 RuntimeClass
+
 #### HTTP 请求
+
 PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
 
 <!--
@@ -380,6 +424,7 @@ PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
 - **pretty** (*in query*): string
 -->
 ##### 参数
+
 - **name** (**路径参数**): string，必需
 
  RuntimeClass 的名称
@@ -406,6 +451,7 @@ PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): OK
 
 201 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): Created
@@ -417,7 +463,9 @@ PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### HTTP Request
 -->
 ### `patch` 部分更新指定的 RuntimeClass
+
 #### HTTP 请求
+
 PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
 
 <!--
@@ -432,6 +480,7 @@ PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
 - **pretty** (*in query*): string
 -->
 ##### 参数
+
 - **name** (**路径参数**): string，必需
 
  RuntimeClass 的名称
@@ -462,6 +511,7 @@ PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): OK
 
 201 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): Created
@@ -473,7 +523,9 @@ PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### HTTP Request
 -->
 ### `delete` 删除 RuntimeClass
+
 #### HTTP 请求
+
 DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
 
 <!--
@@ -488,6 +540,7 @@ DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
 - **propagationPolicy** (*in query*): string
 -->
 ##### 参数
+
 - **name** (**路径参数**): string，必需
 
  RuntimeClass 的名称
@@ -518,6 +571,7 @@ DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
 
 202 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): Accepted
@@ -529,7 +583,9 @@ DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
 #### HTTP Request
 -->
 ### `deletecollection` 删除 RuntimeClass 的集合
+
 #### HTTP 请求
+
 DELETE /apis/node.k8s.io/v1/runtimeclasses
 
 <!--
@@ -550,6 +606,7 @@ DELETE /apis/node.k8s.io/v1/runtimeclasses
 - **timeoutSeconds** (*in query*): integer
 -->
 ##### 参数
+
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 
 - **continue** (**查询参数**): string
@@ -608,6 +665,7 @@ DELETE /apis/node.k8s.io/v1/runtimeclasses
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
 
 401: Unauthorized