KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

クラスタ グループの API スキーマ定義が含まれています。

AcceleratorConfig

表示場所: - NodePool

フィールド	説明
gpuPartitionScheme 文字列	GPUPartitionScheme は、GPU を MIG に分割するために使用されるスキームを示します。このスキームと GPU DeviceModel によって、MIG プロファイルが決定されます。たとえば、H100L 94 GB の mixed-1 は、GPU を 4g.47gb と 3g.47gb の 2 つに分割することを決定します。

チャンネル

基になる型: string 特定のタイプのリリース チャンネルを示します。

表示場所: - ReleaseChannel

クラスタ

エアギャップ構成で GDC ユーザー クラスタを指定します。

表示場所: - ClusterList

フィールド	説明
apiVersion 文字列	cluster.gdc.goog/v1
kind 文字列	Cluster
metadata ObjectMeta	metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
spec ClusterSpec
status ClusterStatus

ClusterList

クラスタのコレクションを表します。

フィールド	説明
apiVersion 文字列	cluster.gdc.goog/v1
kind 文字列	ClusterList
metadata ListMeta	metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
items クラスタ配列

ClusterNetwork

クラスタ ネットワーク構成を指定します。

表示場所: - ClusterSpec

フィールド	説明
podCIDRSize 整数	Pod の仮想 IP アドレスが割り振られるネットワーク範囲のサイズ。設定されていない場合は、デフォルト値の 21 が使用されます。
serviceCIDRSize 整数	サービス仮想 IP アドレスが割り振られるネットワーク範囲のサイズ。設定されていない場合は、デフォルト値の 23 が使用されます。

ClusterSpec

表示場所: - クラスタ

フィールド	説明
initialVersion ClusterVersion	クラスタの作成時のユーザー クラスタの GDC エアギャップ バージョン情報。省略可。デフォルトでは、適用可能な最新バージョンが使用されます。変更不可。
releaseChannel ReleaseChannel	クラスタが登録されているリリース チャンネル。クラスタがリリース チャンネルに登録されている場合、GDC はユーザーのクラスタ バージョンを維持します。省略可。変更可。
clusterNetwork ClusterNetwork	クラスタ ネットワーク構成。設定しない場合、Pod と Service の CIDR サイズを含むデフォルトの構成が使用されます。省略可。変更可。
loadBalancer LoadBalancer	ロードバランサの構成。設定しない場合、Ingress サービス IP アドレスのサイズを含むデフォルト構成が使用されます。省略可。変更可。
nodePools NodePool の配列	クラスタ ワーカーノードのノードプールのリスト。省略可。変更可。

ClusterState

基になる型: string クラスタの状態を示します。

表示場所: - ClusterStatus

ClusterStatus

クラスタの観測された状態を定義します。

表示場所: - クラスタ

フィールド	説明
conditions 条件の配列	クラスタの状態に関する最新の観測値。Reconciling や Stalled などの条件は、最後のクラスタ調整が成功したかどうかを示します。
errorStatus ErrorStatus	クラスタの観測されたエラー ステータス。
workerNodePoolStatuses NodePoolStatus 配列	ワーカー ノードプールのモニタリングされたステータスのリスト。
controlPlaneConditions 条件の配列	コントロール プレーンの準備ができているかどうか。
componentsConditions 条件の配列	ユーザー クラスタ コンポーネントが正常にデプロイされたかどうか。
versionStatus VersionStatus	クラスタのインストール済みバージョン情報。
clusterState ClusterState	クラスタの状態。次の状態を使用できます。 Running: クラスタが作成され、使用可能です。 Reconciling: クラスタでアクティブに作業が行われています。 Deleting: クラスタが削除されています。 Error: クラスタの調整/プロビジョニング中にエラーが発生しました。

ClusterVersion

エアギャップ構成の GDC ユーザー クラスタのバージョン情報を指定します。

表示場所: - ClusterSpec

フィールド	説明
kubernetesVersion 文字列	GDC ユーザー クラスタの Kubernetes バージョン。

LoadBalancer

ロードバランサの構成を指定します。

表示場所: - ClusterSpec

フィールド	説明
ingressServiceIPSize 整数	ロードバランサ タイプ サービスで使用される重複しない IP プールのサイズ。設定されていない場合は、デフォルト値の 20 が使用されます。

ノードプール

NodePool カスタム リソース構成を指定します。

表示場所: - ClusterSpec

フィールド	説明
name 文字列	ノードプールの名前。
nodeCount 整数	プロビジョニングされたノードプール内のノード数。
machineTypeName 文字列	ノードのプロビジョニングに使用されるマシンタイプの名前。
taints Taint 配列	このノードプールのノードに割り当てられた taint。
labels オブジェクト（キー:文字列、値:文字列）	このノードプールのノードに割り当てられるラベル。Key-Value ペアのリストが含まれています。
acceleratorOptions AcceleratorConfig	AcceleratorOptions は、NodePool 内のアクセラレータの望ましい構成を示します。選択した MachineType にアクセラレータが含まれている場合にのみ有効です。

NodePoolStatus

NodePool リソースの観測状態を定義します。

表示場所: - ClusterStatus

フィールド	説明
name 文字列	ノードプールの名前。
conditions 条件の配列	ノードプールの状態に関する最新の観測値。
readyNodes 整数	配信準備ができたノードの数。
reconcilingNodes 整数	調整中のノード数。
stalledNodes 整数	停止しているノードの数。
unknownNodes 整数	ステータスが不明なノードの数。
readyTimestamp 時間	ノードプールが ready ステータスになっている時間。この値は一度設定すると変更できません。
kubernetesVersion 文字列	このノードプールのノードで実行されている Kubernetes のバージョン。

ReleaseChannel

クラスタが登録されているリリース チャンネルを示します。

表示場所: - ClusterSpec

フィールド	説明
channel チャネル	設定しない場合、デフォルトは UNSPECIFIED になります。

UserClusterUpgradeRequest

クラスタ参照やターゲット Kubernetes バージョンなど、ユーザー クラスタ アップグレード リクエストの構成を表します。

表示場所: - UserClusterUpgradeRequestList

フィールド	説明
apiVersion 文字列	cluster.gdc.goog/v1
kind 文字列	UserClusterUpgradeRequest
metadata ObjectMeta	metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

UserClusterUpgradeRequest リソースのコレクションを表します。

フィールド	説明
apiVersion 文字列	cluster.gdc.goog/v1
kind 文字列	UserClusterUpgradeRequestList
metadata ListMeta	metadata のフィールドについては、Kubernetes API のドキュメントをご覧ください。
items UserClusterUpgradeRequest 配列

UserClusterUpgradeRequestSpec

UserClusterUpgradeRequest リソースの仕様（望ましい状態など）を提供します。

表示場所: - UserClusterUpgradeRequest

フィールド	説明
clusterRef LocalObjectReference	アップグレードが適用される GDC ユーザー クラスタ オブジェクトへの参照。
targetVersion 文字列	ターゲット Kubernetes ユーザー クラスタのバージョン。

UserClusterUpgradeRequestStatus

表示場所: - UserClusterUpgradeRequest

フィールド	説明
conditions 条件の配列	現在のアップグレードの状態。既知の条件タイプ: 成功しました。
startTime 時間	現在のアップグレードの観測開始時刻。

VersionStatus

クラスタのインストール済みバージョン情報を定義します。

表示場所: - ClusterStatus

フィールド	説明
componentVersion 文字列	クラスタのコンポーネント バージョン。
kubernetesVersion 文字列	クラスタの Kubernetes バージョン。