- Recurso: BareMetalCluster
- Estado
- BareMetalNetworkConfig
- BareMetalIslandModeCidrConfig
- BareMetalMultipleNetworkInterfacesConfig
- BareMetalSrIovConfig
- BareMetalControlPlaneConfig
- BareMetalControlPlaneNodePoolConfig
- BareMetalApiServerArgument
- BareMetalLoadBalancerConfig
- BareMetalVipConfig
- BareMetalPortConfig
- BareMetalMetalLbConfig
- BareMetalLoadBalancerAddressPool
- BareMetalLoadBalancerNodePoolConfig
- BareMetalManualLbConfig
- BareMetalBgpLbConfig
- BareMetalBgpPeerConfig
- BareMetalStorageConfig
- BareMetalProxyConfig
- BareMetalClusterOperationsConfig
- BareMetalMaintenanceConfig
- BareMetalWorkloadNodeConfig
- ContainerRuntime
- BareMetalSecurityConfig
- BareMetalMaintenanceStatus
- BareMetalMachineDrainStatus
- BareMetalDrainingMachine
- BareMetalDrainedMachine
- BareMetalNodeAccessConfig
- BareMetalOsEnvironmentConfig
- BareMetalClusterUpgradePolicy
- NodePoolPolicy
- Métodos
Recurso: BareMetalCluster
Recurso que representa um cluster de utilizadores bare metal.
Representação JSON |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
Campos | |
---|---|
name |
Imutável. O nome do recurso do cluster de utilizadores bare metal. |
adminClusterMembership |
Obrigatório. O cluster de administrador ao qual este cluster de utilizadores bare metal pertence. Este é o nome do recurso completo da associação da frota do cluster de administrador. |
description |
Uma descrição legível deste cluster de utilizador bare metal. |
bareMetalVersion |
Obrigatório. A versão do Anthos clusters on bare metal para o seu cluster de utilizadores. |
uid |
Apenas saída. O identificador exclusivo do cluster de utilizadores bare metal. |
state |
Apenas saída. O estado atual do cluster de utilizadores bare metal. |
endpoint |
Apenas saída. O endereço IP do servidor da API do cluster de utilizadores bare metal. |
reconciling |
Apenas saída. Se estiver definida, existem atualmente alterações em curso no cluster de utilizadores de metal puro. |
createTime |
Apenas saída. A hora em que o cluster de utilizadores de metal exposto foi criado. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
updateTime |
Apenas saída. A hora em que o cluster de utilizadores de metal descoberto foi atualizado pela última vez. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
deleteTime |
Apenas saída. A hora em que o cluster de utilizadores bare metal foi eliminado. Se o recurso não for eliminado, este campo tem de estar vazio Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
localName |
Apenas saída. O nome do objeto do recurso personalizado do cluster de utilizadores bare metal no cluster de administrador associado. Este campo é usado para suportar nomes em conflito quando inscreve clusters existentes na API. Quando usado como parte da inscrição no cluster, este campo difere do nome no nome do recurso. Para novos clusters, este campo vai corresponder ao nome do cluster fornecido pelo utilizador e vai estar visível no último componente do nome do recurso. Não é modificável. Quando o nome local e o nome do cluster diferem, o nome local é usado nos registos do controlador do cluster de administrador. Usa o nome do cluster quando acede ao cluster através do bmctl e do kubectl. |
etag |
Apenas saída. Esta soma de verificação é calculada pelo servidor com base no valor de outros campos e pode ser enviada em pedidos de atualização e eliminação para garantir que o cliente tem um valor atualizado antes de continuar. Permite que os clientes façam leituras-modificações-escritas consistentes através do controlo de concorrência otimista. |
annotations |
Anotações no cluster de utilizadores bare metal. Este campo tem as mesmas restrições que as anotações do Kubernetes. O tamanho total de todas as chaves e valores combinados está limitado a 256 KB. A chave pode ter 2 segmentos: prefixo (opcional) e nome (obrigatório), separados por uma barra (/). O prefixo tem de ser um subdomínio DNS. O nome tem de ter 63 carateres ou menos, começar e terminar com carateres alfanuméricos, com traços (-), sublinhados (_), pontos (.) e carateres alfanuméricos entre eles. Um objeto que contém uma lista de pares |
networkConfig |
Obrigatório. Configuração de rede. |
controlPlane |
Obrigatório. Configuração do plano de controlo. |
loadBalancer |
Obrigatório. Configuração do balanceador de carga. |
storage |
Obrigatório. Configuração de armazenamento. |
proxy |
Configuração do proxy. |
clusterOperations |
Configuração das operações de cluster. |
maintenanceConfig |
Configuração de manutenção. |
nodeConfig |
Configuração do nó de carga de trabalho. |
fleet |
Apenas saída. Configuração da frota para o cluster. |
status |
Apenas saída. Estado detalhado do cluster. |
validationCheck |
Apenas saída. O resultado da verificação prévia. |
securityConfig |
Configuração de definições relacionadas com a segurança. |
maintenanceStatus |
Apenas saída. Estado das tarefas de manutenção em curso. |
adminClusterName |
Apenas saída. O nome do recurso do cluster de administrador bare metal que gere este cluster de utilizadores. |
nodeAccessConfig |
Configurações relacionadas com o acesso aos nós. |
osEnvironmentConfig |
Configurações relacionadas com o ambiente do SO. |
binaryAuthorization |
Configurações relacionadas com a Autorização binária. |
upgradePolicy |
A política de atualização do cluster. |
localNamespace |
Apenas saída. O espaço de nomes do cluster. |
Estado
O estado do ciclo de vida do cluster de utilizadores bare metal.
Enumerações | |
---|---|
STATE_UNSPECIFIED |
Não definido. |
PROVISIONING |
O estado PROVISIONING indica que o cluster está a ser criado. |
RUNNING |
O estado RUNNING indica que o cluster foi criado e está totalmente utilizável. |
RECONCILING |
O estado RECONCILING indica que o cluster está a ser atualizado. Continua disponível, mas potencialmente com um desempenho inferior. |
STOPPING |
O estado STOPPING indica que o cluster está a ser eliminado. |
ERROR |
O estado ERROR indica que o cluster está num estado danificado irrecuperável. |
DEGRADED |
O estado DEGRADED indica que o cluster requer a ação do utilizador para restaurar a funcionalidade completa. |
BareMetalNetworkConfig
Especifica a configuração da rede do cluster.
Representação JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campos | |
---|---|
advancedNetworking |
Permite a utilização de funcionalidades de rede avançadas do Anthos, como o equilíbrio de carga agrupado com BGP ou o gateway NAT de saída. A configuração das definições para funcionalidades de rede avançadas define automaticamente esta flag. |
multipleNetworkInterfacesConfig |
Configuração para várias interfaces de rede. |
srIovConfig |
Configuração para SR-IOV. |
Campo de união cluster_cidr_configuration . A configuração CIDR a ser usada no cluster de utilizadores bare metal. cluster_cidr_configuration só pode ser uma das seguintes opções: |
|
islandModeCidr |
Configuração do CIDR do modo isolado. Numa rede no modo isolado, os nós têm endereços IP únicos, mas os pods não têm endereços únicos em todos os clusters. Isto não causa problemas porque os pods num cluster nunca comunicam diretamente com os pods noutro cluster. Em alternativa, existem gateways que fazem a mediação entre um agrupamento num cluster e um agrupamento noutro cluster. |
BareMetalIslandModeCidrConfig
Especifica a configuração CIDR do cluster durante a execução no modo isolado.
Representação JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
serviceAddressCidrBlocks[] |
Obrigatório. Todos os serviços no cluster têm um endereço IPv4 RFC1918 atribuído a partir destes intervalos. Este campo é mutável após a criação a partir da versão 1.15. |
podAddressCidrBlocks[] |
Obrigatório. Todos os pods no cluster têm um endereço IPv4 RFC1918 atribuído a partir destes intervalos. Não é possível alterar este campo após a criação. |
BareMetalMultipleNetworkInterfacesConfig
Especifica a configuração do cluster de várias interfaces de rede.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Se deve ativar várias interfaces de rede para os seus pods. Quando é definido, networkConfig.advanced_networking é automaticamente definido como verdadeiro. |
BareMetalSrIovConfig
Especifica a configuração do operador de rede SR-IOV.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Se deve instalar o operador SR-IOV. |
BareMetalControlPlaneConfig
Especifica a configuração do plano de controlo.
Representação JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Campos | |
---|---|
controlPlaneNodePoolConfig |
Obrigatório. Configura o node pool que executa o plano de controlo. |
apiServerArgs[] |
Personaliza os argumentos do servidor da API predefinidos. Apenas é suportado um subconjunto de flags personalizadas. Para o formato exato, consulte a documentação do servidor da API. |
BareMetalControlPlaneNodePoolConfig
Especifica a configuração do node pool do plano de controlo.
Representação JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
Obrigatório. A configuração genérica de um node pool que executa o plano de controlo. |
BareMetalApiServerArgument
Representa um par nome->valor de arg. Apenas é suportado um subconjunto de flags personalizadas. Para o formato exato, consulte a documentação do servidor da API.
Representação JSON |
---|
{ "argument": string, "value": string } |
Campos | |
---|---|
argument |
Obrigatório. O nome do argumento, tal como aparece na linha de comandos do servidor da API. Certifique-se de que remove os traços iniciais. |
value |
Obrigatório. O valor do argumento, tal como será transmitido à linha de comandos do servidor da API. |
BareMetalLoadBalancerConfig
Especifica a configuração do balanceador de carga.
Representação JSON |
---|
{ "vipConfig": { object ( |
Campos | |
---|---|
vipConfig |
Os IPs virtuais usados pelo balanceador de carga. |
portConfig |
Configura as portas nas quais o balanceador de carga vai escutar. |
Campo de união load_balancer_configuration . A configuração do equilibrador de carga para o cluster de utilizadores bare metal. load_balancer_configuration só pode ser uma das seguintes opções: |
|
metalLbConfig |
Configuração para balanceadores de carga do MetalLB. |
manualLbConfig |
Balanceadores de carga configurados manualmente. |
bgpLbConfig |
Configuração para equilibradores de carga com tipo BGP. Quando é definido, networkConfig.advanced_networking é automaticamente definido como verdadeiro. |
BareMetalVipConfig
Especifica a configuração do VIP para o equilibrador de carga de metal exposto.
Representação JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campos | |
---|---|
controlPlaneVip |
O IP virtual que reservou anteriormente para a API Kubernetes deste cluster de utilizadores bare metal. |
ingressVip |
O VIP que reservou anteriormente para o tráfego de entrada neste cluster de utilizadores bare metal. |
BareMetalPortConfig
Especifica as portas do equilibrador de carga para o cluster de utilizadores de metal sem revestimento.
Representação JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
controlPlaneLoadBalancerPort |
A porta na qual os balanceadores de carga alojados no plano de controlo vão escutar. |
BareMetalMetalLbConfig
Representa parâmetros de configuração para um equilibrador de carga do MetalLB.
Representação JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
addressPools[] |
Obrigatório. AddressPools é uma lista de pools de IPs não sobrepostos usados por serviços com tipos de balanceadores de carga. Todos os endereços têm de ser encaminháveis para os nós do equilibrador de carga. O IngressVIP tem de estar incluído nos pools. |
loadBalancerNodePoolConfig |
Especifica o conjunto de nós que executa o balanceador de carga. É necessária conetividade L2 entre os nós neste conjunto. Se estiver em falta, o conjunto de nós do plano de controlo é usado como o conjunto do balanceador de carga. |
BareMetalLoadBalancerAddressPool
Representa um conjunto de IPs usado pelo balanceador de carga.
Representação JSON |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
Campos | |
---|---|
pool |
Obrigatório. O nome do conjunto de endereços. |
addresses[] |
Obrigatório. As moradas que fazem parte deste conjunto. Cada endereço tem de estar no formato CIDR (1.2.3.0/24) ou no formato de intervalo (1.2.3.1-1.2.3.5). |
avoidBuggyIps |
Se for verdade, evite usar IPs que terminem em .0 ou .255. Isto evita que os dispositivos de consumo com erros rejeitem por engano o tráfego IPv4 para esses endereços IP especiais. |
manualAssign |
Se o valor for verdadeiro, impede que os endereços IP sejam atribuídos automaticamente. |
BareMetalLoadBalancerNodePoolConfig
Especifica a configuração do node pool do equilibrador de carga.
Representação JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
A configuração genérica de um conjunto de nós que executa um balanceador de carga. |
BareMetalManualLbConfig
Representa os parâmetros de configuração de um equilibrador de carga manual.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Se o balanceamento de carga manual está ativado. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig representa os parâmetros de configuração de um equilibrador de carga do Border Gateway Protocol (BGP).
Representação JSON |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
Campos | |
---|---|
asn |
Obrigatório. Número do sistema autónomo (ASN) do BGP do cluster. Este campo pode ser atualizado após a criação do cluster. |
bgpPeerConfigs[] |
Obrigatório. A lista de pares BGP aos quais o cluster se vai ligar. Tem de configurar, pelo menos, um par para cada nó do plano de controlo. Os nós do plano de controlo ligam-se a estes pares para anunciar o VIP do plano de controlo. O balanceador de carga dos serviços também usa estes pares por predefinição. Este campo pode ser atualizado após a criação do cluster. |
addressPools[] |
Obrigatório. AddressPools é uma lista de pools de IPs não sobrepostos usados por serviços com tipos de balanceadores de carga. Todos os endereços têm de ser encaminháveis para os nós do equilibrador de carga. O IngressVIP tem de estar incluído nos pools. |
loadBalancerNodePoolConfig |
Especifica o conjunto de nós que executa o equilíbrio de carga do plano de dados. É necessária conetividade L2 entre os nós neste conjunto. Se estiver em falta, o conjunto de nós do plano de controlo é usado para o equilíbrio de carga do plano de dados. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig representa os parâmetros de configuração de um par do Border Gateway Protocol (BGP).
Representação JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Campos | |
---|---|
asn |
Obrigatório. Número do sistema autónomo (ASN) do BGP para a rede que contém o dispositivo de pares externo. |
ipAddress |
Obrigatório. O endereço IP do dispositivo externo de pares. |
controlPlaneNodes[] |
O endereço IP do nó do plano de controlo que se liga ao par externo. Se não especificar nós do plano de controlo, todos os nós do plano de controlo podem estabelecer ligação ao par externo. Se especificar um ou mais endereços IP, apenas os nós especificados participam em sessões de peering. |
BareMetalStorageConfig
BareMetalStorageConfig especifica a configuração de armazenamento do cluster.
Representação JSON |
---|
{ "lvpShareConfig": { object ( |
Campos | |
---|---|
lvpShareConfig |
Obrigatório. Especifica a configuração para PersistentVolumes locais suportados por subdiretórios num sistema de ficheiros partilhado. Estes subdiretórios são criados automaticamente durante a criação do cluster. |
lvpNodeMountsConfig |
Obrigatório. Especifica a configuração para PersistentVolumes locais suportados por discos de nós montados. Estes discos têm de ser formatados e montados pelo utilizador, o que pode ser feito antes ou depois da criação do cluster. |
BareMetalProxyConfig
Especifica a configuração do proxy do cluster.
Representação JSON |
---|
{ "uri": string, "noProxy": [ string ] } |
Campos | |
---|---|
uri |
Obrigatório. Especifica o endereço do seu servidor proxy. Exemplos: Não faculte credenciais no formato |
noProxy[] |
Uma lista de IPs, nomes de anfitriões e domínios que devem ignorar o proxy. Exemplos: ["127.0.0.1", "example.com", ".corp", "localhost"]. |
BareMetalClusterOperationsConfig
Especifica a infraestrutura de observabilidade do cluster de utilizadores bare metal.
Representação JSON |
---|
{ "enableApplicationLogs": boolean } |
Campos | |
---|---|
enableApplicationLogs |
Se a recolha de registos/métricas da aplicação deve ser ativada (além dos registos/métricas do sistema). |
BareMetalMaintenanceConfig
Especifica as configurações para colocar os nós de metal nu em manutenção e retirá-los da mesma.
Representação JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
maintenanceAddressCidrBlocks[] |
Obrigatório. Todos os endereços IPv4 destes intervalos vão ser colocados em modo de manutenção. Os nós no modo de manutenção são isolados e esvaziados. Quando ambas as condições são verdadeiras, a anotação "baremetal.cluster.gke.io/maintenance" é definida no recurso do nó. |
BareMetalWorkloadNodeConfig
Especifica as configurações dos nós de carga de trabalho.
Representação JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campos | |
---|---|
maxPodsPerNode |
O número máximo de pods que um nó pode executar. O tamanho do intervalo CIDR atribuído ao nó é derivado deste parâmetro. |
containerRuntime |
Especifica o tempo de execução do contentor que vai ser usado. |
ContainerRuntime
O tempo de execução usado para executar contentores neste cluster de utilizadores.
Enumerações | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Nenhum tempo de execução do contentor selecionado. |
CONTAINERD |
Tempo de execução do Containerd. |
BareMetalSecurityConfig
Especifica as definições relacionadas com a segurança para o cluster de utilizadores bare metal.
Representação JSON |
---|
{
"authorization": {
object ( |
Campos | |
---|---|
authorization |
Configura o acesso do utilizador ao cluster de utilizadores. |
BareMetalMaintenanceStatus
Representa o estado de manutenção do cluster de utilizadores bare metal.
Representação JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machineDrainStatus |
O estado de manutenção das máquinas de nós. |
BareMetalMachineDrainStatus
Representa o estado das máquinas de nós que estão a ser submetidas a operações de drenagem.
Representação JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
drainingMachines[] |
A lista de máquinas com drenagem. |
drainedMachines[] |
A lista de máquinas com bateria descarregada. |
BareMetalDrainingMachine
Representa uma máquina que está atualmente a consumir energia.
Representação JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campos | |
---|---|
nodeIp |
Endereço IP da máquina de drenagem. |
podCount |
A contagem de pods que ainda não foram esvaziados. |
BareMetalDrainedMachine
Representa uma máquina que está atualmente sem energia.
Representação JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
nodeIp |
Endereço IP da máquina esgotado. |
BareMetalNodeAccessConfig
Especifica as definições relacionadas com o acesso aos nós para o cluster de utilizadores bare metal.
Representação JSON |
---|
{ "loginUser": string } |
Campos | |
---|---|
loginUser |
LoginUser é o nome de utilizador usado para aceder a máquinas de nós. A predefinição é "root" em caso de não definição. |
BareMetalOsEnvironmentConfig
Especifica as definições do sistema operativo para o aprovisionamento de clusters.
Representação JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
packageRepoExcluded |
Se o repositório de pacotes não deve ser incluído ao inicializar máquinas de metal nu. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy define a política de atualização do cluster.
Representação JSON |
---|
{
"policy": enum ( |
Campos | |
---|---|
policy |
Especifica a política de atualização a usar. |
pause |
Apenas saída. A pausa é usada para mostrar o estado de pausa da atualização. Por agora, é apenas de visualização. |
NodePoolPolicy
Especifica a política de atualização para os grupos de nós de trabalho.
Enumerações | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Nenhuma política de atualização selecionada. |
SERIAL |
Atualize os node pools de trabalhadores sequencialmente. |
CONCURRENT |
Atualize todos os conjuntos de nós de trabalho em paralelo. |
Métodos |
|
---|---|
|
Cria um novo cluster bare metal num determinado projeto e localização. |
|
Elimina um único cluster bare metal. |
|
Inscreve um cluster de utilizadores bare metal existente e os respetivos pools de nós na API Anthos On-Prem num determinado projeto e localização. |
|
Obtém detalhes de um único cluster bare metal. |
|
Apresenta clusters bare metal num determinado projeto e localização. |
|
Atualiza os parâmetros de um único cluster bare metal. |
|
Consulta a configuração da versão do cluster de utilizadores bare metal. |