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

exempt

object

ExemptPriorityLevelConfiguration は、免除要求の処理の設定可能な側面を説明します。必須の免除設定オブジェクトでは、spec の残りの部分とは異なり、ここのフィールドの値は承認されたユーザーによって変更できます。

非常に限定される

object

LimitedPriorityLevelConfiguration は、制限の対象となる要求を処理する方法を指定します。これは、- この優先レベルのリクエストはどのように制限されますか? - 制限を超えたリクエストはどうすればよいですか? という、2 つの問題に対処します。

type

string

type は、この優先度レベルがリクエストの実行に制限を受けるかどうかを示します。"Exempt" の値は、この優先度レベルの要求が制限の対象ではなく (したがって、キューに入れられることはありません)、他の優先度レベルで使用できる容量を損なうことがないことを意味します。"Limited" の値は、(a) この優先度レベルの要求 が 制限の対象となり、(b) サーバーの制限された容量の一部がこの優先度レベルでのみ使用可能になることを意味します。必須。

lendablePercent

integer

lendablePercent は、他の優先レベルで借用できるレベルの NominalCL の割合を規定します。このフィールドの値は、0 から 100 までの値である必要があり、デフォルトは 0 です。他のレベルがこのレベルから借用できるシートの数 (このレベルの LendableConcurrencyLimit (LendableCL) と呼ばれます) は、次のように定義されます。

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

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS) は、このレベルの NominalConcurrencyLimit (NominalCL) の計算に寄与します。これは、この優先度レベルに名目上予約されている実行座席の数です。これは、この優先レベルからのディスパッチを制限するものではありませんが、借用メカニズムを通じて他の優先レベルに影響を与えます。サーバーの同時実行制限 (ServerCL) は、NCS 値に比例してすべての優先レベルで分割されます。

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

数値が大きいほど、他のすべての優先レベルを犠牲にして、名目上の同時実行制限が大きくなることを意味します。このフィールドのデフォルト値はゼロです。

borrowingLimitPercent

integer

borrowingLimitPercent が存在する場合、この優先レベルが他の優先レベルから借用できるシート数の制限を設定します。この制限は、このレベルの BorrowingConcurrencyLimit (BorrowingCL) として知られており、このレベルが一度に借用できるシートの合計数の制限です。このフィールドは、名目上、レベルの同時実行制限に対するその制限の比率を保持します。このフィールドが nil 以外の場合は、負ではない整数を保持する必要があり、制限は次のように計算されます。

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

このフィールドの値は 100 を超える可能性があり、この優先レベルが名目上の独自の同時実行制限 (NominalCL) を超える数のシートを借用できることを意味します。このフィールドが nil のままの場合、制限は事実上無限になります。

lendablePercent

integer

lendablePercent は、他の優先レベルで借用できるレベルの NominalCL の割合を規定します。このフィールドの値は、0 から 100 までの値である必要があり、デフォルトは 0 です。他のレベルがこのレベルから借用できるシートの数 (このレベルの LendableConcurrencyLimit (LendableCL) と呼ばれます) は、次のように定義されます。

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

limitResponse

object

LimitResponse は、現在実行できないリクエストを処理する方法を定義します。

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS) は、このレベルの NominalConcurrencyLimit (NominalCL) の計算に寄与します。これは、この優先レベルで利用可能な実行シートの数です。この設定は、この優先レベルからディスパッチされるリクエストと、このレベルからシートを借りて、他の優先レベルからディスパッチされるリクエストの両方に使用されます。サーバーの同時実行制限 (ServerCL) は、NCS 値に比例して制限付き優先度レベルに分割されます。

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

数値が大きいほど、他のすべての優先レベルを犠牲にして、名目上の同時実行制限が大きくなることを意味します。

指定されていないと、このフィールドの値はデフォルトで 30 になります。

このフィールドをゼロに設定すると、この優先度レベルの "jail" の構築がサポートされ、いくつかのリクエストを保持するのに使用されます。

キューイング

object

QueuingConfiguration は、キューイングの設定パラメーターを保持します

type

string

type は "Queue" または "Reject" です。"Queue" は、到着時に実行できない要求が、実行可能になるか、キュー制限に達するまでキューに保持されることを意味します。"Reject" は、到着時に実行できないリクエストが拒否されることを意味します。必須。

handSize

integer

handSize は、キューへの要求のシャッフルシャーディングを設定する小さな正の数です。この優先度レベルでリクエストをキューに入れると、リクエストのフロー識別子 (文字列ペア) がハッシュされ、ハッシュ値を使用してキューのリストがシャッフルされ、ここで指定されたサイズのハンドが処理されます。リクエストは、そのハンドで最も短いキューの 1 つに入れられます。handSize は キュー より大きくてはならず、大幅に小さくする必要があります (これにより、いくつかの大量のフローがほとんどのキューを飽和させないようにします)。このフィールドの設定に関するより詳細なガイダンスについては、ユーザー向けのドキュメントを参照してください。このフィールドのデフォルト値は 8 です。

queueLengthLimit

integer

queueLengthLimit は、この優先度レベルの特定のキューで一度に待機できるリクエストの最大数です。超過したリクエストは拒否されます。この値は正である必要があります。指定しない場合、デフォルトで 50 になります。

queues

integer

queues は、この優先度レベルのキューの数です。キューは、各 apiserver に独立して存在します。値は正でなければなりません。これを 1 に設定すると、シャッフルシャーディングが効果的に排除されるため、関連するフロースキーマの識別方法が無関係になります。このフィールドのデフォルト値は 64 です。

conditions

array

conditions は "リクエスト優先" の現状です。

conditions[]

object

PriorityLevelConfigurationCondition は、優先度レベルの条件を定義します。

lastTransitionTime

Time

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

message

string

message は、最後の遷移に関する詳細を示す人間が判読できるメッセージです。

reason

string

理由 は、条件の最後の遷移の一意の 1 単語の CamelCase 理由です。

status

string

status は、状態のステータスです。True、False、Unknown の場合があります。必須。

type

string

type は、条件のタイプです。必須。