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 の配列 |
クラスタ ワーカーノードのノードプールのリスト。省略可。変更可。 |
nodePoolDefaults NodePoolDefaults |
すべてのノードプールのクラスタレベルの構成。省略可。変更可。 |
ClusterState
基になる型: string
クラスタの状態を示します。
表示場所: - ClusterStatus
ClusterStatus
クラスタの観測された状態を定義します。
表示場所: - クラスタ
| フィールド | 説明 |
|---|---|
conditions 条件の配列 |
クラスタの状態に関する最新の観測値。Reconciling や Stalled などの条件は、前回のクラスタ調整が成功したかどうかを示します。 |
errorStatus ErrorStatus |
クラスタの観測されたエラー ステータス。 |
workerNodePoolStatuses NodePoolStatus 配列 |
ワーカー ノードプールのモニタリングされたステータスのリスト。 |
controlPlaneConditions 条件の配列 |
コントロール プレーンの準備ができているかどうか。 |
componentsConditions 条件の配列 |
ユーザー クラスタ コンポーネントが正常にデプロイされたかどうか。 |
versionStatus VersionStatus |
クラスタのインストール済みバージョン情報。 |
clusterState ClusterState |
クラスタの状態。次の状態を使用できます。
|
subnets SubnetReference 配列 |
Subnets には、このクラスタで使用されるサブネットのリストが保持されます。 |
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 を指定します。Secret はクラスタの Namespace に存在するか、クラスタの Namespace に転送できるように baremetal.cluster.gke.io/mark-source アノテーションが付いている必要があります。 |
ReleaseChannel
クラスタが登録されているリリース チャンネルを示します。
表示場所: - ClusterSpec
| フィールド | 説明 |
|---|---|
channel チャネル |
設定しない場合、デフォルトは UNSPECIFIED になります。 |
SubnetReference
SubnetReference はサブネットへの参照を保持します。
表示場所: - ClusterStatus
| フィールド | 説明 |
|---|---|
name 文字列 |
|
namespace 文字列 |
UpgradePhaseConfig
表示場所: - UserClusterUpgradeRequestSpec
| フィールド | 説明 |
|---|---|
maxConcurrency 整数 |
同時にアップグレードする要素の最大数。-1 は、残りのすべてを指定します。 |
completionThreshold 整数 |
このノードプールのグループが完了したと見なすための成功率。 |
UpgradeStepStatus
表示場所: - UserClusterUpgradeRequestStatus
| フィールド | 説明 |
|---|---|
conditions 条件の配列 |
Conditions は、アップグレード ステップの観測されたステータスを表します。 |
phase 整数 |
Phase は、現在のフェーズのインデックスを追跡します。 |
phaseBatchNames 文字列配列 |
PhaseBatchNames には、処理中または完了した NodeUpgrade CR 名が一覧表示されます。 |
startTime 時間 |
StartTime は、アップグレード ステップの開始時刻を表します。 |
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 つずつアップグレードします。 |
disruption NodeUpgradeDisruption |
中断は、ノードのアップグレードの中断レベルを定義します。このフィールドが設定されていない場合、パッチ アップグレードはデフォルトでワークロードをドレインせずに実行されます（NoDisruption）。このフィールドを「RequiresWorkloadDrain」に設定すると、デフォルトの動作がオーバーライドされ、システムはノードで標準のドレイン プロセスを実行します。注: このフィールドはマイナー バージョンのアップグレードでは無視されます。マイナー バージョンのアップグレードでは、常にワークロードのドレインが必要です。 |
UserClusterUpgradeRequestStatus
表示場所: - UserClusterUpgradeRequest
| フィールド | 説明 |
|---|---|
conditions 条件の配列 |
現在のアップグレードの状態。既知の条件タイプ: 成功しました。 |
startTime 時間 |
現在のアップグレードの観測開始時刻。 |
cluster UpgradeStepStatus |
Cluster は、観測されたクラスタ アップグレードのステータスを表します。 |
node UpgradeStepStatus |
Node は、クラスタノードの観測されたノード アップグレード ステータスを表します。 |
VersionStatus
クラスタのインストール済みバージョン情報を定義します。
表示場所: - ClusterStatus
| フィールド | 説明 |
|---|---|
componentVersion 文字列 |
クラスタのコンポーネント バージョン。 |
kubernetesVersion 文字列 |
クラスタの Kubernetes バージョン。 |