Fichier de bloc d'adresses IP

Cette page décrit les champs d'un fichier de bloc d'adresses IP, utilisé lors de la configuration de Google Distributed Cloud.

Vous utilisez un fichier de bloc d'adresses IP pour décrire un ensemble de machines de nœuds et le réseau auquel elles sont connectées. Vous devez créer un fichier de bloc d'adresses IP distinct pour chaque cluster. Les fichiers de configuration du cluster d'administrateur et du cluster d'utilisateur comportent un champ appelé network.ipMode.ipBlockFilePath. Dans ce champ, vous spécifiez le chemin d'accès absolu ou relatif du bloc d'adresses IP.

Utilisez un fichier de bloc d'adresses IP pour lister les adresses IP et, éventuellement, les noms d'hôte dans les cas suivants :

  • Clusters d'utilisateur :

    • Si network.ipMode.type est défini sur "static" dans le fichier de configuration du cluster d'utilisateur, listez les adresses IP des nœuds de calcul dans le fichier de bloc d'adresses IP du cluster d'utilisateur.

    • Si infraConfigFilePath est configuré dans le fichier de configuration du cluster d'administrateur (ce qui active les domaines de topologie), listez les adresses IP des nœuds du plan de contrôle dans le fichier de bloc d'adresses IP du cluster d'utilisateur. Les adresses IP des nœuds du plan de contrôle sont toujours des adresses IP statiques, même si les nœuds de calcul utilisent DHCP.

  • Clusters d'administrateur :

    • Si infraConfigFilePath est configuré dans le fichier de configuration du cluster d'administrateur (ce qui active les domaines de topologie), listez les adresses IP des nœuds du plan de contrôle dans le fichier de bloc d'adresses IP du cluster d'administrateur.

    • Cluster d'administrateur non haute disponibilité version 1.16 ou antérieure : listez les adresses IP du nœud de plan de contrôle et des nœuds de module complémentaire dans le fichier de bloc d'adresses IP du cluster d'administrateur.

    • Cluster d'administrateur HA version 1.16 ou antérieure : listez les adresses IP des nœuds de module complémentaire dans un fichier de bloc d'adresses IP.

    • Clusters utilisateur kubeception 1.29 et versions antérieures : listez les adresses IP des nœuds du plan de contrôle du cluster d'utilisateur dans le fichier de bloc d'adresses IP du cluster d'administrateur.

Modèle

Remplir les champs dans un fichier de bloc d'adresses IP

Cette section décrit les champs d'un fichier de bloc d'adresses IP.

blocks

Tableau d'objets, chacun décrivant un ensemble d'hôtes.

blocks[i].netmask

Chaîne. Masque de sous-réseau pour l'ensemble des hôtes. Exemple :

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

Chaîne. Adresse de la passerelle par défaut pour l'ensemble des hôtes. Exemple :

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

blocks[i].ips

Tableau d'objets. Chaque objet possède une adresse IP individuelle ou un bloc CIDR d'adresses IP.

  • Si l'objet possède une adresse IP individuelle, il peut également comporter un nom d'hôte (facultatif).

  • Si vous définissez ip sur un bloc CIDR, ne spécifiez pas de valeur pour hostname.

  • Lorsque vous ne spécifiez pas de valeur pour hostname, Google Distributed Cloud utilise le nom de la VM de vSphere comme nom d'hôte.

blocks[i].isControlPlane

Si infraConfigFilePath est configuré dans le fichier de configuration du cluster d'administrateur et si l'adresse IP correspond à un nœud de plan de contrôle, incluez isControlPlane: true. Pour les nœuds de calcul de cluster utilisateur, spécifiez false ou omettez le champ, car la valeur par défaut est false.

Exemples de fichiers de configuration

Cette section fournit des configurations avec des exemples de valeurs renseignés.

Exemple 1

Cet exemple spécifie six adresses IP : deux adresses individuelles et un bloc CIDR de quatre adresses.

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

Exemple 2

Cet exemple montre un fichier de bloc d'adresses IP configuré pour les domaines de topologie.

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

Cet exemple de fichier de bloc d'adresses IP a réservé des adresses IP de trois sous-réseaux, chacun étant représenté par blocks[i]. Le blocks[i].gateway est important, car il sert à identifier le bloc d'adresses IP. Vous ajoutez la même adresse IP à topologyDomains[i].network.gateway dans la ressource personnalisée VSphereInfraConfig à l'intérieur du fichier de configuration de l'infrastructure vSphere.

Trois adresses IP sont configurées avec isControlPlane: true, ce qui indique qu'elles sont réservées aux nœuds du plan de contrôle uniquement. Dans le fichier de bloc d'adresses IP du cluster d'administrateur ou du cluster d'utilisateur, trois adresses IP doivent être réservées aux nœuds du plan de contrôle. Réservez-les dans le sous-réseau cible en fonction de la topologie applicable du cluster.

Étant donné que les nœuds du plan de contrôle doivent se trouver dans un seul domaine de topologie, les adresses IP des nœuds du plan de contrôle doivent se trouver dans le même bloc d'adresses IP.