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 Cluster.

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 Cluster

ClusterNetwork

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

Aparece en: - ClusterSpec

Campo	Descripción
podCIDRSize número entero	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: - Clúster

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. 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. Opcional. Mutable.
clusterNetwork ClusterNetwork	Es la configuración de la red del clúster. Si no se configura, se usan los tamaños predeterminados de CIDR de pod y servicio. 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. Opcional. Mutable.
nodePools arreglo de NodePool	Es la lista de grupos de nodos para los nodos trabajadores del clúster. Opcional. Mutable.
nodePoolDefaults NodePoolDefaults	Es la configuración a nivel del clúster para todos los grupos de nodos. 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: - Clúster

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: El clúster se creó 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.

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 contenedores 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 que no se superponen y 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. 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. 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.

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ó.

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 las actualizaciones de nodos
concurrentUpgrades booleano	Alternar para actualizaciones simultáneas de ABM de grupos 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.

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.

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.