Merge pull request #51378 from my-git9/npa-26073

[zh-cn]sync/improve cri apiserver-eventratelimit.v1alpha1

Author: k8s-ci-robot

content/zh-cn/docs/concepts/architecture/cri.md

@@ -3,7 +3,6 @@ title: 容器运行时接口（CRI）
 content_type: concept
 weight: 60
 ---
-
 <!-- 
 title: Container Runtime Interface (CRI)
 content_type: concept
@@ -27,9 +26,13 @@ CRI 是一个插件接口，它使 kubelet 能够使用各种容器运行时，
 这样 {{< glossary_tooltip text="kubelet" term_id="kubelet" >}} 能启动
 {{< glossary_tooltip text="Pod" term_id="pod" >}} 及其容器。
 
+<!--
+{{< glossary_definition prepend="The Container Runtime Interface (CRI) is" term_id="cri" length="all" >}}
+-->
 {{< glossary_definition prepend="容器运行时接口（CRI）是" term_id="cri" length="all" >}}
 
 <!-- body -->
+
 <!--
 ## The API {#api}
 -->
@@ -46,7 +49,8 @@ runtime, which can be configured separately within the kubelet by using the
 -->
 当通过 gRPC 连接到容器运行时，kubelet 将充当客户端。运行时和镜像服务端点必须在容器运行时中可用，
 可以使用 `--container-runtime-endpoint`
-[命令行标志](/zh-cn/docs/reference/command-line-tools-reference/kubelet)在 kubelet 中单独配置。
+[命令行标志](/zh-cn/docs/reference/command-line-tools-reference/kubelet)在
+kubelet 中单独配置。
 
 <!-- 
 For Kubernetes v1.26 and later, the kubelet requires that the container runtime
@@ -71,12 +75,13 @@ container runtime is correctly configured.
 
 在节点上升级 Kubernetes 版本时，kubelet 会重新启动。
 如果容器运行时不支持 `v1` 版本的 CRI API，kubelet 将无法注册节点并报告错误。
-如果由于容器运行时已升级而需要重新建立 gRPC 连接，则该容器运行时必须支持 v1 版本的 CRI API，连接才能成功。
+如果由于容器运行时已升级而需要重新建立 gRPC 连接，
+则该容器运行时必须支持 v1 版本的 CRI API，连接才能成功。
 在容器运行时正确配置后，可能需要重新启动 kubelet 才能建立连接。
 
 ## {{% heading "whatsnext" %}}
 
 <!-- 
