Skip to content

Commit f1b44b5

Browse files
authored
Merge pull request #37038 from windsonsea/flocon
[zh] sync flow-control.md
2 parents 4877016 + af5adb1 commit f1b44b5

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

content/zh-cn/docs/concepts/cluster-administration/flow-control.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -262,8 +262,7 @@ text="shuffle sharding" >}}, which makes relatively efficient use of
262262
queues to insulate low-intensity flows from high-intensity flows.
263263
-->
264264
将请求划分到流中之后,APF 功能将请求分配到队列中。
265-
分配时使用一种称为{{< glossary_tooltip term_id="shuffle-sharding" text="混洗分片(Shuffle-Sharding)" >}}
266-
的技术。
265+
分配时使用一种称为{{< glossary_tooltip term_id="shuffle-sharding" text="混洗分片(Shuffle-Sharding)" >}}的技术。
267266
该技术可以相对有效地利用队列隔离低强度流与高强度流。
268267

269268
<!--
@@ -294,32 +293,33 @@ server.
294293
295294
The flow control API involves two kinds of resources.
296295
[PriorityLevelConfigurations](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#prioritylevelconfiguration-v1beta2-flowcontrol-apiserver-k8s-io)
297-
define the available isolation classes, the share of the available concurrency
296+
define the available priority levels, the share of the available concurrency
298297
budget that each can handle, and allow for fine-tuning queuing behavior.
299298
[FlowSchemas](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#flowschema-v1beta2-flowcontrol-apiserver-k8s-io)
300299
are used to classify individual inbound requests, matching each to a
301-
single PriorityLevelConfiguration. There is also a `v1alpha1` version
300+
single PriorityLevelConfiguration. There is also a `v1alpha1` version
302301
of the same API group, and it has the same Kinds with the same syntax and
303302
semantics.
304303
-->
305304
## 资源 {#Resources}
306305

307306
流控 API 涉及两种资源。
308307
[PriorityLevelConfiguration](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#prioritylevelconfiguration-v1beta2-flowcontrol-apiserver-k8s-io)
309-
定义隔离类型和可处理的并发预算量,还可以微调排队行为。
308+
定义可用的优先级和可处理的并发预算量,还可以微调排队行为。
310309
[FlowSchema](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#flowschema-v1beta2-flowcontrol-apiserver-k8s-io)
311310
用于对每个入站请求进行分类,并与一个 PriorityLevelConfiguration 相匹配。
312311
此外同一 API 组还有一个 `v1alpha1` 版本,其中包含语法和语义都相同的资源类别。
313312

314313
<!--
315314
### PriorityLevelConfiguration
316-
A PriorityLevelConfiguration represents a single isolation class. Each
315+
316+
A PriorityLevelConfiguration represents a single priority level. Each
317317
PriorityLevelConfiguration has an independent limit on the number of outstanding
318318
requests, and limitations on the number of queued requests.
319319
-->
320320
### PriorityLevelConfiguration {#PriorityLevelConfiguration}
321321

322-
一个 PriorityLevelConfiguration 表示单个隔离类型。每个 PriorityLevelConfiguration
322+
一个 PriorityLevelConfiguration 表示单个优先级。每个 PriorityLevelConfiguration
323323
对未完成的请求数有各自的限制,对排队中的请求数也有限制。
324324

325325
<!--
@@ -335,7 +335,7 @@ down) by the same fraction.
335335
-->
336336
PriorityLevelConfiguration 的并发限制不是指定请求绝对数量,而是在“并发份额”中指定。
337337
API 服务器的总并发量限制通过这些份额按例分配到现有 PriorityLevelConfiguration 中。
338-
集群管理员可以更改 `--max-requests-inflight` (或 `--max-mutating-requests-inflight` )的值,
338+
集群管理员可以更改 `--max-requests-inflight` (或 `--max-mutating-requests-inflight`)的值,
339339
再重新启动 `kube-apiserver` 来增加或减小服务器的总流量,
340340
然后所有的 PriorityLevelConfiguration 将看到其最大并发增加(或减少)了相同的比例。
341341

@@ -412,7 +412,7 @@ priority level. Details of the algorithm can be read in the
412412
较大的 `handSize` 使两个单独的流程发生碰撞的可能性较小(因此,一个流可以饿死另一个流),
413413
但是更有可能的是少数流可以控制 apiserver。
414414
较大的 `handSize` 还可能增加单个高并发流的延迟量。
415-
单个流中可能排队的请求的最大数量为 `handSize * queueLengthLimit`
415+
单个流中可能排队的请求的最大数量为 `handSize * queueLengthLimit`
416416
{{< /note >}}
417417

418418
<!--
@@ -531,7 +531,7 @@ guardrail behavior. This is behavior that the servers have before
531531
those objects exist, and when those objects exist their specs reflect
532532
this behavior. The four mandatory objects are as follows.
533533
-->
534-
### 强制的配置对象
534+
### 强制的配置对象 {#mandatory-configuration-objects}
535535

536536
有四种强制的配置对象对应内置的守护行为。这里的行为是服务器在还未创建对象之前就具备的行为,
537537
而当这些对象存在时,其规约反映了这类行为。四种强制的对象如下:
@@ -577,7 +577,7 @@ configuration will work best.
577577
578578
The suggested configuration groups requests into six priority levels:
579579
-->
580-
### 建议的配置对象
580+
### 建议的配置对象 {#suggested-configuration-objects}
581581

582582
建议的 FlowSchema 和 PriorityLevelConfiguration 包含合理的默认配置。
583583
你可以修改这些对象或者根据需要创建新的配置对象。如果你的集群可能承受较重负载,
@@ -644,7 +644,7 @@ Thus, in a situation with a mixture of servers of different versions
644644
there may be thrashing as long as different servers have different
645645
opinions of the proper content of these objects.
646646
-->
647-
### 强制的与建议的配置对象的维护
647+
### 强制的与建议的配置对象的维护 {#maintenance-of-the-mandatory-and-suggested-configuration-objects}
648648

649649
每个 `kube-apiserver` 都独立地维护其强制的与建议的配置对象,
650650
这一维护操作既是服务器的初始行为,也是其周期性操作的一部分。
@@ -925,7 +925,7 @@ poorly-behaved workloads that may be harming system health.
925925
* `apiserver_flowcontrol_read_vs_write_request_count_watermarks` 是一个直方图向量,
926926
记录请求数量的高/低水位线,
927927
由标签 `phase`(取值为 `waiting``executing`)和 `request_kind`
928-
(取值为 `mutating``readOnly`)拆分;标签 `mark` 取值为 `high``low`
928+
(取值为 `mutating``readOnly`)拆分;标签 `mark` 取值为 `high``low`
929929
`apiserver_flowcontrol_read_vs_write_request_count_samples` 向量观察到有值新增,
930930
则该向量累积。这些水位线显示了样本值的范围。
931931

0 commit comments

Comments
 (0)