第 7 章 PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1beta3]

exempt

object

ExemptPriorityLevelConfiguration 描述了处理 exempt 请求的可配置方面。在强制 exempt 配置中，字段中的值可由授权用户修改，这与 spec 的其余部分不同。

有限

对象

LimitedPriorityLevelConfiguration 指定如何处理受限制的请求。它解决了两个问题： - 此优先级级别的请求如何限制？- 应该对超过限制的请求执行什么操作？

type

字符串

type 表示此优先级级别是否受到请求执行的限制。"Exempt" 值表示此优先级级别的请求不会受到限制（因此永远不会被排队），且不会从容量中分离其他优先级级别。"Limited" 值表示(a)此优先级级别的请求会受到限制，(b)一些服务器的有限容量只可用于这个优先级级别。必需。

lendablePercent

整数

LendablePercent 规定了级别 NominalCL 的比例，这些部分可由其他优先级级别进行计费。此字段的值必须介于 0 到 100 之间，且默认为 0。其他级别可以从这个级别浏览（称为这个级别的 LendableConcurrencyLimit (LendableCL)的数量），具体定义如下。

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

nominalConcurrencyShares

整数

nominalConcurrencyShares (NCS)向计算这个级别的 NominalConcurrencyLimit (NominalCL)贡献。这是为这个优先级级别保留的执行席数。这不会限制这个优先级级别的分配，但会影响其他优先级级别，通过借权机制来影响其他优先级级别。服务器的并发限制(ServerCL)被划分到其 NCS 值的所有优先级级别中：

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

较大的数字意味着一个更大的 nominal 并发限制，但会牺牲其他优先级级别。此字段的默认值为 0。

borrowingLimitPercent

整数

如果存在，borrowingLimitPercent 配置了这个优先级级别的限制，这个优先级级别可以从其他优先级级别进行计费。这个限制被称为这个级别的 BorrowingConcurrencyLimit (BorrowingCL)，它是这个级别可能在任何一个时间可以有界限的限制。此字段包含该限值与级别的 nominal concurrency 限制的比例。当此字段不是nil 时，它必须保留一个非负整数，并且限制按照如下所示计算：

BorrowingCL(i) = round( NominalCL(i) * borrowingLimitPercent(i)/100.0 )

此字段的值可能大于 100，这意味着此优先级级别可以借此优先级数量大于其自身的 nominal concurrency 限制(NominalCL)。当此字段保留为 nil 时，限制有效无限。

lendablePercent

整数

LendablePercent 规定了级别 NominalCL 的比例，这些部分可由其他优先级级别进行计费。此字段的值必须介于 0 到 100 之间，且默认为 0。其他级别可以从这个级别浏览（称为这个级别的 LendableConcurrencyLimit (LendableCL)的数量），具体定义如下。

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

limitResponse

对象

LimitResponse 定义如何处理现在无法执行的请求。

nominalConcurrencyShares

整数

nominalConcurrencyShares (NCS)向计算这个级别的 NominalConcurrencyLimit (NominalCL)贡献。这是此优先级级别上提供的执行席数。这用于从此优先级级别发送的请求，以及从其他优先级级别发送的请求（从这个级别借位）。服务器的并发限制(ServerCL)被划分成其 NCS 值的有限优先级级别：

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

较大的数字意味着一个更大的 nominal 并发限制，但会牺牲其他优先级级别。此字段的默认值为 30。

排队

对象

QueuingConfiguration 包含排队的配置参数

type

字符串

type 为 "Queue" 或 "Reject"。"queue"表示无法在 arrival 上执行的请求，直到请求被执行或到达排队限制。"reject"意味着在 arrival 上无法执行的请求将被拒绝。必需。

handSize

整数

handSize 是一个小的正数，它将请求分片配置为队列。当以此优先级排序请求时，请求的流标识符（字符串对）会被哈希处理，哈希值用于影响队列列表和处理此处指定大小的几个大小。该请求被放入该手动中最短队列中的一个中。handSize 不得大于 队列，并且应该显著降低（因此，一些重度流不会饱和大多数队列）。有关设置此字段的更广泛的指导信息，请参阅面向用户的文档。此字段的默认值为 8。

queueLengthLimit

整数

queueLengthLimit 是允许在这个优先级级别的给定队列中等待的最大请求数；过量请求将被拒绝。这个值必须是正数。如果没有指定，则默认为 50。

队列

整数

队列 是此优先级级别的队列数量。队列在每个 apiserver 中独立存在。该值必须是 positive。将它设置为 1 有效地阻止了 shufflesharding，因此使得相关流模式的区分方式不相关。此字段的默认值为 64。

conditions

array

条件 是 "request-priority" 的当前状态。

conditions[]

对象

PriorityLevelConfigurationCondition 定义优先级级别的条件。

lastTransitionTime

时间

lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。

message

字符串

Message 是人类可读的消息，表示有关最后一次转换的详细信息。

reason

字符串

reason 是条件最后一次转换的唯一一词 CamelCase 原因。

status

字符串

status 是条件的状态。可以是 True, False, Unknown。必需。

type

字符串

type 是条件的类型。必需。