KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

Contiene le definizioni dello schema API per il gruppo Cluster.

AcceleratorConfig

Visualizzato in: - NodePool

Campo	Descrizione
gpuPartitionScheme stringa	GPUPartitionScheme indica lo schema che verrà utilizzato per partizionare le GPU in MIG. Questo schema e GPU DeviceModel decidono congiuntamente i profili MIG. Ad esempio, mixed-1 su H100L 94 GB determina la partizione della GPU in una da 4 g.47 GB e una da 3 g.47 GB.

Canale

Tipo sottostante:string indica un tipo specifico di canale di rilascio.

Visualizzato in: - ReleaseChannel

Cluster

Specifica un cluster utente GDC in una configurazione air-gap.

Visualizzato in: - ClusterList

Campo	Descrizione
apiVersion stringa	cluster.gdc.goog/v1
kind stringa	Cluster
metadata ObjectMeta	Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
spec ClusterSpec
status ClusterStatus

ClusterList

Rappresenta una raccolta di cluster.

Campo	Descrizione
apiVersion stringa	cluster.gdc.goog/v1
kind stringa	ClusterList
metadata ListMeta	Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
items Array di cluster

ClusterNetwork

Specifica la configurazione di rete del cluster.

Appare in: - ClusterSpec

Campo	Descrizione
podCIDRSize integer	La dimensione degli intervalli di rete da cui vengono allocati gli indirizzi IP virtuali dei pod. Se non viene configurato, viene utilizzato il valore predefinito 21.
serviceCIDRSize integer	La dimensione degli intervalli di rete da cui vengono allocati gli indirizzi IP virtuali del servizio. Se non viene configurato, viene utilizzato il valore predefinito 23.

ClusterSpec

Visualizzato in: - Cluster

Campo	Descrizione
initialVersion ClusterVersion	Le informazioni sulla versione air-gapped di GDC del cluster utente durante la creazione del cluster. Facoltativo. Imposta come predefinita l'ultima versione applicabile. Immutabile.
releaseChannel ReleaseChannel	Il canale di rilascio a cui è iscritto un cluster. Quando un cluster è iscritto a un canale di rilascio, GDC gestisce le versioni del cluster per gli utenti. Facoltativo. Modificabile.
clusterNetwork ClusterNetwork	La configurazione di rete del cluster. Se non viene impostato, vengono utilizzate le configurazioni predefinite con le dimensioni CIDR di pod e servizi. Facoltativo. Modificabile.
loadBalancer LoadBalancer	La configurazione del bilanciatore del carico. Se non viene configurata, viene utilizzata la configurazione predefinita con la dimensione dell'indirizzo IP del servizio di ingresso. Facoltativo. Modificabile.
nodePools NodePool	L'elenco dei node pool per i nodi worker del cluster. Facoltativo. Modificabile.
nodePoolDefaults NodePoolDefaults	La configurazione a livello di cluster per tutti i node pool. Facoltativo. Modificabile.

ClusterState

Tipo sottostante: string Indica lo stato del cluster.

Visualizzato in: - ClusterStatus

ClusterStatus

Definisce lo stato osservato del cluster.

Visualizzato in: - Cluster

Campo	Descrizione
conditions Condition array	Le ultime osservazioni sullo stato del cluster. Condizioni come Reconciling e Stalled indicano se l'ultima riconciliazione del cluster è andata a buon fine.
errorStatus ErrorStatus	Lo stato di errore osservato del cluster.
workerNodePoolStatuses Array NodePoolStatus	Un elenco degli stati osservati dei pool di nodi worker.
controlPlaneConditions Condition array	Indica se il control plane è pronto.
componentsConditions Condition array	Indica se i componenti del cluster utente sono stati implementati correttamente.
versionStatus VersionStatus	Le informazioni sulla versione installata del cluster.
clusterState ClusterState	Lo stato del cluster. Sono disponibili i seguenti stati: Running: il cluster è stato creato ed è utilizzabile. Reconciling: sul cluster è in corso un'attività. Deleting: il cluster è in fase di eliminazione. Error: si sono verificati alcuni errori durante la riconciliazione/il provisioning del cluster.
subnets SubnetReference	Subnets contiene l'elenco delle subnet utilizzate per questo cluster.

