KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

Contém definições do esquema da API para o grupo Cluster.

AcceleratorConfig

Aparece em: - NodePool

Campo	Descrição
gpuPartitionScheme string	GPUPartitionScheme indica o esquema que vai ser usado para particionar as GPUs em MIGs. Este esquema e o DeviceModel da GPU decidem em conjunto os perfis de MIG. Por exemplo, mixed-1 no H100L 94GB determina em conjunto que a GPU seja dividida em uma 4g.47gb e uma 3g.47gb.

Canal

Tipo subjacente: string Indica um tipo específico de canal de lançamento.

Aparece em: - ReleaseChannel

Cluster

Especifica um cluster de utilizadores do GDC numa configuração isolada.

Aparece em: - ClusterList

Campo	Descrição
apiVersion string	cluster.gdc.goog/v1
kind string	Cluster
metadata ObjectMeta	Consulte a documentação da API Kubernetes para os campos de metadata.
spec ClusterSpec
status ClusterStatus

ClusterList

Representa uma coleção de clusters.

Campo	Descrição
apiVersion string	cluster.gdc.goog/v1
kind string	ClusterList
metadata ListMeta	Consulte a documentação da API Kubernetes para os campos de metadata.
items Matriz de clusters

ClusterNetwork

Especifica a configuração da rede do cluster.

Aparece em: - ClusterSpec

Campo	Descrição
podCIDRSize número inteiro	O tamanho dos intervalos de rede a partir dos quais os endereços IP virtuais do pod são atribuídos. Se não estiver definida, é usado um valor predefinido 21.
serviceCIDRSize número inteiro	O tamanho dos intervalos de rede a partir dos quais os endereços IP virtuais de serviço são atribuídos. Se não estiver definida, é usado um valor predefinido 23.

ClusterSpec

Aparece em: - Cluster

Campo	Descrição
initialVersion ClusterVersion	As informações da versão com isolamento de ar do GDC do cluster de utilizadores durante a criação do cluster. Opcional. Usar por predefinição a versão aplicável mais recente. Imutável.
releaseChannel ReleaseChannel	O canal de lançamento ao qual um cluster está subscrito. Quando um cluster está subscrito num canal de lançamento, o GDC mantém as versões do cluster para os utilizadores. Opcional. Mutável.
clusterNetwork ClusterNetwork	A configuração da rede do cluster. Se não estiver definida, são usadas as configurações predefinidas com tamanhos CIDR de pods e serviços. Opcional. Mutável.
loadBalancer LoadBalancer	A configuração do balanceador de carga. Se não estiver definida, é usada a configuração predefinida com o tamanho do endereço IP do serviço de entrada. Opcional. Mutável.
nodePools NodePool	A lista de conjuntos de nós para os nós de trabalho do cluster. Opcional. Mutável.
nodePoolDefaults NodePoolDefaults	A configuração ao nível do cluster para todos os conjuntos de nós. Opcional. Mutável.

ClusterState

Tipo subjacente: string indica o estado do cluster.

Aparece em: - ClusterStatus

ClusterStatus

Define o estado observado do cluster.

Aparece em: - Cluster

Campo	Descrição
conditions Matriz de condições	As observações mais recentes do estado do cluster. Condições como Reconciling e Stalled indicam se a última conciliação do cluster foi bem-sucedida.
errorStatus ErrorStatus	O estado de erro observado do cluster.
workerNodePoolStatuses NodePoolStatus array	Uma lista dos estados observados dos conjuntos de nós de trabalho.
controlPlaneConditions Matriz de condições	Se o plano de controlo está pronto.
componentsConditions Matriz de condições	Indica se os componentes do cluster de utilizadores foram implementados com êxito.
versionStatus VersionStatus	As informações da versão instalada do cluster.
clusterState ClusterState	O estado do cluster. Estão disponíveis os seguintes estados: Running: o cluster foi criado e está pronto a ser usado. Reconciling: está a ser feito algum trabalho ativamente no cluster. Deleting: o cluster está a ser eliminado. Error: ocorreram alguns erros durante a conciliação/aprovisionamento do cluster.
subnets SubnetReference	Subnets contém a lista de sub-redes que são usadas para este cluster.

