Ficheiro de bloqueio de IP

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

Usa um ficheiro de bloqueio de IP para descrever um conjunto de máquinas de nós e a rede à qual as máquinas estão ligadas. Cria um ficheiro de bloqueio de IPs separado para cada cluster. Os ficheiros de configuração do cluster de administrador e do utilizador têm um campo denominado network.ipMode.ipBlockFilePath. Especifica o caminho absoluto ou relativo do bloco de IP neste campo.

Use um ficheiro de blocos de IP para listar os endereços IP e, opcionalmente, os nomes de anfitrião nos seguintes casos:

  • Clusters de utilizadores:

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

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

  • Clusters de administração:

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

    • 1.16 e inferior: liste os endereços IP do nó do plano de controlo e dos nós de suplementos no ficheiro de blocos de IP do cluster de administrador.

    • 1.16 e inferior: liste os endereços IP dos nós de suplementos num ficheiro de bloco de IP.

    • 1.29 e clusters de utilizadores kubeception inferiores: liste os endereços IP dos nós do plano de controlo do cluster de utilizadores no ficheiro de blocos de IP do cluster de administrador.

Modelo

Preencher os campos num ficheiro de bloco de IPs

Esta secção descreve os campos num ficheiro de blocos de IP.

blocks

Uma matriz de objetos, cada um dos quais descreve um conjunto de anfitriões.

blocks[i].netmask

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

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

String. O endereço da gateway predefinida para o conjunto de anfitriões. 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, também pode ter, opcionalmente, um nome de anfitrião.

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

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

blocks[i].isControlPlane

Se infraConfigFilePath estiver configurado no ficheiro de configuração do cluster de administrador e se o endereço IP for para um nó do plano de controlo, inclua isControlPlane: true. Para nós de trabalho do cluster de utilizadores, especifique false ou omita o campo porque o valor predefinido é false.

Exemplos de ficheiros de configuração

A secção apresenta algumas configurações com valores de exemplo preenchidos.

Exemplo 1

Este exemplo especifica seis endereços IP: dois endereços 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 ficheiro de bloqueio de IPs 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 ficheiro de bloqueio de IP reserva endereços IP de três sub-redes e cada sub-rede é representada como blocks[i]. O blocks[i].gateway é importante, uma vez que funciona como a identificação do bloco de IP. Adiciona o mesmo endereço IP a topologyDomains[i].network.gateway no recurso personalizado VSphereInfraConfig no ficheiro de configuração da infraestrutura do vSphere.

Existem três IPs configurados com isControlPlane: true, o que indica que estes endereços IP estão reservados apenas para nós do plano de controlo. No ficheiro de blocos de IP do cluster de administrador ou do cluster de utilizador, têm de existir três endereços IP reservados para nós do plano de controlo. Reserve-os na sub-rede de destino de acordo com a topologia aplicável do cluster.

Uma vez que os nós do plano de controlo têm de estar num único domínio de topologia, os endereços IP dos nós do plano de controlo têm de estar no mesmo bloco de IP.