- 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 usuário 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 usuário bare metal. |
adminClusterMembership |
Obrigatório. O cluster de administrador a que este cluster de usuário bare metal pertence. Esse é o nome completo do recurso da associação da frota do cluster de administrador. |
description |
Uma descrição legível deste cluster de usuário bare metal. |
bareMetalVersion |
Obrigatório. A versão dos clusters do Anthos em bare metal para seu cluster de usuário. |
uid |
Apenas saída. O identificador exclusivo do cluster de usuário bare metal. |
state |
Apenas saída. O estado atual do cluster de usuário bare metal. |
endpoint |
Apenas saída. O endereço IP do servidor da API do cluster de usuário do Bare Metal. |
reconciling |
Apenas saída. Se definido, há mudanças em andamento no cluster de usuário do bare metal. |
createTime |
Apenas saída. O horário em que o cluster de usuário do bare metal foi criado. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
updateTime |
Apenas saída. A hora em que o cluster de usuário do bare metal foi atualizado pela última vez. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
deleteTime |
Apenas saída. O horário em que o cluster de usuário bare metal foi excluído. Se o recurso não for excluído, este campo precisa estar vazio. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
localName |
Apenas saída. O nome do objeto do recurso personalizado do cluster de usuário bare metal no cluster de administrador associado. Esse campo é usado para oferecer suporte a nomes conflitantes ao registrar clusters atuais na API. Quando usado como parte do registro do cluster, esse campo será diferente do nome no nome do recurso. Para novos clusters, esse campo vai corresponder ao nome fornecido pelo usuário e ficará visível no último componente do nome do recurso. Ela não pode ser modificada. Quando o nome local e o nome do cluster são diferentes, o nome local é usado nos registros do controlador do cluster de administrador. Você usa o nome do cluster ao acessar o cluster usando bmctl e kubectl. |
etag |
Apenas saída. Esse checksum é calculado pelo servidor com base no valor de outros campos e pode ser enviado 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 |
Anotações no cluster de usuário 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 |
networkConfig |
Obrigatório. Configuração de rede. |
controlPlane |
Obrigatório. Configuração do plano de controle. |
loadBalancer |
Obrigatório. Configuração do balanceador de carga. |
storage |
Obrigatório. Configuração de armazenamento. |
proxy |
Configuração de proxy. |
clusterOperations |
Configuração de 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. Status detalhado do cluster. |
validationCheck |
Apenas saída. O resultado da verificação de simulação. |
securityConfig |
Configuração de configurações relacionadas à segurança. |
maintenanceStatus |
Apenas saída. Status das tarefas de manutenção em andamento. |
adminClusterName |
Apenas saída. O nome do recurso do cluster de administrador do bare metal que gerencia esse cluster de usuário. |
nodeAccessConfig |
Configurações relacionadas ao acesso ao nó. |
osEnvironmentConfig |
Configurações relacionadas ao ambiente do SO. |
binaryAuthorization |
Configurações relacionadas à autorização binária. |
upgradePolicy |
A política de upgrade do cluster. |
localNamespace |
Apenas saída. O namespace do cluster. |
Estado
O estado do ciclo de vida do cluster de usuário 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 reduzido. |
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. |
BareMetalNetworkConfig
Especifica a configuração de rede do cluster.
Representação JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campos | |
---|---|
advancedNetworking |
Permite o uso de recursos avançados de rede do Anthos, como o balanceamento de carga em pacote com o BGP ou o gateway NAT de saída. A configuração dos recursos de rede avançados define automaticamente essa 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 de CIDR a ser usada no cluster de usuário do bare metal. cluster_cidr_configuration pode ser apenas de um dos tipos a seguir: |
|
islandModeCidr |
Configuração para CIDR do modo isolado. Em uma rede no modo de ilha, os nós têm endereços IP exclusivos, mas os pods não têm endereços exclusivos nos clusters. Isso não causa problemas porque os pods em um cluster nunca se comunicam diretamente com pods em outro cluster. Em vez disso, há gateways que mediam entre um pod em um cluster e um pod em outro cluster. |
BareMetalIslandModeCidrConfig
Especifica a configuração de CIDR do cluster ao executar no modo isolado.
Representação JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
serviceAddressCidrBlocks[] |
Obrigatório. Todos os serviços do cluster recebem um endereço IPv4 RFC1918 desses intervalos. Esse campo é mutável após a criação a partir da versão 1.15. |
podAddressCidrBlocks[] |
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. |
BareMetalMultipleNetworkInterfacesConfig
Especifica a configuração do cluster de várias interfaces de rede.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Se você quer ativar várias interfaces de rede para seus pods. Quando definido, networkConfig.advanced_networking é definido automaticamente como verdadeiro. |
BareMetalSrIovConfig
Especifica a configuração do operador de rede SR-IOV.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Se o operador SR-IOV será instalado. |
BareMetalControlPlaneConfig
Especifica a configuração do plano de controle.
Representação JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Campos | |
---|---|
controlPlaneNodePoolConfig |
Obrigatório. Configura o pool de nós que executa o plano de controle. |
apiServerArgs[] |
Personaliza os argumentos padrão do servidor de API. Apenas um subconjunto de flags personalizadas é compatível. Para saber o formato exato, consulte a documentação do servidor da API. |
BareMetalControlPlaneNodePoolConfig
Especifica a configuração do pool de nós do plano de controle.
Representação JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
Obrigatório. A configuração genérica para um pool de nós que executa o plano de controle. |
BareMetalApiServerArgument
Representa um par nome->valor de argumento. Apenas um subconjunto de flags personalizadas é compatível. Para saber 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 como aparece na linha de comando do servidor de API. Remova os traços iniciais. |
value |
Obrigatório. O valor do argumento conforme ele será transmitido para a linha de comando do servidor da API. |
BareMetalLoadBalancerConfig
Especifica a configuração do balanceador de carga.
Representação JSON |
---|
{ "vipConfig": { object ( |
Campos | |
---|---|
vipConfig |
Os VIPs usados pelo balanceador de carga. |
portConfig |
Configura as portas que o balanceador de carga vai escutar. |
Campo de união load_balancer_configuration . A configuração do balanceador de carga para o cluster de usuário bare metal. load_balancer_configuration pode ser apenas de um dos tipos a seguir: |
|
metalLbConfig |
Configuração para balanceadores de carga do MetalLB. |
manualLbConfig |
Balanceadores de carga configurados manualmente. |
bgpLbConfig |
Configuração para balanceadores de carga tipados do BGP. Quando definido, networkConfig.advanced_networking é definido automaticamente como verdadeiro. |
BareMetalVipConfig
Especifica a configuração de VIP para o balanceador de carga bare metal.
Representação JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campos | |
---|---|
controlPlaneVip |
O VIP que você reservou para a API Kubernetes deste cluster de usuário bare metal. |
ingressVip |
O VIP que você separou anteriormente para o tráfego de entrada neste cluster de usuário do bare metal. |
BareMetalPortConfig
Especifica as portas do balanceador de carga para o cluster de usuário bare metal.
Representação JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
controlPlaneLoadBalancerPort |
A porta em que os balanceadores de carga hospedados do plano de controle vão ficar ouvindo. |
BareMetalMetalLbConfig
Representa parâmetros de configuração para um balanceador de carga MetalLB.
Representação JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
addressPools[] |
Obrigatório. "AddressPools" é uma lista de pools de IP não sobrepostos usados por serviços tipados de balanceador de carga. Todos os endereços precisam ser roteáveis para os nós do balanceador de carga. O IngressVIP precisa ser incluído nos pools. |
loadBalancerNodePoolConfig |
Especifica o pool de nós que executa o balanceador de carga. É necessária conectividade L2 entre os nós desse pool. Se estiver faltando, o pool de nós do plano de controle será usado como o pool do balanceador de carga. |
BareMetalLoadBalancerAddressPool
Representa um pool de IP usado pelo balanceador de carga.
Representação JSON |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
Campos | |
---|---|
pool |
Obrigatório. O nome do pool de endereços. |
addresses[] |
Obrigatório. Os endereços que fazem parte desse pool. Cada endereço precisa estar no formato CIDR (1.2.3.0/24) ou de intervalo (1.2.3.1-1.2.3.5). |
avoidBuggyIps |
Se for verdadeiro, evite usar IPs que terminam em .0 ou .255. Isso evita que dispositivos de consumo com bugs descartem por engano o tráfego IPv4 para esses endereços IP especiais. |
manualAssign |
Se for "true", impede que os endereços IP sejam atribuídos automaticamente. |
BareMetalLoadBalancerNodePoolConfig
Especifica a configuração do pool de nós do balanceador de carga.
Representação JSON |
---|
{
"nodePoolConfig": {
object ( |
Campos | |
---|---|
nodePoolConfig |
A configuração genérica para um pool de nós que executa um balanceador de carga. |
BareMetalManualLbConfig
Representa parâmetros de configuração para um balanceador de carga manual.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Indica se o balanceamento de carga manual está ativado. |
BareMetalBgpLbConfig
O BareMetalBgpLbConfig representa parâmetros de configuração para um balanceador de carga do protocolo de gateway de borda (BGP).
Representação JSON |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
Campos | |
---|---|
asn |
Obrigatório. Número de sistema autônomo (ASN) do BGP do cluster. Esse campo pode ser atualizado após a criação do cluster. |
bgpPeerConfigs[] |
Obrigatório. A lista de peers do BGP a que o cluster se conectará. Pelo menos um peering precisa ser configurado para cada nó do plano de controle. Os nós do plano de controle se conectam a esses peers para anunciar o VIP do plano de controle. O balanceador de carga do Services também usa esses peers por padrão. Esse campo pode ser atualizado após a criação do cluster. |
addressPools[] |
Obrigatório. "AddressPools" é uma lista de pools de IP não sobrepostos usados por serviços tipados de balanceador de carga. Todos os endereços precisam ser roteáveis para os nós do balanceador de carga. O IngressVIP precisa ser incluído nos pools. |
loadBalancerNodePoolConfig |
Especifica o pool de nós que executa o balanceamento de carga do plano de dados. É necessária conectividade L2 entre os nós desse pool. Se estiver faltando, o pool de nós do plano de controle será usado para o balanceamento de carga do plano de dados. |
BareMetalBgpPeerConfig
"BareMetalBgpPeerConfig" representa parâmetros de configuração para um peer 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 peering externo. |
ipAddress |
Obrigatório. O endereço IP do dispositivo de peering externo. |
controlPlaneNodes[] |
O endereço IP do nó do plano de controle que se conecta ao peering externo. Se você não especificar nenhum nó do plano de controle, todos os nós do plano de controle poderão se conectar ao peering externo. Se você especificar um ou mais endereços IP, apenas os nós especificados participarão das sessões de peering. |
BareMetalStorageConfig
O BareMetalStorageConfig especifica a configuração de armazenamento do cluster.
Representação JSON |
---|
{ "lvpShareConfig": { object ( |
Campos | |
---|---|
lvpShareConfig |
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 |
Obrigatório. Especifica a configuração dos PersistentVolumes locais apoiados por discos de nós montados. Esses discos precisam ser formatados e montados pelo usuário, o que pode ser feito antes ou depois da criação do cluster. |
BareMetalProxyConfig
Especifica a configuração de proxy do cluster.
Representação JSON |
---|
{ "uri": string, "noProxy": [ string ] } |
Campos | |
---|---|
uri |
Obrigatório. Especifica o endereço do servidor proxy. Exemplos: Não forneça credenciais no formato |
noProxy[] |
Uma lista de IPs, nomes de host 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 usuário bare metal.
Representação JSON |
---|
{ "enableApplicationLogs": boolean } |
Campos | |
---|---|
enableApplicationLogs |
Se a coleta de registros/métricas de aplicativos precisa ser ativada (além de registros/métricas do sistema). |
BareMetalMaintenanceConfig
Especifica configurações para colocar nós bare metal em manutenção e fora dela.
Representação JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
maintenanceAddressCidrBlocks[] |
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 as duas condições são verdadeiras, a anotação "baremetal.cluster.gke.io/maintenance" é definida no recurso de nó. |
BareMetalWorkloadNodeConfig
Especifica as configurações de nós da 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ó será derivado desse parâmetro. |
containerRuntime |
Especifica qual ambiente de execução do contêiner será usado. |
ContainerRuntime
O ambiente de execução usado para executar contêineres em um cluster de usuário.
Enums | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Nenhum ambiente de execução de contêiner selecionado. |
CONTAINERD |
Ambiente de execução do Containerd. |
BareMetalSecurityConfig
Especifica as configurações relacionadas à segurança do cluster de usuário bare metal.
Representação JSON |
---|
{
"authorization": {
object ( |
Campos | |
---|---|
authorization |
Configura o acesso do usuário ao cluster de usuário. |
BareMetalMaintenanceStatus
Representa o status de manutenção do cluster de usuário bare metal.
Representação JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machineDrainStatus |
O status de manutenção das máquinas de nós. |
BareMetalMachineDrainStatus
Representa o status das máquinas de nós que estão passando por operações de drenagem.
Representação JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
drainingMachines[] |
A lista de máquinas de drenagem. |
drainedMachines[] |
A lista de máquinas esgotadas. |
BareMetalDrainingMachine
Representa uma máquina que está sendo drenada.
Representação JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campos | |
---|---|
nodeIp |
Endereço IP da máquina de drenagem. |
podCount |
A contagem de pods ainda a serem drenados. |
BareMetalDrainedMachine
Representa uma máquina que está sendo drenada.
Representação JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
nodeIp |
Endereço IP da máquina esgotada. |
BareMetalNodeAccessConfig
Especifica as configurações relacionadas ao acesso aos nós do cluster de usuário em bare metal.
Representação JSON |
---|
{ "loginUser": string } |
Campos | |
---|---|
loginUser |
LoginUser é o nome de usuário usado para acessar máquinas de nós. Se não for definido, o padrão será "root". |
BareMetalOsEnvironmentConfig
Especifica as configurações do sistema operacional para o provisionamento do cluster.
Representação JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
packageRepoExcluded |
Se o repositório de pacotes não deve ser incluído ao inicializar máquinas bare metal. |
BareMetalClusterUpgradePolicy
O BareMetalClusterUpgradePolicy define a política de upgrade do cluster.
Representação JSON |
---|
{
"policy": enum ( |
Campos | |
---|---|
policy |
Especifica qual política de upgrade será usada. |
pause |
Apenas saída. A pausa é usada para mostrar o status de pausa do upgrade. Por enquanto, ela é somente leitura. |
NodePoolPolicy
Especifica a política de upgrade para pools de nós de trabalho.
Enums | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Nenhuma política de upgrade selecionada. |
SERIAL |
Faça upgrade dos pools de nós de trabalho sequencialmente. |
CONCURRENT |
Faça upgrade de todos os pools de nós de trabalho em paralelo. |
Métodos |
|
---|---|
|
Cria um novo cluster bare metal em um determinado projeto e local. |
|
Exclui um único cluster bare metal. |
|
Registra um cluster de usuário bare metal e os pools de nós dele na API Anthos On-Prem em um determinado projeto e local. |
|
Recebe detalhes de um único cluster bare metal. |
|
Lista clusters bare metal em um determinado projeto e local. |
|
Atualiza os parâmetros de um único cluster bare metal. |
|
Consulta a configuração da versão do cluster de usuário bare metal. |