Clúster de la API de KRM: cluster.gdc.goog/v1

cluster.gdc.goog/v1

Contiene definiciones del esquema de la API para el grupo de clústeres.

AcceleratorConfig

Aparece en: - NodePool

Campo	Descripción
gpuPartitionScheme string	GPUPartitionScheme indica el esquema que se usará para particionar las GPUs en MIGs. Este esquema y el DeviceModel de la GPU deciden conjuntamente los perfiles de la MIG. Por ejemplo, mixed-1 en H100L 94 GB determina que la GPU se particione en una de 4 g.47 GB y otra de 3 g.47 GB.

Canal

Tipo subyacente: string Indica un tipo específico de canal de versiones.

Aparece en: - ReleaseChannel

Clúster

Especifica un clúster de usuario de GDC en una configuración aislada.

Aparece en: - ClusterList

Campo	Descripción
apiVersion string	cluster.gdc.goog/v1
kind string	Cluster
metadata ObjectMeta	Consulta la documentación de la API de Kubernetes para conocer los campos de metadata.
spec ClusterSpec
status ClusterStatus

ClusterList

Representa una colección de clústeres.

Campo	Descripción
apiVersion string	cluster.gdc.goog/v1
kind string	ClusterList
metadata ListMeta	Consulta la documentación de la API de Kubernetes para conocer los campos de metadata.
items Array de clústeres

ClusterNetwork

Especifica la configuración de red del clúster.

Aparece en: - ClusterSpec

Campo	Descripción
podCIDRSize número entero	Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de los pods. Si no se establece, se usa el valor predeterminado 21.
serviceCIDRSize número entero	Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de servicio. Si no se establece, se usa el valor predeterminado 23.

ClusterSpec

Aparece en: - Cluster

Campo	Descripción
initialVersion ClusterVersion	Es la información de la versión aislada de GDC del clúster de usuario durante la creación del clúster. Es opcional. Se usa de forma predeterminada la versión aplicable más reciente. Inmutable.
releaseChannel ReleaseChannel	Es el canal de versiones al que está suscrito un clúster. Cuando un clúster está suscrito a un canal de versiones, GDC mantiene las versiones del clúster para los usuarios. Es opcional. Mutable.
clusterNetwork ClusterNetwork	Es la configuración de la red del clúster. Si no se configura, se usan los parámetros de configuración predeterminados con tamaños de CIDR de servicio y de Pod. Es opcional. Mutable.
loadBalancer LoadBalancer	Es la configuración del balanceador de cargas. Si no se configura, se usa la configuración predeterminada con el tamaño de la dirección IP del servicio de entrada. Es opcional. Mutable.
nodePools arreglo de NodePool	Es la lista de grupos de nodos para los nodos trabajadores del clúster. Es opcional. Mutable.
nodePoolDefaults NodePoolDefaults	Es la configuración a nivel del clúster para todos los grupos de nodos. Es opcional. Mutable.

ClusterState

Tipo subyacente: string Indica el estado del clúster.

Aparece en: - ClusterStatus

ClusterStatus

Define el estado observado del clúster.

Aparece en: - Cluster

Campo	Descripción
conditions arreglo de condiciones	Son las observaciones más recientes del estado del clúster. Las condiciones como Reconciling y Stalled indican si la última reconciliación del clúster se realizó correctamente.
errorStatus ErrorStatus	Es el estado de error observado del clúster.
workerNodePoolStatuses Array de NodePoolStatus	Es una lista de los estados observados de los grupos de nodo trabajador.
controlPlaneConditions arreglo de condiciones	Indica si el plano de control está listo.
componentsConditions arreglo de condiciones	Indica si los componentes del clúster de usuario se implementaron correctamente.
versionStatus VersionStatus	Es la información de la versión instalada del clúster.
clusterState ClusterState	Es el estado del clúster. Los siguientes estados están disponibles: Running: Se creó el clúster y se puede usar. Reconciling: Se está trabajando activamente en el clúster. Deleting: Se está borrando el clúster. Error: Se produjeron algunos errores durante la conciliación o el aprovisionamiento del clúster.
subnets SubnetReference array	Subnets contiene la lista de subredes que se usan para este clúster.