-- Learn more about the CRI [protocol definition](https://github.com/kubernetes/cri-api/blob/c75ef5b/pkg/apis/runtime/v1/api.proto)
+- Learn more about the CRI [protocol definition](https://github.com/kubernetes/cri-api/blob/v0.33.1/pkg/apis/runtime/v1/api.proto)
 -->
 - 了解更多有关 CRI [协议定义](https://github.com/kubernetes/cri-api/blob/v0.33.1/pkg/apis/runtime/v1/api.proto)

content/zh-cn/docs/reference/config-api/apiserver-eventratelimit.v1alpha1.md

@@ -13,11 +13,13 @@ package: eventratelimit.admission.k8s.io/v1alpha1
 
 ## `Configuration`     {#eventratelimit-admission-k8s-io-v1alpha1-Configuration}
 
+<p>
 <!--
-<p>Configuration provides configuration for the EventRateLimit admission
-controller.</p>
+Configuration provides configuration for the EventRateLimit admission
+controller.
 -->
-<p>Configuration 为 EventRateLimit 准入控制器提供配置数据。</p>
+Configuration 为 EventRateLimit 准入控制器提供配置数据。
+</p>
 
 <table class="table">
 <thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@@ -26,19 +28,21 @@ controller.</p>
 <tr><td><code>apiVersion</code><br/>string</td><td><code>eventratelimit.admission.k8s.io/v1alpha1</code></td></tr>
 <tr><td><code>kind</code><br/>string</td><td><code>Configuration</code></td></tr>
 
-<tr><td><code>limits</code> <B>[Required]</B><br/>
+<tr><td><code>limits</code> <B><!--[Required]-->[必需]</B><br/>
 <a href="#eventratelimit-admission-k8s-io-v1alpha1-Limit"><code>[]Limit</code></a>
 </td>
 <td>
+  <p>
   <!--
-   <p>limits are the limits to place on event queries received.
+  limits are the limits to place on event queries received.
 Limits can be placed on events received server-wide, per namespace,
 per user, and per source+object.
-At least one limit is required.</p>
+At least one limit is required.
   -->
-  <p>limits 是为所接收到的事件查询设置的限制。可以针对服务器端接收到的事件设置限制，
+  <code>limits</code> 是为所接收到的事件查询设置的限制。可以针对服务器端接收到的事件设置限制，
 按逐个名字空间、逐个用户、或逐个来源+对象组合的方式均可以。
-至少需要设置一种限制。</p>
+至少需要设置一种限制。
+  </p>
 </td>
 </tr>
 </tbody>
@@ -53,10 +57,12 @@ At least one limit is required.</p>
 
 - [Configuration](#eventratelimit-admission-k8s-io-v1alpha1-Configuration)
 
+<p>
 <!--
-<p>Limit is the configuration for a particular limit type</p>
+Limit is the configuration for a particular limit type
 -->
-<p>Limit 是为特定限制类型提供的配置数据。</p>
+<code>Limit</code> 是为特定限制类型提供的配置数据。
+</p>
 
 <table class="table">
 <thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
@@ -66,33 +72,38 @@ At least one limit is required.</p>
 <a href="#eventratelimit-admission-k8s-io-v1alpha1-LimitType"><code>LimitType</code></a>
 </td>
 <td>
-  <!--
-   <p>type is the type of limit to which this configuration applies</p>
-  -->
-  <p>type 是此配置所适用的限制的类型。</p>
+<p>
+<!--
+type is the type of limit to which this configuration applies
+-->
+<code>type</code> 是此配置所适用的限制的类型。
+</p>
 </td>
 </tr>
 <tr><td><code>qps</code> <B><!--[Required]-->[必需]</B><br/>
 <code>int32</code>
 </td>
 <td>
+  <p>
   <!--
-   <p>qps is the number of event queries per second that are allowed for this
+  qps is the number of event queries per second that are allowed for this
 type of limit. The qps and burst fields are used together to determine if
 a particular event query is accepted. The qps determines how many queries
-are accepted once the burst amount of queries has been exhausted.</p>
+are accepted once the burst amount of queries has been exhausted.
   -->
-   <p>qps 是针对此类型的限制每秒钟所允许的事件查询次数。qps 和 burst
+  <code>qps</code> 是针对此类型的限制每秒钟所允许的事件查询次数。qps 和 burst
 字段一起用来确定是否特定的事件查询会被接受。qps 确定的是当超出查询数量的
-burst 值时可以接受的查询个数。</p>
+burst 值时可以接受的查询个数。
+  </p>
 </td>
 </tr>
 <tr><td><code>burst</code> <B><!--[Required]-->[必需]</B><br/>
 <code>int32</code>
 </td>
 <td>
+  <p>
   <!--
-   <p>burst is the burst number of event queries that are allowed for this type
+  burst is the burst number of event queries that are allowed for this type
 of limit. The qps and burst fields are used together to determine if a
 particular event query is accepted. The burst determines the maximum size
 of the allowance granted for a particular bucket. For example, if the burst
@@ -101,31 +112,42 @@ before blocking any queries. Every second, 3 more queries will be allowed.
 If some of that allowance is not used, then it will roll over to the next
 second, until the maximum allowance of 10 is reached.</p>
   -->
-   <p>burst 是针对此类型限制的突发事件查询数量。qps 和 burst 字段一起使用可用来确定特定的事件查询是否被接受。
+  burst 是针对此类型限制的突发事件查询数量。qps 和 burst 字段一起使用可用来确定特定的事件查询是否被接受。
 burst 字段确定针对特定的事件桶（bucket）可以接受的规模上限。
 例如，如果 burst 是 10，qps 是 3，那么准入控制器会在接收 10 个查询之后阻塞所有查询。
 每秒钟可以额外允许 3 个查询。如果这一限额未被用尽，则剩余的限额会被顺延到下一秒钟，
-直到再次达到 10 个限额的上限。</p>
+直到再次达到 10 个限额的上限。
+  </p>
 </td>
 </tr>
 <tr><td><code>cacheSize</code><br/>
 <code>int32</code>
 </td>
 <td>
+  <p>
   <!--
-   <p>cacheSize is the size of the LRU cache for this type of limit. If a bucket
+  cacheSize is the size of the LRU cache for this type of limit. If a bucket
 is evicted from the cache, then the allowance for that bucket is reset. If
 more queries are later received for an evicted bucket, then that bucket
 will re-enter the cache with a clean slate, giving that bucket a full
-allowance of burst queries.</p>
-<p>The default cache size is 4096.</p>
-<p>If limitType is 'server', then cacheSize is ignored.</p>
+allowance of burst queries.
   -->
-   <p>cacheSize 是此类型限制的 LRU 缓存的规模。如果某个事件桶（bucket）被从缓存中剔除，
+  <code>cacheSize</code> 是此类型限制的 LRU 缓存的规模。如果某个事件桶（bucket）被从缓存中剔除，
 该事件桶所对应的限额也会被重置。如果后来再次收到针对某个已被剔除的事件桶的查询，
-则该事件桶会重新以干净的状态进入缓存，因而获得全量的突发查询配额。</p>
-  <p>默认的缓存大小是 4096。</p>
-  <p>如果 limitType 是 “server”，则 cacheSize 设置会被忽略。</p>
+则该事件桶会重新以干净的状态进入缓存，因而获得全量的突发查询配额。
+  </p>
+<p>
+<!--
+The default cache size is 4096.
+-->
+默认的缓存大小是 4096。
+</p>
+<p>
+<!--
+If limitType is 'server', then cacheSize is ignored.
+-->
+如果 limitType 是 “server”，则 cacheSize 设置会被忽略。
+</p>
 </td>
 </tr>
 </tbody>
@@ -144,9 +166,9 @@ allowance of burst queries.</p>
 
 - [Limit](#eventratelimit-admission-k8s-io-v1alpha1-Limit)
 
+<p>
 <!--
-<p>LimitType is the type of the limit (e.g., per-namespace)</p>
+LimitType is the type of the limit (e.g., per-namespace)
 -->
-<p>LimitType 是限制类型（例如：per-namespace）。</p>
-
-
+<code>LimitType</code> 是限制类型（例如：per-namespace，即按命名空间限制）。
+</p>