ClusterVersion

Specifica le informazioni sulla versione di un cluster utente GDC in una configurazione air-gap.

Appare in: - ClusterSpec

Campo	Descrizione
kubernetesVersion stringa	La versione di Kubernetes del cluster utente GDC.

ContainerdConfig

Visualizzato in: - NodeConfigDefaults

Campo	Descrizione
privateRegistries PrivateRegistry	Specifica i registri privati utilizzati per eseguire il pull delle immagini sul nodo. Containerd è l'unico runtime container supportato.

LoadBalancer

Specifica la configurazione del bilanciatore del carico.

Appare in: - ClusterSpec

Campo	Descrizione
ingressServiceIPSize integer	La dimensione dei pool IP non sovrapposti utilizzati dai servizi digitati del bilanciatore del carico. Se non viene configurato, viene utilizzato il valore predefinito 20.

NodeConfigDefaults

Appare in: - NodePoolDefaults

Campo	Descrizione
containerdConfig ContainerdConfig	Specifica la configurazione di containerd per tutti i nodi. Facoltativo. Modificabile.

NodePool

Specifica la configurazione della risorsa personalizzata NodePool.

Appare in: - ClusterSpec

Campo	Descrizione
name stringa	Il nome del pool di nodi.
nodeCount integer	Il numero desiderato di nodi nel pool di nodi di cui è stato eseguito il provisioning.
machineTypeName stringa	Il nome dei tipi di macchine utilizzati per il provisioning dei nodi.
taints Taint array	I taint assegnati ai nodi di questo pool di nodi.
labels object (keys:string, values:string)	Le etichette assegnate ai nodi di questo pool di nodi. Contiene un elenco di coppie chiave/valore.
acceleratorOptions AcceleratorConfig	AcceleratorOptions indica la configurazione desiderata degli acceleratori all'interno del node pool. È valido solo se il tipo di macchina scelto contiene acceleratori.

NodePoolDefaults

Appare in: - ClusterSpec

Campo	Descrizione
nodeConfigDefaults NodeConfigDefaults	La configurazione a livello di cluster per tutti i nodi. Facoltativo. Modificabile.

NodePoolStatus

Definisce lo stato osservato di una risorsa NodePool.

Visualizzato in: - ClusterStatus

Campo	Descrizione
name stringa	Il nome del pool di nodi.
conditions Condition array	Le ultime osservazioni sullo stato del pool di nodi.
readyNodes integer	Il numero di nodi pronti per l'erogazione.
reconcilingNodes integer	Il numero di nodi in fase di riconciliazione.
stalledNodes integer	Il numero di nodi bloccati.
unknownNodes integer	Il numero di nodi il cui stato è sconosciuto.
readyTimestamp Ora	Il tempo in cui un pool di nodi si trova nello stato ready. Questo valore non cambierà mai una volta impostato.
kubernetesVersion stringa	La versione di Kubernetes in esecuzione sui nodi di questo pool di nodi.

PrivateRegistry

Visualizzato in: - ContainerdConfig

Campo	Descrizione
host stringa	Specifica l'host del registro privato. Deve essere composto dall'host o dall'host:porta.
caCertSecretRef SecretReference	Specifica il secret che archivia il bundle CA del registro privato. Il secret deve trovarsi nello spazio dei nomi del cluster o avere l'annotazione baremetal.cluster.gke.io/mark-source in modo che possa essere inoltrato allo spazio dei nomi del cluster.
pullCredentialSecretRef SecretReference	Specifica il secret per la credenziale di accesso al registro privato. Il secret deve trovarsi nello spazio dei nomi del cluster o avere l'annotazione baremetal.cluster.gke.io/mark-source in modo che possa essere inoltrato allo spazio dei nomi del cluster.

ReleaseChannel

Indica a quale canale di rilascio è iscritto un cluster.