ClusterVersion

Especifica la información de la versión de un clúster de usuario de GDC en una configuración aislada.

Aparece en: - ClusterSpec

Campo	Descripción
kubernetesVersion string	Es la versión de Kubernetes del clúster de usuario de GDC.

ContainerdConfig

Aparece en: - NodeConfigDefaults

Campo	Descripción
privateRegistries arreglo de PrivateRegistry	Especifica los registros privados que se usan para extraer imágenes en el nodo. Containerd es el único entorno de ejecución de contenedor compatible.

LoadBalancer

Especifica la configuración del balanceador de cargas.

Aparece en: - ClusterSpec

Campo	Descripción
ingressServiceIPSize número entero	Es el tamaño de los grupos de IP no superpuestos que usan los servicios con tipo del balanceador de cargas. Si no se establece, se usa el valor predeterminado 20.

NodeConfigDefaults

Aparece en: - NodePoolDefaults

Campo	Descripción
containerdConfig ContainerdConfig	Especifica la configuración de containerd para todos los nodos. Es opcional. Mutable.

Grupo de nodos

Especifica la configuración del recurso personalizado NodePool.

Aparece en: - ClusterSpec

Campo	Descripción
name string	Es el nombre del grupo de nodos.
nodeCount número entero	Es la cantidad deseada de nodos en el grupo de nodos aprovisionado.
machineTypeName string	Nombre de los tipos de máquinas que se usan para aprovisionar nodos.
taints Array de Taint	Son los taints asignados a los nodos de este grupo de nodos.
labels objeto (claves:cadena, valores:cadena)	Son las etiquetas asignadas a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor.
acceleratorOptions AcceleratorConfig	AcceleratorOptions indica la configuración deseada de los aceleradores dentro del NodePool. Solo es válido si el MachineType elegido contiene aceleradores.

NodePoolDefaults

Aparece en: - ClusterSpec

Campo	Descripción
nodeConfigDefaults NodeConfigDefaults	Es la configuración a nivel del clúster para todos los nodos. Es opcional. Mutable.

NodePoolStatus

Define el estado observado de un recurso NodePool.

Aparece en: - ClusterStatus

Campo	Descripción
name string	Es el nombre del grupo de nodos.
conditions arreglo de condiciones	Son las observaciones más recientes del estado del grupo de nodos.
readyNodes número entero	Es la cantidad de nodos que están listos para entregar contenido.
reconcilingNodes número entero	Es la cantidad de nodos que se están conciliando.
stalledNodes número entero	Es la cantidad de nodos que están detenidos.
unknownNodes número entero	Es la cantidad de nodos cuyo estado se desconoce.
readyTimestamp Hora	Es la fecha y hora en que un grupo de nodos se encuentra en estado ready. Este valor nunca cambiará una vez que se establezca.
kubernetesVersion string	Es la versión de Kubernetes que se ejecuta en los nodos de este grupo de nodos.

PrivateRegistry

Aparece en: - ContainerdConfig

Campo	Descripción
host string	Especifica el host del registro privado. Debe constar del host o host:puerto.
caCertSecretRef SecretReference	Especifica el secreto que almacena el paquete de CA del registro privado. El Secret debe estar en el espacio de nombres del clúster o tener la anotación baremetal.cluster.gke.io/mark-source para que se pueda reenviar al espacio de nombres del clúster.
pullCredentialSecretRef SecretReference	Especifica el secreto para la credencial de acceso al registro privado. El Secret debe estar en el espacio de nombres del clúster o tener la anotación baremetal.cluster.gke.io/mark-source para que se pueda reenviar al espacio de nombres del clúster.

ReleaseChannel

Indica a qué canal de versiones está suscrito un clúster.

Aparece en: - ClusterSpec

