第2章 ClusterAutoscaler [autoscaling.openshift.io/v1]


説明
ClusterAutoscaler は、clusterautoscalers API のスキーマです。
タイプ
object

2.1. 仕様

プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。更新はできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

ClusterAutoscaler リソースの望ましい状態

status

object

ClusterAutoscaler リソースの最近観察されたステータス

2.1.1. .spec

説明
ClusterAutoscaler リソースの望ましい状態
タイプ
object
プロパティータイプ説明

balanceSimilarNodeGroups

boolean

BalanceSimilarNodeGroups は、--balance-similar-node-groups cluster-autoscaler 機能を有効/無効にします。この機能は、同じインスタンスタイプと同じラベルのセットを持つノードグループを自動的に識別し、それらのノードグループのそれぞれのサイズのバランスを維持しようとします。

balancingIgnoredLabels

array (string)

BalancingIgnoredLabels は、リストされている各ラベルに対して、cluster-autoscaler に "--balancing-ignore-label <label name>" フラグを設定します。このオプションは、ノードグループの類似性を考慮するときにクラスターオートスケーラーが無視するラベルを指定します。たとえば、"topology.ebs.csi.aws.com/zone" ラベルを持つノードがある場合は、このラベルの名前をここに追加して、クラスターオートスケーラーがその値に基づいてノードを異なるノードグループに分割するのを防ぐことができます。

expanders

array (string)

スケールアウト操作中に使用するエクスパンダーのタイプと順序を設定します。このオプションは、スケールアウト時に拡張するノードグループを選択するためにクラスターオートスケーラーが使用する expanders の順序付きリスト (優先度の高いものから) を指定します。expanders は、クラスターをスケールアウトするときにノードグループを選択する方法をオートスケーラーに指示します。最初の expander からの結果が 2 番目の expander への入力として使用されるなど、順番に指定できます。たとえば、[LeastWaste, Random] に設定されていると、オートスケーラーは最初にノードグループを評価して、リソースの無駄が最も少ないグループを決定します。複数のグループが選択されていると、オートスケーラーはそれらのグループをランダムに選択して、スケーリングするグループを決定します。次の expanders が利用可能です。* LeastWaste - スケールアップ後にアイドル状態の CPU (未使用のメモリーが割り当てられた状態) が最も少ないノードグループを選択します。* 優先度 - ユーザーが割り当てた最高の優先度を持つノードグループを選択します。詳細は、https://github.com/openshift/kubernetes-autoscaler/blob/master/cluster-autoscaler/expander/priority/readme.md を参照してください。* ランダム - ノードグループをランダムに選択します。これを指定しないと、デフォルト値は Random です。使用可能なオプションは、LeastWastePriorityRandom です。

ignoreDaemonsetsUtilization

boolean

--ignore-daemonsets-utilization 機能フラグを有効/無効にします。スケールダウンのためにリソース使用率を計算するときに、CA は DaemonSet Pod を無視する必要があります。デフォルトでは false

logVerbosity

integer

Autoscaler のログレベルを設定します。デフォルト値は 1 です。レベル 4 はデバッグに推奨され、レベル 6 ではほぼすべてが有効になります。このオプションは、CLUSTER_AUTOSCALER_VERBOSITY 環境変数が設定したログレベルよりも優先されます。

maxNodeProvisionTime

string

CA がノードのプロビジョニングを待機する最大時間

maxPodGracePeriod

integer

スケールダウンする前に Pod に適切な終了時間を与えます

podPriorityThreshold

integer

ユーザーが "ベストエフォート" Pod をスケジュールできるようにするには、クラスターオートスケーラーアクションをトリガーしないでください。ただし、予備のリソースが利用可能な場合にのみ実行してください。詳細: https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md#how-does-cluster-autoscaler-work-with-pod-priority-and-preemption

resourceLimits

object

自動スケーリングリソースの制約

scaleDown

object

スケールダウン操作の設定

skipNodesWithLocalStorage

boolean

--skip-nodes-with-local-storage CA 機能フラグを有効/無効にします。真のクラスターオートスケーラーが、EmptyDir や HostPath などのローカルストレージを備えた Pod を持つノードを削除しない場合。オートスケーラーではデフォルトで true

2.1.2. .spec.resourceLimits

説明
自動スケーリングリソースの制約
タイプ
object
プロパティータイプ説明

コア

object

<min>:<max> の形式で、クラスター内のコアの最小数と最大数。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。

gpus

array

<gpu_type>:<min>:<max> の形式で、クラスター内の異なる GPU の最小数と最大数。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。複数回渡すことができます。

gpus[]

object

 

maxNodesTotal

integer

すべてのノードグループのノードの最大数。クラスターオートスケーラーは、この数を超えてクラスターを拡張しません。

memory

object

クラスター内のメモリーの最小 GiB 数と最大 GiB 数 (形式: <min>:<max>)。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。

2.1.3. .spec.resourceLimits.cores

説明
<min>:<max> の形式で、クラスター内のコアの最小数と最大数。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。
タイプ
object
必須
  • max
  • min
プロパティータイプ説明

max

integer

 

min

integer

 

2.1.4. .spec.resourceLimits.gpus

説明
<gpu_type>:<min>:<max> の形式で、クラスター内の異なる GPU の最小数と最大数。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。複数回渡すことができます。
タイプ
array

2.1.5. .spec.resourceLimits.gpus[]

説明
タイプ
object
必須
  • max
  • min
  • type
プロパティータイプ説明

max

integer

 

min

integer

 

type

string

最小値と最大値に関連付ける GPU のタイプ。この値は、Cluster Autoscaler によって、ノードオブジェクトのラベル値として検索することで、GPU 容量を持つノードを識別するために使用されます。たとえば、ラベル値が Type フィールドと同じであるラベルキー cluster-api/accelerator を持つノードは、Cluster Autoscaler によってリソース制限にカウントされます。

2.1.6. .spec.resourceLimits.memory

説明
クラスター内のメモリーの最小 GiB 数と最大 GiB 数 (形式: <min>:<max>)。クラスターオートスケーラーは、これらの数値を超えてクラスターをスケーリングしません。
タイプ
object
必須
  • max
  • min
プロパティータイプ説明

max

integer

 

min

integer

 

2.1.7. .spec.scaleDown

説明
スケールダウン操作の設定
タイプ
object
必須
  • enabled
プロパティータイプ説明

delayAfterAdd

string

スケールアップ後、スケールダウン評価が再開されるまでの期間

delayAfterDelete

string

スケールダウン評価が再開されたノードの削除後、デフォルトでスキャン間隔になります

delayAfterFailure

string

スケールダウンの失敗後、スケールダウン評価が再開されるまでの期間

enabled

boolean

CA はクラスターを縮小する必要があります

unneededTime

string

スケールダウンの対象となる前にノードが不要になるまでの期間

utilizationThreshold

string

ノード使用率レベル。要求されたリソースの合計を容量で割ったものとして定義され、このレベルを下回るとノードのスケールダウンが考慮されます。

2.1.8. .status

説明
ClusterAutoscaler リソースの最近観察されたステータス
タイプ
object
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.