Appare in: - ClusterSpec

Campo	Descrizione
channel Canale	Se non viene impostato, il valore predefinito è UNSPECIFIED.

SubnetReference

SubnetReference contiene il riferimento a una subnet.

Visualizzato in: - ClusterStatus

Campo	Descrizione
name stringa
namespace stringa

UpgradePhaseConfig

Visualizzato in: - UserClusterUpgradeRequestSpec

Campo	Descrizione
maxConcurrency integer	Numero massimo di elementi da aggiornare contemporaneamente. -1 per specificare tutti i rimanenti.
completionThreshold integer	Percentuale di successo per considerare completato questo gruppo di node pool.

UpgradeStepStatus

Appare in: - UserClusterUpgradeRequestStatus

Campo	Descrizione
conditions Condition array	Conditions rappresenta lo stato osservato del passaggio di upgrade.
phase integer	Phase tiene traccia dell'indice della fase corrente.
phaseBatchNames array di stringhe	PhaseBatchNames elenca i nomi delle CR NodeUpgrade in fase di elaborazione o completamento.
startTime Ora	StartTime rappresenta l'ora di inizio del passaggio di upgrade.

UserClusterUpgradeRequest

Rappresenta la configurazione di una richiesta di upgrade di un cluster utente, ad esempio il riferimento al cluster e la versione di Kubernetes di destinazione.

Visualizzato in: - UserClusterUpgradeRequestList

Campo	Descrizione
apiVersion stringa	cluster.gdc.goog/v1
kind stringa	UserClusterUpgradeRequest
metadata ObjectMeta	Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

Rappresenta una raccolta di risorse UserClusterUpgradeRequest.

Campo	Descrizione
apiVersion stringa	cluster.gdc.goog/v1
kind stringa	UserClusterUpgradeRequestList
metadata ListMeta	Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
items Array UserClusterUpgradeRequest

UserClusterUpgradeRequestSpec

Fornisce la specifica, ad esempio lo stato desiderato, di una risorsa UserClusterUpgradeRequest.

Appare in: - UserClusterUpgradeRequest

Campo	Descrizione
clusterRef LocalObjectReference	Un riferimento all'oggetto cluster utente GDC a cui si applica l'upgrade.
targetVersion stringa	La versione di destinazione del cluster utente Kubernetes.
nodePoolUpgradePhases UpgradePhaseConfig	Schema per la parallelizzazione degli upgrade dei nodi
concurrentUpgrades boolean	Attiva/disattiva l'upgrade ABM simultaneo del pool di nodi worker. Se è impostato su True, tutti i pool di nodi worker vengono aggiornati contemporaneamente. Se è impostato su False, l'upgrade viene eseguito un pool alla volta.
disruption NodeUpgradeDisruption	L'interruzione definisce il livello di interruzione per gli upgrade dei nodi. Se questo campo non è impostato, gli upgrade delle patch vengono eseguiti per impostazione predefinita senza svuotare i workload (NoDisruption). Se imposti questo campo su "RequiresWorkloadDrain", il comportamento predefinito viene ignorato e il sistema esegue un processo di svuotamento standard sui nodi. Nota: questo campo viene ignorato per gli upgrade delle versioni secondarie, che richiedono sempre lo svuotamento del workload.

UserClusterUpgradeRequestStatus

Appare in: - UserClusterUpgradeRequest

Campo	Descrizione
conditions Condition array	Lo stato attuale dell'upgrade. Tipi di condizioni noti: riuscito.
startTime Ora	L'ora di inizio osservata per l'upgrade attuale.
cluster UpgradeStepStatus	Cluster rappresenta lo stato di upgrade del cluster osservato.
node UpgradeStepStatus	Nodo rappresenta lo stato di upgrade del nodo osservato per i nodi del cluster.

VersionStatus

Definisce le informazioni sulla versione installata del cluster.

Visualizzato in: - ClusterStatus

Campo	Descrizione
componentVersion stringa	La versione del componente del cluster.
kubernetesVersion stringa	La versione di Kubernetes del cluster.