REST Resource: projects.locations.bareMetalAdminClusters

Recurso: BareMetalAdminCluster

Recurso que representa um cluster de administrador de bare metal.

Representação JSON 
{
  "name": string,
  "description": string,
  "uid": string,
  "bareMetalVersion": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalAdminNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalAdminControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalAdminLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalAdminStorageConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "clusterOperations": {
    object (BareMetalAdminClusterOperationsConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "maintenanceConfig": {
    object (BareMetalAdminMaintenanceConfig)
  },
  "maintenanceStatus": {
    object (BareMetalAdminMaintenanceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "nodeConfig": {
    object (BareMetalAdminWorkloadNodeConfig)
  },
  "proxy": {
    object (BareMetalAdminProxyConfig)
  },
  "securityConfig": {
    object (BareMetalAdminSecurityConfig)
  },
  "nodeAccessConfig": {
    object (BareMetalAdminNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalAdminOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
Campos
name

string

Imutável. O nome do recurso do cluster de administrador bare metal.
description

string

Uma descrição legível deste cluster de administrador bare metal.
uid

string

Apenas saída. O identificador exclusivo do cluster de administrador bare metal.
bareMetalVersion

string

A versão do Anthos em bare metal para o cluster de administrador.
state

enum (State)

Apenas saída. O estado atual do cluster de administrador bare metal.
endpoint

string

Apenas saída. O nome do endereço IP do servidor da API do cluster de administrador bare metal.
reconciling

boolean

Apenas saída. Se definido, há mudanças em andamento no cluster de administrador de bare metal.
createTime

string (Timestamp format)

Apenas saída. O horário em que esse cluster de administrador de bare metal foi criado.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos.Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A hora em que o cluster de administrador de bare metal foi atualizado pela última vez.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos.Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Apenas saída. O horário em que o cluster de administrador de bare metal foi excluído. Se o recurso não for excluído, este campo precisa estar vazio.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos.Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
localName

string

Apenas saída. O nome do objeto do recurso personalizado do cluster bare metal. Esse campo é usado para oferecer suporte a nomes conflitantes ao registrar clusters na API. Quando usado como parte da inscrição no cluster, esse campo é diferente do ID no nome do recurso. Para novos clusters, esse campo vai corresponder ao nome do cluster fornecido pelo usuário e vai ficar visível no último componente do nome do recurso. Não é possível modificá-lo.

Todos os usuários precisam usar esse nome para acessar o cluster usando o gkectl ou o kubectl e devem encontrar o nome local ao consultar os registros do controlador do cluster de administrador.
etag

string

Essa checksum é calculada pelo servidor com base no valor de outros campos e pode ser enviada em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir. Permite que os clientes realizem leituras e modificações da gravação consistentes por meio do controle otimista de simultaneidade.
annotations

map (key: string, value: string)

Anotações no cluster de administrador 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 é limitado a 256 mil. A chave pode ter dois segmentos: prefixo (opcional) e nome (exigido), separados por uma barra (/). O prefixo precisa ser um subdomínio DNS. O nome deve ter 63 caracteres ou menos, começar e terminar com caracteres alfanuméricos, com traços (-), sublinhados (_), pontos (.) e caracteres alfanuméricos entre eles.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
networkConfig

object (BareMetalAdminNetworkConfig)

Configuração de rede.
controlPlane

object (BareMetalAdminControlPlaneConfig)

Configuração do plano de controle.
loadBalancer

object (BareMetalAdminLoadBalancerConfig)

Configuração do balanceador de carga.
storage

object (BareMetalAdminStorageConfig)

Configuração de armazenamento.
fleet

object (Fleet)

Apenas saída. Configuração da frota para o cluster.
clusterOperations

object (BareMetalAdminClusterOperationsConfig)

Configuração das operações do cluster.
status

object (ResourceStatus)

Apenas saída. ResourceStatus que representa o status detalhado do cluster.
maintenanceConfig

object (BareMetalAdminMaintenanceConfig)

Configuração de manutenção.
maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

Apenas saída. MaintenanceStatus que representa o estado da manutenção.
validationCheck

object (ValidationCheck)

Apenas saída. ValidationCheck, que representa o resultado da verificação de simulação.
nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

Configuração do nó de carga de trabalho.
proxy

object (BareMetalAdminProxyConfig)

Configuração de proxy.
securityConfig

object (BareMetalAdminSecurityConfig)

Configuração relacionada à segurança.
nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

Configurações relacionadas ao acesso ao nó.
osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

Configurações relacionadas ao ambiente do SO.
binaryAuthorization

object (BinaryAuthorization)

Configurações relacionadas à autorização binária.

Estado

O estado do ciclo de vida do cluster de administrador bare metal.

Enums
STATE_UNSPECIFIED Não definido
PROVISIONING O estado PROVISIONING indica que o cluster está sendo criado.
RUNNING O estado RUNNING indica que o cluster foi criado e é totalmente utilizável.
RECONCILING O estado RECONCILING indica que o cluster está sendo atualizado. Ele continua disponível, mas com desempenho potencialmente prejudicado.
STOPPING O estado STOPPING indica que o cluster está sendo excluído.
ERROR O estado ERROR indica que o cluster está em um estado corrompido e irrecuperável.
DEGRADED O estado DEGRADED indica que o cluster exige uma ação do usuário para restaurar a funcionalidade completa.

BareMetalAdminNetworkConfig

O BareMetalAdminNetworkConfig especifica a configuração de rede do cluster.

Representação JSON 
{

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalAdminIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
Campos
Campo de união cluster_cidr_configuration. A configuração CIDR a ser usada no cluster de administrador. cluster_cidr_configuration pode ser apenas de um dos tipos a seguir:
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

Configuração para o CIDR do modo "ilha".

BareMetalAdminIslandModeCidrConfig

O BareMetalAdminIslandModeCidrConfig especifica a configuração CIDR do cluster durante a execução no modo de ilha.

Representação JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Campos
serviceAddressCidrBlocks[]

string

Obrigatório. Todos os serviços do cluster recebem um endereço IPv4 RFC1918 desses intervalos. Este campo não pode ser alterado após a criação.
podAddressCidrBlocks[]

string

Obrigatório. Todos os pods no cluster recebem um endereço IPv4 RFC1918 desses intervalos. Este campo não pode ser alterado após a criação.

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig especifica a configuração do plano de controle.

Representação JSON 
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
Campos
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

Obrigatório. Configura o pool de nós que executa o plano de controle. Se especificado, o NodePool correspondente será criado para o plano de controle do cluster. O NodePool terá o mesmo nome e namespace do cluster.
apiServerArgs[]

object (BareMetalAdminApiServerArgument)

Personaliza os argumentos padrão do servidor de API. Apenas um subconjunto de sinalizações personalizadas é compatível. Consulte a documentação do servidor da API abaixo para saber o formato exato: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig especifica a configuração do pool de nós do plano de controle. Temos uma configuração de pool de nós específica do plano de controle para que possamos oferecer suporte flexível a campos específicos do plano de controle no futuro.

Representação JSON 
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Campos
nodePoolConfig

object (BareMetalNodePoolConfig)

Obrigatório. A configuração genérica de um pool de nós que executa o plano de controle.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument representa um par de nome->valor de argumento. Apenas um subconjunto de sinalizações personalizadas é compatível. Consulte a documentação do servidor da API abaixo para saber o formato exato: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

Representação JSON 
{
  "argument": string,
  "value": string
}
Campos
argument

string

Obrigatório. O nome do argumento conforme aparece na linha de comando do servidor da API. Remova os traços iniciais.
value

string

Obrigatório. O valor do argumento, que será transmitido para a linha de comando do servidor da API.

BareMetalAdminLoadBalancerConfig

O BareMetalAdminLoadBalancerConfig especifica a configuração do balanceador de carga.

Representação JSON 
{
  "vipConfig": {
    object (BareMetalAdminVipConfig)
  },
  "portConfig": {
    object (BareMetalAdminPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "manualLbConfig": {
    object (BareMetalAdminManualLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Campos
vipConfig

object (BareMetalAdminVipConfig)

Os VIPs usados pelo balanceador de carga.
portConfig

object (BareMetalAdminPortConfig)

Configura as portas que o balanceador de carga vai detectar.
Campo de união load_balancer_configuration. A configuração do balanceador de carga a ser usada no cluster de administrador. load_balancer_configuration pode ser apenas de um dos tipos a seguir:
manualLbConfig

object (BareMetalAdminManualLbConfig)

Balanceadores de carga configurados manualmente.

BareMetalAdminVipConfig

BareMetalAdminVipConfig para configurações de balanceadores de carga bare metal.

Representação JSON 
{
  "controlPlaneVip": string
}
Campos
controlPlaneVip

string

O VIP que você reservou anteriormente para a API Kubernetes desse cluster de administrador bare metal.

BareMetalAdminPortConfig

BareMetalAdminPortConfig é a especificação das portas do balanceador de carga.

Representação JSON 
{
  "controlPlaneLoadBalancerPort": integer
}
Campos
controlPlaneLoadBalancerPort

integer

A porta em que os balanceadores de carga hospedados no plano de controle vão detectar.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig representa parâmetros de configuração para um balanceador de carga manual.

Representação JSON 
{
  "enabled": boolean
}
Campos
enabled

boolean

Indica se o balanceamento de carga manual está ativado.

BareMetalAdminStorageConfig

O BareMetalAdminStorageConfig especifica a configuração de armazenamento do cluster.

Representação JSON 
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Campos
lvpShareConfig

object (BareMetalLvpShareConfig)

Obrigatório. Especifica a configuração de PersistentVolumes locais com backup em subdiretórios em um sistema de arquivos compartilhado. Esses subdiretórios são criados automaticamente durante a criação do cluster.
lvpNodeMountsConfig

object (BareMetalLvpConfig)

Obrigatório. Especifica a configuração dos PersistentVolumes locais com suporte de discos de nó montados. Esses discos precisam ser formatados e montados pelo usuário, o que pode ser feito antes ou depois da criação do cluster.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig especifica a infraestrutura de observabilidade do cluster de administrador.

Representação JSON 
{
  "enableApplicationLogs": boolean
}
Campos
enableApplicationLogs

boolean

Se a coleta de registros/métricas do aplicativo precisa ser ativada (além dos registros/métricas do sistema).

BareMetalAdminMaintenanceConfig

O BareMetalAdminMaintenanceConfig especifica configurações para colocar e remover nós de CRDs de cluster de administrador bare metal da manutenção.

Representação JSON 
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Campos
maintenanceAddressCidrBlocks[]

string

Obrigatório. Todos os endereços IPv4 desses intervalos serão colocados no modo de manutenção. Os nós no modo de manutenção serão isolados e esvaziados. Quando ambos forem verdadeiros, a anotação "baremetal.cluster.gke.io/maintenance" será definida no recurso do nó.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus representa o status de manutenção dos nós do CR do cluster de administrador de bare metal.

Representação JSON 
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
Campos
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

Representa o status de nós de máquina drenados e em drenagem. Isso é usado para mostrar o progresso do upgrade do cluster.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus representa o status das máquinas de nó bare metal que estão passando por operações de drenagem.

Representação JSON 
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
Campos
drainingMachines[]

object (BareMetalAdminDrainingMachine)

A lista de máquinas de drenagem.
drainedMachines[]

object (BareMetalAdminDrainedMachine)

A lista de máquinas drenadas.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine representa as máquinas que estão sendo drenadas.

Representação JSON 
{
  "nodeIp": string,
  "podCount": integer
}
Campos
nodeIp

string

Endereço IP da máquina de drenagem.
podCount

integer

A contagem de pods que ainda não foram drenados.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine representa as máquinas que foram drenadas.

Representação JSON 
{
  "nodeIp": string
}
Campos
nodeIp

string

Endereço IP da máquina drenada.

BareMetalAdminWorkloadNodeConfig

O BareMetalAdminWorkloadNodeConfig especifica as configurações do nó de carga de trabalho.

Representação JSON 
{
  "maxPodsPerNode": string
}
Campos
maxPodsPerNode

string (int64 format)

O número máximo de pods que um nó pode executar. O tamanho do intervalo CIDR atribuído ao nó será derivado desse parâmetro. Por padrão, 110 pods são criados por nó. O limite máximo é 250 para clusters de administrador HA e não HA. O limite mínimo é 64 para clusters de administrador que não são HA e 32 para clusters de administrador HA.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig especifica a configuração do proxy do cluster.

Representação JSON 
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Campos
uri

string

Obrigatório. Especifica o endereço do servidor proxy. Exemplos: http://domain

AVISO: não forneça credenciais no formato http://(username:password@)domain. Elas serão rejeitadas pelo servidor.
noProxy[]

string

Uma lista de IPs, nomes de host e domínios que não precisam passar pelo proxy. Exemplos: ["127.0.0.1", "example.com", ".corp", "localhost"].

BareMetalAdminSecurityConfig

Especifica as configurações relacionadas à segurança do cluster de administrador bare metal.

Representação JSON 
{
  "authorization": {
    object (Authorization)
  }
}
Campos
authorization

object (Authorization)

Configura o acesso do usuário ao cluster de administrador.

BareMetalAdminNodeAccessConfig

Especifica as configurações relacionadas ao acesso de nós para o cluster de administrador de bare metal.

Representação JSON 
{
  "loginUser": string
}
Campos
loginUser

string

Obrigatório. LoginUser é o nome de usuário usado para acessar as máquinas de nó. O padrão será "root" se não for definido.

BareMetalAdminOsEnvironmentConfig

Especifica as configurações de operação do sistema operacional para provisionamento de cluster.

Representação JSON 
{
  "packageRepoExcluded": boolean
}
Campos
packageRepoExcluded

boolean

Se o repositório de pacotes precisa ser adicionado ao inicializar máquinas bare metal.

Métodos

create

 Cria um novo cluster de administrador de bare metal em um determinado projeto e local.

enroll

 Registra um cluster de administrador bare metal na API Anthos On-Prem em um determinado projeto e local.

get

 Recebe detalhes de um único cluster de administrador bare metal.

list

 Lista clusters de administrador bare metal em um determinado projeto e local.

patch

 Atualiza os parâmetros de um único cluster de administrador em bare metal.

queryVersionConfig

 Consulta a configuração da versão do cluster de administrador bare metal.