Archivo de bloque de IP

En esta página se describen los campos de un archivo de bloque de IPs, que se usa en la configuración de Google Distributed Cloud.

Utiliza un archivo de bloqueo de IP para describir un conjunto de máquinas de nodos y la red a la que están conectadas. Crea un archivo de bloque de IPs independiente para cada clúster. Tanto el archivo de configuración de clúster de administradores como el de usuarios tienen un campo llamado network.ipMode.ipBlockFilePath. En este campo, especifica la ruta absoluta o relativa del bloque de IPs.

Usa un archivo de bloque de IPs para enumerar las direcciones IP y, opcionalmente, los nombres de host en los siguientes casos:

  • Clústeres de usuarios:

    • Si network.ipMode.type tiene el valor "static" en el archivo de configuración del clúster de usuarios, enumera las direcciones IP de los nodos de trabajo en el archivo de bloque de IP del clúster de usuarios.

    • Si infraConfigFilePath está configurado en el archivo de configuración del clúster de administrador (que habilita los dominios de topología), enumera las direcciones IP de los nodos del plano de control en el archivo de bloque de IPs del clúster de usuario. Las direcciones IP de los nodos del plano de control siempre son direcciones IP estáticas, aunque los nodos de trabajo usen DHCP.

  • Clústeres de administrador:

    • Si infraConfigFilePath está configurado en el archivo de configuración del clúster de administrador (que habilita los dominios de topología), enumera las direcciones IP de los nodos del plano de control en el archivo de bloque de IP del clúster de administrador.

    • 1.16 y versiones anteriores de clústeres de administración sin alta disponibilidad: enumera las direcciones IP del nodo del plano de control y de los nodos de complementos en el archivo de bloque de IPs del clúster de administración.

    • Clúster de administración de alta disponibilidad 1.16 y versiones anteriores: enumera las direcciones IP de los nodos de complementos en un archivo de bloque de IP.

    • Clústeres de usuarios de kubeception con la versión 1.29 o inferior: enumera las direcciones IP de los nodos del plano de control del clúster de usuarios en el archivo de bloque de IP del clúster de administradores.

Plantilla

Rellenar los campos de un archivo de bloque de IP

En esta sección se describen los campos de un archivo de bloque de IPs.

blocks

Matriz de objetos, cada uno de los cuales describe un conjunto de hosts.

blocks[i].netmask

Cadena. La máscara de subred del conjunto de hosts. Por ejemplo:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

Cadena. Dirección de la puerta de enlace predeterminada del conjunto de hosts. Por ejemplo:

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

blocks[i].ips

Es una matriz de objetos. Cada objeto tiene una dirección IP individual o un bloque CIDR de direcciones IP.

  • Si el objeto tiene una dirección IP individual, también puede tener un nombre de host.

  • Si asignas un bloque CIDR a ip, no especifiques ningún valor para hostname.

  • Si no especifica un valor para hostname, Google Distributed Cloud usará el nombre de la VM de vSphere como nombre de host.

blocks[i].isControlPlane

Si infraConfigFilePath está configurado en el archivo de configuración del clúster de administrador y la dirección IP corresponde a un nodo del plano de control, incluye isControlPlane: true. En el caso de los nodos de trabajo del clúster de usuarios, especifica false u omite el campo, ya que el valor predeterminado es false.

Archivos de configuración de ejemplo

En esta sección se proporcionan algunas configuraciones con valores de ejemplo.

Ejemplo 1

En este ejemplo se especifican seis direcciones IP: dos direcciones individuales y un bloque CIDR de cuatro direcciones.

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

Ejemplo 2

En este ejemplo se muestra un archivo de bloqueo de IPs configurado para dominios de topología.

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 archivo de bloque de IPs de ejemplo ha reservado direcciones IP de tres subredes, y cada subred se representa como blocks[i]. El blocks[i].gateway es importante, ya que funciona como identificación del bloque de IPs. Añade la misma dirección IP a topologyDomains[i].network.gateway en el recurso personalizado VSphereInfraConfig del archivo de configuración de la infraestructura de vSphere.

Hay tres IPs configuradas con isControlPlane: true, lo que indica que estas direcciones IP están reservadas solo para los nodos del plano de control. En el archivo de bloqueo de IP del clúster de administrador o del clúster de usuario, debe haber tres direcciones IP reservadas para los nodos del plano de control. Resérvalas en la subred de destino según la topología aplicable del clúster.

Como los nodos del plano de control deben estar en un único dominio de topología, las direcciones IP de los nodos del plano de control deben estar en el mismo bloque de IP.