ClusterVersion

Especifica as informações da versão de um cluster de utilizadores do GDC numa configuração isolada do exterior.

Aparece em: - ClusterSpec

Campo	Descrição
kubernetesVersion string	A versão do Kubernetes do cluster de utilizadores do GDC.

ContainerdConfig

Aparece em: - NodeConfigDefaults

Campo	Descrição
privateRegistries PrivateRegistry array	Especifica registos privados usados para extrair imagens no nó. O Containerd é o único tempo de execução de contentores suportado.

LoadBalancer

Especifica a configuração do balanceador de carga.

Aparece em: - ClusterSpec

Campo	Descrição
ingressServiceIPSize número inteiro	O tamanho dos conjuntos de IPs não sobrepostos usados pelos serviços introduzidos do balanceador de carga. Se não estiver definida, é usado um valor predefinido 20.

NodeConfigDefaults

Aparece em: - NodePoolDefaults

Campo	Descrição
containerdConfig ContainerdConfig	Especifica a configuração do containerd para todos os nós. Opcional. Mutável.

NodePool

Especifica a NodePool configuração de recursos personalizados.

Aparece em: - ClusterSpec

Campo	Descrição
name string	O nome do conjunto de nós.
nodeCount número inteiro	O número desejado de nós no conjunto de nós aprovisionado.
machineTypeName string	O nome dos tipos de máquinas que são usados para aprovisionar nós.
taints Matriz de contaminação	As restrições atribuídas aos nós deste conjunto de nós.
labels objeto (chaves:string, valores:string)	As etiquetas atribuídas aos nós deste conjunto de nós. Contém uma lista de pares de chave/valor.
acceleratorOptions AcceleratorConfig	AcceleratorOptions indica a configuração desejada dos aceleradores no NodePool. Só é válido se o MachineType escolhido contiver aceleradores.

NodePoolDefaults

Aparece em: - ClusterSpec

Campo	Descrição
nodeConfigDefaults NodeConfigDefaults	A configuração ao nível do cluster para todos os nós. Opcional. Mutável.

NodePoolStatus

Define o estado observado de um recurso NodePool.

Aparece em: - ClusterStatus

Campo	Descrição
name string	O nome do conjunto de nós.
conditions Matriz de condições	As observações mais recentes do estado do conjunto de nós.
readyNodes número inteiro	O número de nós que estão prontos para publicação.
reconcilingNodes número inteiro	O número de nós que estão a ser reconciliados.
stalledNodes número inteiro	O número de nós que estão parados.
unknownNodes número inteiro	O número de nós cujos estados são desconhecidos.
readyTimestamp Hora	O tempo que um node pool está no estado ready. Este valor nunca muda depois de ser definido.
kubernetesVersion string	A versão do Kubernetes em execução nos nós deste node pool.

PrivateRegistry

Aparece em: - ContainerdConfig

Campo	Descrição
host string	Especifica o anfitrião do registo privado. Tem de consistir no anfitrião ou no anfitrião:porta.
caCertSecretRef SecretReference	Especifica o segredo que armazena o pacote de AC do registo privado. O segredo tem de estar no espaço de nomes do cluster ou ter a anotação baremetal.cluster.gke.io/mark-source para poder ser encaminhado para o espaço de nomes do cluster.
pullCredentialSecretRef SecretReference	Especifica o segredo da credencial de acesso ao registo privado. O segredo tem de estar no espaço de nomes do cluster ou ter a anotação baremetal.cluster.gke.io/mark-source para poder ser encaminhado para o espaço de nomes do cluster.

ReleaseChannel