Campo	Descripción
channel Canal	Si no se configura, el valor predeterminado es UNSPECIFIED.

SubnetReference

SubnetReference contiene la referencia a una subred.

Aparece en: - ClusterStatus

Campo	Descripción
name string
namespace string

UpgradePhaseConfig

Aparece en: - UserClusterUpgradeRequestSpec

Campo	Descripción
maxConcurrency número entero	Es la cantidad máxima de elementos que se pueden actualizar de forma simultánea. -1 para especificar todos los restantes.
completionThreshold número entero	Es el porcentaje de éxito para considerar que este grupo de grupos de nodos se completó.

UpgradeStepStatus

Aparece en: - UserClusterUpgradeRequestStatus

Campo	Descripción
conditions arreglo de condiciones	Conditions representa el estado observado del paso de actualización.
phase número entero	Phase hace un seguimiento del índice de la fase actual.
phaseBatchNames arreglo de cadenas	PhaseBatchNames enumera los nombres de los CR de NodeUpgrade que se están procesando o que se completaron.
startTime Hora	StartTime representa la hora de inicio del paso de actualización.

UserClusterUpgradeRequest

Representa la configuración de una solicitud de actualización de un clúster de usuario, como la referencia del clúster y la versión de Kubernetes de destino.

Aparece en: - UserClusterUpgradeRequestList

Campo	Descripción
apiVersion string	cluster.gdc.goog/v1
kind string	UserClusterUpgradeRequest
metadata ObjectMeta	Consulta la documentación de la API de Kubernetes para conocer los campos de metadata.
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

Representa una colección de recursos UserClusterUpgradeRequest.

Campo	Descripción
apiVersion string	cluster.gdc.goog/v1
kind string	UserClusterUpgradeRequestList
metadata ListMeta	Consulta la documentación de la API de Kubernetes para conocer los campos de metadata.
items UserClusterUpgradeRequest array

UserClusterUpgradeRequestSpec

Proporciona la especificación, como el estado deseado, de un recurso UserClusterUpgradeRequest.

Aparece en: - UserClusterUpgradeRequest

Campo	Descripción
clusterRef LocalObjectReference	Es una referencia al objeto del clúster de usuario de GDC al que se aplica la actualización.
targetVersion string	Es la versión del clúster de usuario de Kubernetes de destino.
nodePoolUpgradePhases Array de UpgradePhaseConfig	Esquema para la paralelización de actualizaciones de nodos
concurrentUpgrades booleano	Es un botón de activación para las actualizaciones simultáneas de ABM del grupo de nodo trabajador. Si se establece en verdadero, se actualizan todos los grupos de nodo trabajador juntos. Si se establece en falso, se actualizan de a uno por vez.
disruption NodeUpgradeDisruption	Disruption define el nivel de interrupción para las actualizaciones de nodos. Si no se configura este campo, las actualizaciones de parches se ejecutan de forma predeterminada sin agotar las cargas de trabajo (NoDisruption). Si se establece este campo en "RequiresWorkloadDrain", se anula ese comportamiento predeterminado y se obliga al sistema a realizar un proceso de drenaje estándar en los nodos. Nota: Este campo se ignora para las actualizaciones de versiones secundarias, que siempre requieren el vaciado de la carga de trabajo.

UserClusterUpgradeRequestStatus

Aparece en: - UserClusterUpgradeRequest

Campo	Descripción
conditions arreglo de condiciones	Es el estado actual de la actualización. Tipos de condiciones conocidos: Succeeded.
startTime Hora	Es la hora de inicio observada para la actualización actual.
cluster UpgradeStepStatus	Cluster representa el estado de actualización del clúster observado.
node UpgradeStepStatus	Node representa el estado de actualización de nodos observado para los nodos del clúster.

VersionStatus

Define la información de la versión instalada del clúster.

Aparece en: - ClusterStatus

Campo	Descripción
componentVersion string	Es la versión del componente del clúster.
kubernetesVersion string	La versión de Kubernetes del clúster.