Arquivo de bloqueio de IP

Esta página descreve os campos em um arquivo de bloco de IP, que é usado na configuração do Google Distributed Cloud.

Use um arquivo de bloco de IP para descrever um conjunto de máquinas de nós e a rede a que elas estão conectadas. Você cria um arquivo de bloco de IP separado para cada cluster. Os arquivos de configuração do cluster de administrador e de usuário têm um campo chamado network.ipMode.ipBlockFilePath. Especifique o caminho absoluto ou relativo do bloco de IP neste campo.

Use um arquivo de bloco de IP para listar os endereços IP e, opcionalmente, os nomes de host nos seguintes casos:

  • Clusters de usuários:

    • Se network.ipMode.type estiver definido como "static" no arquivo de configuração do cluster de usuário, liste os endereços IP dos nós de trabalho no arquivo de bloco de IP do cluster de usuário.

    • Se infraConfigFilePath estiver configurado no arquivo de configuração do cluster de administrador (que ativa domínios de topologia), liste os endereços IP dos nós do plano de controle no arquivo de bloco de IP do cluster de usuário. Os endereços IP dos nós do plano de controle são sempre estáticos, mesmo que os nós de trabalho usem DHCP.

  • Clusters de administrador:

    • Se infraConfigFilePath estiver configurado no arquivo de configuração do cluster de administrador (que ativa domínios de topologia), liste os endereços IP dos nós do plano de controle no arquivo de bloco de IP do cluster de administrador.

    • Cluster de administrador não HA 1.16 e versões anteriores: liste os endereços IP do nó do plano de controle e dos nós de complemento no arquivo de bloco de IP do cluster de administrador.

    • Cluster de administrador HA 1.16 e versões anteriores: liste os endereços IP dos nós de complemento em um arquivo de bloco de IP.

    • Clusters de usuário do kubeception 1.29 e versões anteriores: liste os endereços IP dos nós do plano de controle do cluster de usuário no arquivo de bloco de IP do cluster de administrador.

Modelo

Como preencher os campos em um arquivo de bloco de IP

Esta seção descreve os campos em um arquivo de bloco de IP.

blocks

Uma matriz de objetos, cada um descrevendo um conjunto de hosts.

blocks[i].netmask

String. A máscara de sub-rede para o conjunto de hosts. Por exemplo:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

String. O endereço do gateway padrão para o conjunto de hosts. Por exemplo:

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"

blocks[i].ips

Uma matriz de objetos. Cada objeto tem um endereço IP individual ou um bloco CIDR de endereços IP.

  • Se o objeto tiver um endereço IP individual, ele também poderá ter um nome de host.

  • Se você definir ip como um bloco CIDR, não especifique um valor para hostname.

  • Quando você não especifica um valor para hostname, o Google Distributed Cloud usa o nome da VM do vSphere como o nome do host.

blocks[i].isControlPlane

Se infraConfigFilePath estiver configurado no arquivo de configuração do cluster de administrador e se o endereço IP for de um nó do plano de controle, inclua isControlPlane: true. Para nós de trabalho do cluster de usuário, especifique false ou omita o campo porque o valor padrão é false.

Exemplos de arquivos de configuração

A seção fornece algumas configurações com exemplos de valores preenchidos.

Exemplo 1

Este exemplo especifica seis endereços IP: dois individuais e um bloco CIDR de quatro endereços.

blocks:
- netmask: "255.255.252.0"
  gateway: "203.0.113.1"
  ips:
  - ip: 198.51.100.10
    hostname: worker-node1
  - ip: 198.51.100.11
    hostname: worker-node2
  - ip: 198.51.100.12/30  # 198.51.100.12 - 198.51.100.15

Exemplo 2

Este exemplo mostra um arquivo de bloco de IP configurado para domínios de topologia.

blocks:
- netmask: 255.255.255.0
  gateway: 100.115.222.254
  ips:
  - ip: 100.115.222.204
    hostname: worker-1
  - ip: 100.115.222.205
    hostname: cp-1
    isControlPlane: true
  - ip: 100.115.222.206
    hostname: cp-2
    isControlPlane: true
  - ip: 100.115.222.207
    hostname: cp-3
    isControlPlane: true
  - ip: 100.115.222.220/28 # 100.115.222.208 - 100.115.222.223
- netmask: 255.255.255.0
  gateway: 100.115.223.254
  ips:
  - ip: 100.115.223.206
    hostname: worker-2
  - ip: 100.115.223.220/28 # 100.115.223.208 - 100.115.223.223
- netmask: 255.255.255.0
  gateway: 100.115.224.254
  ips:
  - ip: 100.115.224.206
    hostname: worker-3
  - ip: 100.115.224.220/28 # 100.115.224.208 - 100.115.224.223

Este exemplo de arquivo de bloco de IP reservou endereços IP de três sub-redes, e cada sub-rede é representada como blocks[i]. O blocks[i].gateway é importante porque funciona como a identificação do bloco de IP. Adicione o mesmo endereço IP a topologyDomains[i].network.gateway no recurso personalizado VSphereInfraConfig dentro do arquivo de configuração da infraestrutura do vSphere.

Há três IPs configurados com isControlPlane: true, o que indica que esses endereços IP são reservados apenas para nós do plano de controle. No arquivo de bloco de IP do cluster de administrador ou de usuário, é necessário reservar três endereços IP para os nós do plano de controle. Reserve-os na sub-rede de destino de acordo com a topologia aplicável do cluster.

Como os nós do plano de controle precisam estar em um único domínio de topologia, os endereços IP deles precisam estar no mesmo bloco de IP.