KRM API-Cluster cluster.gdc.goog/v1

cluster.gdc.goog/v1

Enthält API-Schemadefinitionen für die Clustergruppe.

AcceleratorConfig

Wird angezeigt in: - NodePool

Feld Beschreibung
gpuPartitionScheme String GPUPartitionScheme gibt das Schema an, das zum Partitionieren der GPUs in MIGs verwendet wird. Dieses Schema und das GPU-Gerätemodell bestimmen gemeinsam die MIG-Profile. Wenn Sie beispielsweise „mixed-1“ auf einer H100L mit 94 GB angeben, wird die GPU in eine 4g.47gb- und eine 3g.47gb-Partition aufgeteilt.

Kanal

Zugrunde liegender Typ:string Gibt einen bestimmten Typ von Release-Channel an.

Wird angezeigt in: - ReleaseChannel

Cluster

Gibt einen GDC-Nutzercluster in einer Air-Gap-Konfiguration an.

Wird angezeigt in: - ClusterList

Feld Beschreibung
apiVersion String cluster.gdc.goog/v1
kind String Cluster
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der Dokumentation zur Kubernetes API.
spec ClusterSpec
status ClusterStatus

ClusterList

Stellt eine Sammlung von Clustern dar.

Feld Beschreibung
apiVersion String cluster.gdc.goog/v1
kind String ClusterList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der Dokumentation zur Kubernetes API.
items Cluster-Array

ClusterNetwork

Gibt die Cluster-Netzwerkkonfiguration an.

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
podCIDRSize Ganzzahl Die Größe der Netzwerkbereiche, aus denen virtuelle Pod-IP-Adressen zugewiesen werden. Wenn kein Wert angegeben ist, wird der Standardwert 21 verwendet.
serviceCIDRSize Ganzzahl Die Größe der Netzwerkbereiche, aus denen virtuelle Dienst-IP-Adressen zugewiesen werden. Wenn kein Wert angegeben ist, wird der Standardwert 23 verwendet.

ClusterSpec

Wird angezeigt in: - Cluster

Feld Beschreibung
initialVersion ClusterVersion Die GDC-Air-Gap-Versionsinformationen des Nutzerclusters bei der Clustererstellung. Optional. Standardmäßig wird die neueste anwendbare Version verwendet. Nicht veränderbar.
releaseChannel ReleaseChannel Die Release-Version, für die ein Cluster registriert ist. Wenn ein Cluster für eine Release-Version abonniert ist, verwaltet GDC die Clusterversionen für Nutzer. Optional. Veränderlich.
clusterNetwork ClusterNetwork Die Clusternetzwerkkonfiguration. Wenn keine Angabe erfolgt, werden die Standardkonfigurationen mit Pod- und Dienst-CIDR-Größen verwendet. Optional. Veränderlich.
loadBalancer LoadBalancer Die Load-Balancer-Konfiguration. Wenn kein Wert festgelegt ist, wird die Standardkonfiguration mit der Größe der IP-Adresse des Ingress-Dienstes verwendet. Optional. Veränderlich.
nodePools NodePool-Array Die Liste der Knotenpools für die Worker-Knoten des Clusters. Optional. Veränderlich.
nodePoolDefaults NodePoolDefaults Die Konfiguration auf Clusterebene für alle Knotenpools. Optional. Veränderlich.

ClusterState

Underlying type:string Gibt den Status des Clusters an.

Erscheint in: - ClusterStatus

ClusterStatus

Definiert den beobachteten Status des Clusters.

Wird angezeigt in: - Cluster

Feld Beschreibung
conditions Condition-Array Die letzten Beobachtungen zum Clusterstatus. Bedingungen wie Reconciling und Stalled geben an, ob der letzte Clusterabgleich erfolgreich war.
errorStatus ErrorStatus Der beobachtete Fehlerstatus des Clusters.
workerNodePoolStatuses NodePoolStatus-Array Eine Liste der beobachteten Status der Worker-Knotenpools.
controlPlaneConditions Condition-Array Gibt an, ob die Steuerungsebene bereit ist.
componentsConditions Condition-Array Ob die Komponenten des Nutzerclusters erfolgreich bereitgestellt wurden.
versionStatus VersionStatus Informationen zur installierten Version des Clusters.
clusterState ClusterState Der Status des Clusters. Folgende Status sind verfügbar:
  • Running: Der Cluster wurde erstellt und kann verwendet werden.
  • Reconciling: Es wird aktiv an dem Cluster gearbeitet.
  • Deleting: Der Cluster wird gelöscht.
  • Error: Beim Abgleichen/Bereitstellen des Clusters sind einige Fehler aufgetreten.

ClusterVersion

Gibt die Versionsinformationen eines GDC-Nutzerclusters in einer Air-Gap-Konfiguration an.

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
kubernetesVersion String Die Kubernetes-Version des GDC-Nutzerclusters.

ContainerdConfig

Wird angezeigt in: - NodeConfigDefaults

Feld Beschreibung
privateRegistries PrivateRegistry-Array Gibt private Registries an, die zum Abrufen von Images auf dem Knoten verwendet werden. Containerd ist die einzige unterstützte Containerlaufzeit.

LoadBalancer

Gibt die Load-Balancer-Konfiguration an.

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
ingressServiceIPSize Ganzzahl Die Größe der nicht überlappenden IP-Pools, die von den Load-Balancer-Diensten verwendet werden. Wenn kein Wert angegeben ist, wird der Standardwert 20 verwendet.

NodeConfigDefaults

Wird angezeigt in: - NodePoolDefaults

Feld Beschreibung
containerdConfig ContainerdConfig Gibt die containerd-Konfiguration für alle Knoten an. Optional. Veränderlich.