Indica o canal de lançamento ao qual um cluster está subscrito.

Aparece em: - ClusterSpec

Campo	Descrição
channel Canal	Se não estiver definida, a predefinição é UNSPECIFIED.

SubnetReference

SubnetReference contém a referência a uma sub-rede.

Aparece em: - ClusterStatus

Campo	Descrição
name string
namespace string

UpgradePhaseConfig

Aparece em: - UserClusterUpgradeRequestSpec

Campo	Descrição
maxConcurrency número inteiro	Número máximo de elementos a atualizar em simultâneo. -1 para especificar todos os restantes.
completionThreshold número inteiro	Percentagem de êxito para considerar este grupo de pools de nós como concluído.

UpgradeStepStatus

Aparece em: - UserClusterUpgradeRequestStatus

Campo	Descrição
conditions Matriz de condições	As condições representam o estado observado da etapa de atualização.
phase número inteiro	A fase acompanha o índice da fase atual.
phaseBatchNames matriz de strings	PhaseBatchNames apresenta os nomes dos CRs NodeUpgrade que estão a ser processados ou foram concluídos.
startTime Hora	StartTime representa a hora de início do passo de atualização.

UserClusterUpgradeRequest

Representa a configuração de um pedido de atualização de um cluster de utilizador, como a referência do cluster e a versão do Kubernetes de destino.

Aparece em: - UserClusterUpgradeRequestList

Campo	Descrição
apiVersion string	cluster.gdc.goog/v1
kind string	UserClusterUpgradeRequest
metadata ObjectMeta	Consulte a documentação da API Kubernetes para os campos de metadata.
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

Representa uma coleção de UserClusterUpgradeRequest recursos.

Campo	Descrição
apiVersion string	cluster.gdc.goog/v1
kind string	UserClusterUpgradeRequestList
metadata ListMeta	Consulte a documentação da API Kubernetes para os campos de metadata.
items UserClusterUpgradeRequest

UserClusterUpgradeRequestSpec

Fornece a especificação, como o estado pretendido, de um recurso UserClusterUpgradeRequest.

Aparece em: - UserClusterUpgradeRequest

Campo	Descrição
clusterRef LocalObjectReference	Uma referência ao objeto de cluster de utilizadores do GDC ao qual a atualização se aplica.
targetVersion string	A versão do cluster de utilizadores do Kubernetes de destino.
nodePoolUpgradePhases UpgradePhaseConfig	Esquema para paralelização de atualizações de nós
concurrentUpgrades booleano	Ative/desative a opção para atualizações de ABM de node pool de trabalho simultâneas. Se for Verdadeiro, atualiza todos os node pools de trabalho em conjunto. Se for Falso, atualiza um de cada vez.
disruption NodeUpgradeDisruption	A disrupção define o nível de disrupção para as atualizações de nós. Se este campo não estiver definido, as atualizações de patches são executadas por predefinição sem esgotar as cargas de trabalho (NoDisruption). Se definir este campo como "RequiresWorkloadDrain", substitui esse comportamento predefinido, o que força o sistema a executar um processo de drenagem padrão nos nós. Nota: este campo é ignorado para atualizações de versões secundárias, que requerem sempre a drenagem da carga de trabalho.

UserClusterUpgradeRequestStatus

Aparece em: - UserClusterUpgradeRequest

Campo	Descrição
conditions Matriz de condições	O estado de atualização atual. Tipos de condições conhecidas: Succeeded.
startTime Hora	A hora de início observada para a atualização atual.
cluster UpgradeStepStatus	Cluster representa o estado de atualização do cluster observado.
node UpgradeStepStatus	O nó representa o estado de atualização do nó observado para os nós do cluster.

VersionStatus

Define as informações da versão instalada do cluster.

Aparece em: - ClusterStatus

Campo	Descrição
componentVersion string	A versão do componente do cluster.
kubernetesVersion string	A versão do Kubernetes do cluster.