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 を 1 つの 4g.47gb と 1 つの 3g.47gb に分割することを決定します。

チャンネル

基になる型: 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 の配列	クラスタ ワーカーノードのノードプールのリスト。省略可。変更可。
nodePoolDefaults NodePoolDefaults	すべてのノードプールのクラスタレベルの構成。省略可。変更可。

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 バージョン。

ContainerdConfig

表示場所: - NodeConfigDefaults

フィールド	説明
privateRegistries PrivateRegistry の配列	ノードでイメージを pull するために使用される非公開レジストリを指定します。サポートされているコンテナ ランタイムは containerd のみです。

LoadBalancer

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

表示場所: - ClusterSpec

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

NodeConfigDefaults

表示場所: - NodePoolDefaults

フィールド	説明
containerdConfig ContainerdConfig	すべてのノードの containerd 構成を指定します。省略可。変更可。

ノードプール

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

表示場所: - ClusterSpec

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

NodePoolDefaults

表示場所: - ClusterSpec

フィールド	説明
nodeConfigDefaults NodeConfigDefaults	すべてのノードのクラスタレベルの構成。省略可。変更可。

NodePoolStatus

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

表示場所: - ClusterStatus

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

PrivateRegistry

表示場所: - ContainerdConfig

フィールド	説明
host 文字列	限定公開レジストリ ホストを指定します。これは、ホストまたはホスト:ポートで構成する必要があります。
caCertSecretRef SecretReference	非公開レジストリの CA バンドルを保存するシークレットを指定します。Secret はクラスタの Namespace に存在するか、クラスタの Namespace に転送できるように baremetal.cluster.gke.io/mark-source アノテーションが付いている必要があります。
pullCredentialSecretRef SecretReference	非公開レジストリ アクセス認証情報のシークレットを指定します。Secret はクラスタの Namespace に存在するか、クラスタの Namespace に転送できるように baremetal.cluster.gke.io/mark-source アノテーションが付いている必要があります。

ReleaseChannel

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

表示場所: - ClusterSpec

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

UpgradePhaseConfig

表示場所: - UserClusterUpgradeRequestSpec

フィールド	説明
maxConcurrency 整数	同時にアップグレードする要素の最大数。-1: 残りのすべてを指定します。
completionThreshold 整数	このノードプール グループが完了したと見なすための成功率。

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 ユーザー クラスタのバージョン。
nodePoolUpgradePhases UpgradePhaseConfig 配列	ノードのアップグレードの並列化のスキーマ
concurrentUpgrades ブール値	ワーカー ノードプールの ABM の同時アップグレードの切り替え。True にすると、すべてのワーカー ノードプールが同時にアップグレードされ、False にすると、1 つずつアップグレードされます。

UserClusterUpgradeRequestStatus

表示場所: - UserClusterUpgradeRequest

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

VersionStatus

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

表示場所: - ClusterStatus

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