Knotenpool

Gibt die Konfiguration der benutzerdefinierten NodePool-Ressource an.

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
name String Der Name des Knotenpools.
nodeCount Ganzzahl Die gewünschte Anzahl von Knoten im bereitgestellten Knotenpool.
machineTypeName String Der Name der Maschinentypen, die zum Bereitstellen von Knoten verwendet werden.
taints Markierungs-Array Die Markierungen, die den Knoten dieses Knotenpools zugewiesen sind.
labels object (keys:string, values:string) Die Labels, die den Knoten dieses Knotenpools zugewiesen sind. Sie enthält eine Liste von Schlüssel/Wert-Paaren.
acceleratorOptions AcceleratorConfig AcceleratorOptions gibt die gewünschte Konfiguration von Beschleunigern im NodePool an. Sie ist nur gültig, wenn der ausgewählte MachineType Beschleuniger enthält.

NodePoolDefaults

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
nodeConfigDefaults NodeConfigDefaults Die Konfiguration auf Clusterebene für alle Knoten. Optional. Veränderlich.

NodePoolStatus

Definiert den beobachteten Status einer NodePool-Ressource.

Erscheint in: - ClusterStatus

Feld Beschreibung
name String Der Name des Knotenpools.
conditions Condition-Array Die neuesten Beobachtungen zum Status des Knotenpools.
readyNodes Ganzzahl Die Anzahl der Knoten, die bereit sind.
reconcilingNodes Ganzzahl Die Anzahl der Knoten, die abgeglichen werden.
stalledNodes Ganzzahl Die Anzahl der Knoten, die nicht mehr reagieren.
unknownNodes Ganzzahl Die Anzahl der Knoten, deren Status unbekannt ist.
readyTimestamp Zeit Die Zeit, in der sich ein Knotenpool im Status ready befindet. Dieser Wert ändert sich nach der Festlegung nie.
kubernetesVersion String Die Version von Kubernetes, die auf den Knoten dieses Knotenpools ausgeführt wird.

PrivateRegistry

Wird angezeigt in: - ContainerdConfig

Feld Beschreibung
host String Gibt den Host der privaten Registry an. Muss aus dem Host oder Host:Port bestehen.
caCertSecretRef SecretReference Gibt das Secret an, in dem das CA-Bündel der privaten Registry gespeichert ist. Das Secret muss sich entweder im Cluster-Namespace befinden oder die Annotation baremetal.cluster.gke.io/mark-source haben, damit es an den Cluster-Namespace weitergeleitet werden kann.
pullCredentialSecretRef SecretReference Gibt das Secret für die Anmeldedaten für den Zugriff auf die private Registry an. Das Secret muss sich entweder im Cluster-Namespace befinden oder die Annotation baremetal.cluster.gke.io/mark-source haben, damit es an den Cluster-Namespace weitergeleitet werden kann.

ReleaseChannel

Gibt an, welche Release-Version ein Cluster abonniert hat.

Wird angezeigt in: - ClusterSpec

Feld Beschreibung
channel Channel Wenn nicht festgelegt, ist der Standardwert UNSPECIFIED.

UpgradePhaseConfig

Wird angezeigt in: - UserClusterUpgradeRequestSpec

Feld Beschreibung
maxConcurrency Ganzzahl Maximale Anzahl von Elementen, die gleichzeitig aktualisiert werden sollen. Mit -1 werden alle verbleibenden angegeben.
completionThreshold Ganzzahl Prozentsatz des Erfolgs, wenn diese Gruppe von Knotenpools als abgeschlossen betrachtet wird.

UserClusterUpgradeRequest

Stellt die Konfiguration einer Nutzercluster-Upgradeanfrage dar, z. B. die Clusterreferenz und die Kubernetes-Zielversion.

Erscheint in: - UserClusterUpgradeRequestList

Feld Beschreibung
apiVersion String cluster.gdc.goog/v1
kind String UserClusterUpgradeRequest
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der Dokumentation zur Kubernetes API.
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

Stellt eine Sammlung von UserClusterUpgradeRequest-Ressourcen dar.

Feld Beschreibung
apiVersion String cluster.gdc.goog/v1
kind String UserClusterUpgradeRequestList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der Dokumentation zur Kubernetes API.
items UserClusterUpgradeRequest-Array

UserClusterUpgradeRequestSpec

Gibt die Spezifikation einer UserClusterUpgradeRequest-Ressource an, z. B. den gewünschten Status.

Wird angezeigt in: - UserClusterUpgradeRequest

Feld Beschreibung
clusterRef LocalObjectReference Eine Referenz auf das GDC-Nutzerclusterobjekt, auf das sich das Upgrade bezieht.
targetVersion String Die Zielversion des Kubernetes-Nutzerclusters.
nodePoolUpgradePhases UpgradePhaseConfig-Array Schema für die Parallelisierung von Knotenupgrades
concurrentUpgrades boolean Schaltfläche für gleichzeitige ABM-Upgrades für Worker-Knotenpools: Bei „True“ werden alle Worker-Knotenpools gleichzeitig aktualisiert, bei „False“ einer nach dem anderen.

UserClusterUpgradeRequestStatus

Wird angezeigt in: - UserClusterUpgradeRequest

Feld Beschreibung
conditions Condition-Array Der aktuelle Upgrade-Status. Bekannte Bedingungstypen: Erfolgreich.
startTime Zeit Der beobachtete Beginn des aktuellen Upgrades.

VersionStatus

Definiert die Informationen zur installierten Version des Clusters.

Erscheint in: - ClusterStatus

Feld Beschreibung
componentVersion String Die Komponentenversion des Clusters.
kubernetesVersion String Die Kubernetes-Version des Clusters.