- 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. |
admin |
Obrigatório. O cluster de administrador ao qual esse cluster de usuário bare metal pertence. É 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 de bare metal. |
bare |
Obrigatório. Os clusters do Anthos na versão bare metal para seu cluster de usuário. |
uid |
Apenas saída. O identificador exclusivo do cluster de usuários de 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 Bare Metal. |
reconciling |
Apenas saída. Se definido, há mudanças em andamento no cluster de usuário de bare metal. |
create |
Apenas saída. O momento em que o cluster de usuário 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: |
update |
Apenas saída. A hora em que o cluster de usuário 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: |
delete |
Apenas saída. O horário em que o cluster de usuário de hardware 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: |
local |
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 na API. Quando usado como parte da inscrição no cluster, esse campo é diferente do nome 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. Quando o nome local e o nome do cluster são diferentes, o nome local é usado nos registros do controlador do cluster de administrador. Use o nome do cluster ao acessá-lo usando o bmctl e o kubectl. |
etag |
Apenas saída. 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 |
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 |
network |
Obrigatório. Configuração de rede. |
control |
Obrigatório. Configuração do plano de controle. |
load |
Obrigatório. Configuração do balanceador de carga. |
storage |
Obrigatório. Configuração de armazenamento. |
proxy |
Configuração de proxy. |
cluster |
Configuração das operações do cluster. |
maintenance |
Configuração de manutenção. |
node |
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. |
validation |
Apenas saída. O resultado da verificação de simulação. |
security |
Configuração de configurações relacionadas à segurança. |
maintenance |
Apenas saída. Status das tarefas de manutenção em andamento. |
admin |
Apenas saída. O nome do recurso do cluster de administrador de bare metal que gerencia esse cluster de usuário. |
node |
Configurações relacionadas ao acesso ao nó. |
os |
Configurações relacionadas ao ambiente do SO. |
binary |
Configurações relacionadas à autorização binária. |
upgrade |
A política de upgrade 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 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. |
BareMetalNetworkConfig
Especifica a configuração de rede do cluster.
Representação JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campos | |
---|---|
advanced |
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 de recursos de rede avançados define automaticamente essa flag. |
multiple |
Configuração para várias interfaces de rede. |
sr |
Configuração para SR-IOV. |
Campo de união cluster_cidr_configuration . A configuração CIDR a ser usada no cluster de usuário de bare metal. cluster_cidr_configuration pode ser apenas de um dos tipos a seguir: |
|
island |
Configuração para o CIDR do modo de ilha. Em uma rede no modo 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 CIDR do cluster durante a execução no modo de ilha.
Representação JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
service |
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. |
pod |
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 de cluster de várias interfaces de rede.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Define se várias interfaces de rede serão ativadas para os pods. Quando 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 | |
---|---|
control |
Obrigatório. Configura o pool de nós que executa o plano de controle. |
api |
Personaliza os argumentos padrão do servidor de API. Apenas um subconjunto de sinalizações 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 | |
---|---|
node |
Obrigatório. A configuração genérica de um pool de nós que executa o plano de controle. |
BareMetalApiServerArgument
Representa um par de nome-valor de argumento. Apenas um subconjunto de sinalizações 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 conforme aparece na linha de comando do servidor da API. Remova os traços iniciais. |
value |
Obrigatório. O valor do argumento, que 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 | |
---|---|
vip |
Os VIPs usados pelo balanceador de carga. |
port |
Configura as portas que o balanceador de carga vai detectar. |
Campo de união load_balancer_configuration . A configuração do balanceador de carga para o cluster de usuário de bare metal. load_balancer_configuration pode ser apenas de um dos tipos a seguir: |
|
metal |
Configuração para balanceadores de carga MetalLB. |
manual |
Balanceadores de carga configurados manualmente. |
bgp |
Configuração para balanceadores de carga do tipo BGP. Quando 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 | |
---|---|
control |
O VIP que você reservou anteriormente para a API Kubernetes desse cluster de usuário bare metal. |
ingress |
O VIP que você separou anteriormente para o tráfego de entrada nesse cluster de usuário de bare metal. |
BareMetalPortConfig
Especifica as portas do balanceador de carga para o cluster de usuário bare metal.
Representação JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campos | |
---|---|
control |
A porta em que os balanceadores de carga hospedados no plano de controle vão detectar. |
BareMetalMetalLbConfig
Representa parâmetros de configuração para um balanceador de carga MetalLB.
Representação JSON |
---|
{ "addressPools": [ { object ( |
Campos | |
---|---|
address |
Obrigatório. O AddressPools é uma lista de pools de IP não sobrepostos usados por serviços do tipo 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. |
load |
Especifica o pool de nós que executa o balanceador de carga. A conectividade L2 é necessária entre os nós nesse pool. Se ele estiver ausente, o pool de nós do plano de controle será usado como o pool do balanceador de carga. |
BareMetalLoadBalancerAddressPool
Representa um pool 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 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). |
avoid |
Se 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. |
manual |
Se definido como "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 | |
---|---|
node |
A configuração genérica de 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
BareMetalBgpLbConfig representa parâmetros de configuração para um balanceador de carga de 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. |
bgp |
Obrigatório. A lista de pares BGP com que o cluster vai se conectar. Pelo menos um peer precisa ser configurado para cada nó do plano de controle. Os nós do plano de controle vão se conectar a esses pares para anunciar o VIP do plano de controle. O balanceador de carga de serviços também usa esses pares por padrão. Esse campo pode ser atualizado após a criação do cluster. |
address |
Obrigatório. O AddressPools é uma lista de pools de IP não sobrepostos usados por serviços do tipo 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. |
load |
Especifica o pool de nós que executa o balanceamento de carga do plano de dados. A conectividade L2 é necessária entre os nós nesse pool. Se ele estiver ausente, 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 protocolo de gateway de borda (BGP).
Representação JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Campos | |
---|---|
asn |
Obrigatório. Número de sistema autônomo (ASN) do BGP para a rede que contém o dispositivo de peering externo. |
ip |
Obrigatório. O endereço IP do dispositivo externo. |
control |
O endereço IP do nó do plano de controle que se conecta ao peer 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 | |
---|---|
lvp |
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. |
lvp |
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. |
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 servidor proxy. Exemplos: Não forneça credenciais no formato |
no |
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"]. |
BareMetalClusterOperationsConfig
Especifica a infraestrutura de observabilidade do cluster de usuário bare metal.
Representação JSON |
---|
{ "enableApplicationLogs": boolean } |
Campos | |
---|---|
enable |
Se a coleta de registros/métricas do aplicativo precisa ser ativada (além dos registros/métricas do sistema). |
BareMetalMaintenanceConfig
Especifica as configurações para colocar e remover nós bare metal da manutenção.
Representação JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campos | |
---|---|
maintenance |
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ó. |
BareMetalWorkloadNodeConfig
Especifica as configurações do nó de carga de trabalho.
Representação JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campos | |
---|---|
max |
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. |
container |
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ários. |
BareMetalMaintenanceStatus
Representa o status de manutenção do cluster de usuário bare metal.
Representação JSON |
---|
{
"machineDrainStatus": {
object ( |
Campos | |
---|---|
machine |
O status de manutenção das máquinas de nó. |
BareMetalMachineDrainStatus
Representa o status das máquinas de nó que estão passando por operações de esgotamento.
Representação JSON |
---|
{ "drainingMachines": [ { object ( |
Campos | |
---|---|
draining |
A lista de máquinas de drenagem. |
drained |
A lista de máquinas drenadas. |
BareMetalDrainingMachine
Representa uma máquina que está sendo drenada.
Representação JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campos | |
---|---|
node |
Endereço IP da máquina de drenagem. |
pod |
A contagem de pods que ainda não foram drenados. |
BareMetalDrainedMachine
Representa uma máquina que está sendo drenada.
Representação JSON |
---|
{ "nodeIp": string } |
Campos | |
---|---|
node |
Endereço IP da máquina drenada. |
BareMetalNodeAccessConfig
Especifica as configurações relacionadas ao acesso de nós para o cluster de usuário bare metal.
Representação JSON |
---|
{ "loginUser": string } |
Campos | |
---|---|
login |
LoginUser é o nome de usuário usado para acessar as máquinas de nó. Se não for definido, o padrão será "root". |
BareMetalOsEnvironmentConfig
Especifica as configurações do sistema operacional para provisionamento de cluster.
Representação JSON |
---|
{ "packageRepoExcluded": boolean } |
Campos | |
---|---|
package |
Especifica se o repositório de pacotes não deve ser incluído ao inicializar máquinas bare metal. |
BareMetalClusterUpgradePolicy
A BareMetalClusterUpgradePolicy define a política de upgrade do cluster.
Representação JSON |
---|
{
"policy": enum ( |
Campos | |
---|---|
policy |
Especifica qual política de upgrade usar. |
pause |
Apenas saída. A pausa é usada para mostrar o status da pausa do upgrade. Por enquanto, ele só pode ser visualizado. |
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 |
Atualize todos os pools de nós de trabalho em paralelo. |
Métodos |
|
---|---|
|
Cria um cluster bare metal em um determinado projeto e local. |
|
Exclui um único cluster de bare metal. |
|
Registra um cluster de usuário de bare metal e os pools de nós 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 do bare metal. |