Gérer les adresses IP des nœuds

Ce document indique le nombre d'adresses IP requises pour les clusters d'administrateur et les clusters d'utilisateur dans Google Distributed Cloud.

DHCP ou statique

Si votre réseau dispose d'un serveur DHCP, vous pouvez configurer un cluster d'administrateur ou un cluster d'utilisateur pour qu'il obtienne les adresses IP de ses nœuds de calcul auprès du serveur DHCP. Dans le fichier de configuration du cluster, définissez network.ipMode.type sur "dhcp".

Si vous préférez spécifier des adresses IP statiques pour un cluster, définissez network.ipMode.type sur "static".

De combien d'adresses IP un cluster d'administrateur a-t-il besoin ?

Un cluster administrateur à haute disponibilité doit disposer de trois adresses IP disponibles pour les nœuds du plan de contrôle.

Un cluster d'administrateur gère un ou plusieurs clusters d'utilisateurs. Si Controlplane V2 est activé pour un cluster d'utilisateurs, les nœuds du plan de contrôle du cluster d'utilisateurs s'exécutent dans le cluster d'utilisateurs. Les clusters d'utilisateurs pour lesquels Controlplane V2 est activé n'affectent pas le nombre d'adresses IP dont un cluster d'administrateur a besoin.

Si Controlplane V2 n'est pas activé pour un cluster utilisateur, le plan de contrôle du cluster utilisateur s'exécute sur un ou plusieurs nœuds du cluster administrateur (kubeception). Dans le cas de kubeception, le cluster d'administrateur a également besoin d'adresses IP pour les éléments suivants:

Pour chaque cluster utilisateur HA, le cluster administrateur a besoin de trois nœuds pour exécuter le plan de contrôle du cluster utilisateur
Pour chaque cluster d'utilisateurs standard, le cluster d'administrateur a besoin d'un nœud pour exécuter le plan de contrôle du cluster d'utilisateurs

Avant d'ajouter un cluster d'utilisateurs lorsque Controlplane V2 n'est pas activé, assurez-vous que le cluster d'administrateur dispose de suffisamment d'adresses IP pour le ou les nœuds du plan de contrôle du cluster d'utilisateurs. Si vous utilisez DHCP, assurez-vous que votre serveur DHCP peut fournir les adresses IP supplémentaires.

Exemples :

Description	Nombre d'adresses IP
Cluster d'administrateur HA qui gère un cluster d'utilisateur Controlplane V2 3 nœuds de plan de contrôle	3
Cluster d'administrateur HA qui gère un cluster d'utilisateur kubeception HA 3 nœuds de plan de contrôle + 3 nœuds de plan de contrôle de cluster d'utilisateur	6

De combien d'adresses IP un cluster d'utilisateur a-t-il besoin ?

Si Controlplane V2 est activé (ce qui est le cas par défaut), un ou trois nœuds sont nécessaires pour exécuter le plan de contrôle sur le cluster d'utilisateurs:
- Un nœud pour un cluster d'utilisateurs sans haute disponibilité
- Trois nœuds pour un cluster d'utilisateur HA
Une adresse IP pour chaque nœud de calcul (nœuds qui exécutent vos charges de travail)
Une adresse IP supplémentaire à utiliser comme nœud temporaire lors de la mise à niveau, de la mise à jour et de la réparation automatique.

Avant d'ajouter des nœuds de calcul à un cluster d'utilisateur lorsque Controlplane V2 est activé, assurez-vous que le cluster d'utilisateur dispose de suffisamment d'adresses IP pour les nœuds du plan de contrôle. Si vous utilisez DHCP, assurez-vous que votre serveur DHCP peut fournir les adresses IP supplémentaires.

Exemples :

Description	Nombre d'adresses IP
Cluster d'utilisateur sans HA, Control-Plane V2 3 nœuds de calcul + 1 nœud de plan de contrôle + 1 nœud supplémentaire	5
Cluster d'utilisateur HA, Controlplane V2 3 nœuds de calcul + 3 nœuds de plan de contrôle + 1 nœud supplémentaire	7
Cluster d'utilisateur, kubeception 3 nœuds de calcul + 1 nœud supplémentaire	4

Adresses IP statiques pour un cluster d'administrateur

Cette section explique comment gérer les adresses IP statiques d'un cluster d'administrateur.

Vous devez spécifier trois adresses IP pour les nœuds de plan de contrôle du cluster d'administrateur. Spécifiez ces adresses dans la section network.controlPlaneIPBlock du fichier de configuration du cluster d'administrateur.

Si vous avez l'intention de créer des clusters d'utilisateur kubeception, vous devez spécifier les adresses IP à utiliser pour les nœuds de plan de contrôle des clusters d'utilisateur. Spécifiez ces adresses dans un fichier de bloc d'adresses IP. Dans le fichier de configuration de votre cluster d'administrateur, indiquez le chemin d'accès au fichier de bloc d'adresses IP dans le champ network.ipMode.ipBlockFilePath.

Par exemple, supposons que vous souhaitiez créer deux clusters d'utilisateur kubeception: un à haute disponibilité et un sans haute disponibilité. Le cluster d'utilisateur HA comporte trois nœuds de plan de contrôle dans le cluster d'administrateur, et le cluster d'utilisateur standard comporte un nœud de plan de contrôle dans le cluster d'administrateur. Vous devez donc spécifier quatre adresses IP, plus une adresse IP supplémentaire à utiliser lors des mises à jour.

Voici un exemple de fichier de bloc d'adresses IP contenant cinq adresses 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

Ajouter des adresses IP à un cluster d'administrateur

Pour ajouter d'autres adresses IP aux nœuds de votre cluster d'administrateur, ajoutez des adresses à votre fichier de blocs d'adresses IP, puis exécutez la commande suivante pour mettre à jour votre cluster d'administrateur :

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config ADMIN_CLUSTER_CONFIG

Remplacez les éléments suivants :

ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur
ADMIN_CLUSTER_CONFIG : chemin d'accès au fichier de configuration du cluster d'utilisateur

Adresses IP statiques pour un cluster d'utilisateur

Cette section explique comment gérer les adresses IP statiques d'un cluster d'utilisateur.

Déterminer les adresses IP disponibles pour les nœuds du cluster d'utilisateur

Le fichier de blocs d'adresses IP de votre cluster d'utilisateur est défini comme valeur de network.ipMode.ipBlockFilePath dans la configuration de fichier de votre cluster d'utilisateur. Dans le fichier de blocs d'adresses IP, vous pouvez afficher les adresses IP disponibles pour les nœuds de calcul du cluster d'utilisateur.

Par exemple, voici un fichier de blocs d'adresses IP disposant de quatre adresses 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

Le fichier de bloc d'adresses IP ne contient pas d'adresses pour le ou les nœuds de plan de contrôle du cluster d'utilisateur. Si Controlplane V2 est activé dans le cluster d'utilisateur, les adresses IP des nœuds de plan de contrôle se trouvent dans la section network.controlPlaneIPBlock du fichier de configuration du cluster d'utilisateur. Sinon, les adresses IP des nœuds du plan de contrôle du cluster d'utilisateur se trouvent dans le fichier de bloc d'adresses IP du cluster d'administrateur.

Ajouter des adresses IP à un cluster d'utilisateur

Pour ajouter d'autres adresses IP aux nœuds de votre cluster d'utilisateur, ajoutez des adresses à votre fichier de blocs d'adresses IP, puis exécutez la commande suivante pour mettre à jour votre cluster d'utilisateur :

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config USER_CLUSTER_CONFIG