Gérer les adresses IP des nœuds

Ce document fournit des conseils sur le nombre d'adresses IP nécessaires 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 afin qu'il obtienne les adresses IP de ses nœuds de calcul à partir 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 d'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'utilisateur. Si Controlplane V2 est activé pour un cluster d'utilisateur, les nœuds du plan de contrôle du cluster d'utilisateur s'exécutent dans le cluster d'utilisateur. Les clusters d'utilisateur pour lesquels Controlplane V2 est activé n'affectent pas le nombre d'adresses IP nécessaires à un cluster d'administrateur.

Si Controlplane V2 n'est pas activé pour un cluster d'utilisateur, le plan de contrôle du cluster d'utilisateur s'exécute sur un ou plusieurs nœuds du cluster d'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 d'utilisateur à haute disponibilité, le cluster d'administrateur a besoin de trois nœuds afin d'exécuter le plan de contrôle du cluster d'utilisateur.

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

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

Exemples :

Description Nombre d'adresses IP
Cluster d'administrateur haute disponibilité qui gère un cluster d'utilisateur Controlplane V2
3 nœuds de plan de contrôle

3
Cluster d'administrateur haute disponibilité qui gère un cluster d'utilisateur kubeception à haute disponibilité
3 nœuds de plan de contrôle + 3 nœuds de plan de contrôle pour le 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), utilisez un ou trois nœuds pour exécuter le plan de contrôle sur le cluster d'utilisateur:

    • Un nœud pour un cluster d'utilisateur standard

    • Trois nœuds pour un cluster d'utilisateur haute disponibilité

  • Une adresse IP pour chaque nœud de calcul (nœuds qui exécutent vos charges de travail)

  • 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 est capable de fournir les adresses IP supplémentaires.

Exemples :

Description Nombre d'adresses IP
Cluster d'utilisateur standard, plan de contrôle V2
3 nœuds de calcul + 1 nœud de plan de contrôle + 1 nœud supplémentaire

5
Cluster d'utilisateur à haute disponibilité, 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 du 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 du plan de contrôle des clusters d'utilisateur. Spécifiez ces adresses dans un fichier de blocs d'adresses IP. Ensuite, dans le fichier de configuration de votre cluster d'administrateur, indiquez le chemin d'accès du fichier de bloc d'adresses IP dans le champ network.ipMode.ipBlockFilePath.

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

Voici un exemple de fichier de blocs 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 voir 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 blocs d'adresses IP ne contient pas d'adresses pour le ou les nœuds du plan de contrôle du cluster d'utilisateur. Si Controlplane V2 est activé sur le cluster d'utilisateur, les adresses IP des nœuds du 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 blocs 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

Remplacez les éléments suivants :

  • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur

  • USER_CLUSTER_CONFIG : chemin d'accès au fichier de configuration du cluster d'utilisateur