Administra las direcciones IP del nodo

En este documento, se proporciona orientación sobre la cantidad de direcciones IP que se necesitan para los clústeres de administrador y de usuario en Google Distributed Cloud.

DHCP o estática

Si tu red tiene un servidor DHCP, puedes configurar un clúster de administrador o un clúster de usuario para que obtenga las direcciones IP para sus nodos trabajadores desde el servidor DHCP. En el archivo de configuración del clúster, configura network.ipMode.type como "dhcp".

Si prefieres especificar direcciones IP estáticas para un clúster, configura network.ipMode.type como “estático”.

¿Cuántas direcciones IP necesita un clúster de administrador?

Un clúster de administrador con alta disponibilidad (HA) debe tener tres direcciones IP disponibles para los nodos del plano de control.

Un clúster de administrador administra uno o más clústeres de usuario. Si Controlplane V2 está habilitado para un clúster de usuario, los nodos del plano de control del clúster de usuario se ejecutan en el clúster de usuario. Los clústeres de usuario con Controlplane V2 habilitado no afectan la cantidad de direcciones IP que necesita un clúster de administrador.

Si Controlplane V2 no está habilitado para un clúster de usuario, el plano de control del clúster de usuario se ejecuta en uno o más nodos del clúster de administrador (kubeception). En el caso de kubeception, el clúster de administrador también necesita direcciones IP para lo siguiente:

Por cada clúster de usuario con alta disponibilidad, el clúster de administrador necesita tres nodos a fin de ejecutar el plano de control del clúster de usuario.
Por cada clúster de usuario sin alta disponibilidad, el clúster de administrador necesita un nodo a fin de ejecutar el plano de control del clúster de usuario.

Antes de agregar un clúster de usuario cuando Controlplane V2 no esté habilitado, asegúrate de tener suficientes direcciones IP disponibles para el clúster de administrador de los nodos del plano de control del clúster de usuario. Si usas DHCP, asegúrate de que el servidor DHCP pueda proporcionar las direcciones IP adicionales.

Ejemplos:

Descripción	Cantidad de direcciones IP
Clúster de administrador de alta disponibilidad que administra un clúster de usuario de Controlplane V2 3 nodos del plano de control	3
Clúster de administrador de alta disponibilidad que administra un clúster de usuario de Kubeception de alta disponibilidad 3 nodos del plano de control + 3 nodos del plano de control del clúster de usuario	6

¿Cuántas direcciones IP necesita un clúster de usuario?

Si Controlplane V2 está habilitado (que es de forma predeterminada), uno o tres nodos para ejecutar el plano de control en el clúster de usuario:
- Un nodo para un clúster de usuario que no tiene alta disponibilidad (sin HA)
- Tres nodos para un clúster de usuario con alta disponibilidad
Una dirección IP para cada nodo trabajador (nodos que ejecutan tus cargas de trabajo)
Una dirección IP adicional que se usará como nodo temporal durante la actualización y la reparación automática.

Antes de agregar más nodos trabajadores a un clúster de usuario cuando Controlplane V2 está habilitado, asegúrate de tener suficientes direcciones IP disponibles para el clúster de usuario para los nodos del plano de control. Si usas DHCP, asegúrate de que el servidor DHCP pueda proporcionar las direcciones IP adicionales.

Ejemplos:

Descripción	Cantidad de direcciones IP
Clúster de usuario sin alta disponibilidad, Controlplane V2 3 nodos trabajadores + 1 nodo del plano de control + 1 nodo adicional	5
Clúster de usuario de alta disponibilidad, Controlplane V2 3 nodos trabajadores + 3 nodos del plano de control + 1 nodo adicional	7
Clúster de usuario, kubeception 3 nodos trabajadores + 1 nodo adicional	4

Direcciones IP estáticas para un clúster de administrador

En esta sección, se explica cómo administrar las direcciones IP estáticas para un clúster de administrador.

Debes especificar tres direcciones IP para los nodos del plano de control del clúster de administrador. Especifica estas direcciones en la sección network.controlPlaneIPBlock del archivo de configuración del clúster de administrador.

Si deseas crear clústeres de usuario de kubeception, debes especificar las direcciones IP que se usarán para los nodos del plano de control de los clústeres de usuario. Especifica estas direcciones en un archivo de bloque de IP. Luego, en el archivo de configuración de tu clúster de administrador, proporciona la ruta de acceso del archivo de bloque de IP en el campo network.ipMode.ipBlockFilePath.

Por ejemplo, imagina que tienes la intención de crear dos clústeres de usuario de kubeception: uno con alta disponibilidad y otro sin HA. El clúster de usuario con alta disponibilidad tendrá tres nodos del plano de control en el clúster de administrador, y el clúster de usuario sin alta disponibilidad tendrá un nodo del plano de control en el clúster de administrador. Por lo tanto, debes especificar cuatro direcciones IP más una dirección IP adicional que se usará durante las actualizaciones.

A continuación, se muestra un ejemplo de un archivo de bloque IP que tiene cinco direcciones IP:

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.50
      hostname: admin-vm-1
    - ip: 172.16.20.51
      hostname: admin-vm-2
    - ip: 172.16.20.52
      hostname: admin-vm-3
    - ip: 172.16.20.53
      hostname: admin-vm-4
    - ip: 172.16.20.54
      hostname: admin-vm-5

Agrega direcciones IP a un clúster de administrador

Si deseas que más direcciones IP estén disponibles para los nodos del clúster de administrador, agrega direcciones al archivo de bloque de IP y, luego, ejecuta el siguiente comando a fin de actualizar el clúster de administrador:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config ADMIN_CLUSTER_CONFIG

Reemplaza lo siguiente:

ADMIN_CLUSTER_KUBECONFIG: la ruta de acceso al archivo kubeconfig del clúster de administrador
ADMIN_CLUSTER_CONFIG: la ruta de acceso del archivo de configuración del clúster de usuario.

Direcciones IP estáticas para un clúster de usuario

En esta sección, se explica cómo administrar direcciones IP estáticas para un clúster de usuario.

Determina las direcciones IP que están disponibles para los nodos del clúster de usuario

El archivo de bloque de IP del clúster de usuario aparece como el valor de network.ipMode.ipBlockFilePath en el archivo de configuración del clúster de usuario. En el archivo de bloque de IP, puedes ver las direcciones IP disponibles para los nodos trabajadores en el clúster de usuario.

Por ejemplo, este es un archivo de bloque de IP que tiene cuatro direcciones IP:

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.55
      hostname: user-vm-1
    - ip: 172.16.20.56
      hostname: user-vm-2
    - ip: 172.16.20.57
      hostname: user-vm-3
    - ip: 172.16.20.58
      hostname: user-vm-4

El archivo de bloque de IP no contiene direcciones para los nodos del plano de control del clúster de usuario. Si el clúster de usuario tiene Plano de control V2 habilitado, las direcciones IP para los nodos del plano de control están en la sección network.controlPlaneIPBlock del archivo de configuración de clústeres de usuario. De lo contrario, las direcciones IP para los nodos del plano de control del clúster de usuario están en el archivo de bloque de IP del clúster de administrador.

Agrega direcciones IP a un clúster de usuario

Si deseas que más direcciones IP estén disponibles para los nodos del clúster de usuario, agrega direcciones al archivo de bloque de IP y, luego, ejecuta el siguiente comando a fin de actualizar el clúster de usuario:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config USER_CLUSTER_CONFIG