7장. PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1]

제외

object

ExemptPriorityLevelConfiguration은 예외 요청 처리의 구성 가능한 측면을 설명합니다. 필수 제외 구성 개체에서 여기에 있는 필드의 값은 나머지 사양 과 달리 권한 있는 사용자가 수정할 수 있습니다.

제한됨

object

LimitedPriorityLevelConfiguration은 제한에 따라 요청을 처리하는 방법을 지정합니다. 두 가지 문제를 해결했습니다. - 이 우선 순위 수준에 대한 요청은 어떻게 제한됩니까? - 제한을 초과하는 요청으로 어떻게 해야 합니까?

type

string

type 은 이 우선순위 수준이 요청 실행 시 제한될 수 있는지 여부를 나타냅니다. "Exempt" 값은 이 우선순위 수준의 요청이 제한의 영향을 받지 않고 다른 우선 순위 수준에서 사용 가능한 용량에서 중단되지 않음을 의미합니다. "제한된" 값은 (a) 이 우선 순위 수준의 요청에 제한이 적용되며 (b) 서버의 제한된 용량 중 일부를 이 우선 순위 수준에서 독점적으로 사용할 수 있음을 의미합니다. 필수 항목입니다.

lendablePercent

integer

lendablePercent 는 다른 우선 순위 수준에서 빌릴 수 있는 수준의 NominalCL의 일부를 규정합니다. 이 필드의 값은 0에서 100 사이여야 하며 기본값은 0입니다. 이 수준의 LendableConcurrencyLimit (LendableConcurrencyLimit)으로 알려진 이 수준에서 다른 수준이 빌릴 수 있는 자리 수는 다음과 같이 정의됩니다.

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

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS)는 이 수준의 NominalConcurrencyLimit (NominalConcurrencyLimit) 계산에 기여합니다. 이는 이 우선 순위 수준에 대해 임시로 예약된 실행소 수입니다. 이는 이 우선 순위 수준에서의 디스패치를 제한하지는 않지만 차용 메커니즘을 통해 다른 우선 순위 수준에 영향을 미칩니다. 서버의 동시성 제한(ServerCL)은 자신의 CryostatS 값에 비례하여 모든 우선순위 레벨로 나뉩니다.

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

숫자가 클수록 다른 모든 우선 순위 수준을 희생하여 더 큰 nominal concurrency 제한을 의미합니다. 이 필드의 기본값은 0입니다.

borrowingLimitPercent

integer

borrowingLimitPercent 가 있는 경우, 이 우선순위 수준이 다른 우선 순위 수준에서 빌릴 수 있는 이 우선순위 등급의 수에 대한 제한을 구성합니다. 제한은 이 수준의 BorrowingConcurrencyLimit (BorrowingConcurrencyLimit)이라고 하며, 이 수준이 언제든지 빌릴 수 있는 총 seat 수에 대한 제한입니다. 이 필드에는 수준의 nominal 동시성 제한에 대한 해당 제한 비율이 있습니다. 이 필드가 음수가 아닌 경우 음수가 아닌 정수를 유지해야 하며 제한은 다음과 같이 계산됩니다.

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

이 필드의 값은 100을 초과할 수 있습니다. 즉, 이 우선순위 수준이 자체 nominal concurrency limit(NominalCL)보다 큰 여러 개의 seat을 빌릴 수 있습니다. 이 필드가 nil 을 남겨 두면 제한이 효과적으로 무한합니다.

lendablePercent

integer

lendablePercent 는 다른 우선 순위 수준에서 빌릴 수 있는 수준의 NominalCL의 일부를 규정합니다. 이 필드의 값은 0에서 100 사이여야 하며 기본값은 0입니다. 이 수준의 LendableConcurrencyLimit (LendableConcurrencyLimit)으로 알려진 이 수준에서 다른 수준이 빌릴 수 있는 자리 수는 다음과 같이 정의됩니다.

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

limitResponse

object

LimitResponse는 현재 실행할 수 없는 요청을 처리하는 방법을 정의합니다.

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS)는 이 수준의 NominalConcurrencyLimit (NominalConcurrencyLimit) 계산에 기여합니다. 이 우선 순위 수준에서 사용할 수 있는 실행소의 수입니다. 이는 이 우선순위 수준에서 디스패치된 요청과 다른 우선 순위의 차용지에서 디스패치된 요청에도 사용됩니다. 서버의 동시성 제한(ServerCL)은 자신의 CryostatS 값에 비례하여 제한적인 우선 순위 수준으로 나뉩니다.

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

숫자가 클수록 다른 모든 우선 순위 수준을 희생하여 더 큰 nominal concurrency 제한을 의미합니다.

지정하지 않으면 이 필드는 기본값은 30입니다.

이 필드를 0으로 설정하면 일부 요청을 보유하는 데 사용되는 이 우선 순위 수준에 대한 "jail"의 구성이 지원됩니다.

Queuing

object

QueuingConfiguration에는 큐링을 위한 구성 매개변수가 포함되어 있습니다.

type

string

type 은 "Queue" 또는 "Reject"입니다. "queue"는 도착 시 실행할 수 없는 요청이 실행되거나 큐잉 제한에 도달할 때까지 큐에 보관됩니다. "거부"는 도착 시 실행할 수 없는 요청이 거부됩니다. 필수 항목입니다.

handSize

integer

handSize 는 요청을 큐로 분할하는 작은 양의 숫자입니다. 이 우선 순위 수준에서 요청을 큐에 추가할 때 요청의 흐름 식별자(문자열 쌍)가 해시되고 해시 값은 대기열 목록을 축소하고 여기에 지정된 크기의 핸드를 처리하는 데 사용됩니다. 요청은 가장 짧은 대기열 중 하나에 배치됩니다. handSize 는 대기열 보다 커야 하며, 몇 개의 과도한 흐름이 대부분의 큐를 포화하지 않도록 해야 합니다. 이 필드 설정에 대한 보다 광범위한 지침은 사용자용 설명서를 참조하십시오. 이 필드의 기본값은 8입니다.

queueLengthLimit

integer

queueLengthLimit 은 한 번에 이 우선순위 수준의 지정된 큐에서 대기할 수 있는 최대 요청 수입니다. 이 값은 양수여야 합니다. 지정하지 않으면 기본값은 50입니다.

대기열

integer

큐 는 이 우선 순위 수준의 대기열 수입니다. 큐는 각 apiserver마다 독립적으로 존재합니다. 값은 양수여야 합니다. 이를 1로 효과적으로 설정하면 shufflesharding이 방지되므로 관련 흐름 스키마의 고유 방법이 중요하지 않습니다. 이 필드의 기본값은 64입니다.

conditions

array

conditions 는 "request-priority"의 현재 상태입니다.

conditions[]

object

PriorityLevelConfigurationCondition은 우선순위 수준의 조건을 정의합니다.

lastTransitionTime

시간

lastTransitionTime 은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다.

message

string

message 는 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

이유는 조건의 마지막 전환에 대한 고유한 한 단어, CamelCase 이유입니다.

status

string

Status 는 조건의 상태입니다. True, False, 알 수 없음 필수 항목입니다.

type

string

type 은 조건의 유형입니다. 필수 항목입니다.