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œud et le réseau auquel elles sont connectées. Vous créez 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. Vous spécifiez le chemin d'accès absolu ou relatif du bloc d'adresses IP dans ce champ.

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é 1.16 et versions antérieures : listez les adresses IP du nœud du plan de contrôle et des nœuds complémentaires dans le fichier de bloc d'adresses IP du cluster d'administrateur.

    • Cluster d'administrateur haute disponibilité 1.16 et versions antérieures : listez les adresses IP des nœuds complémentaires dans un fichier de bloc d'adresses IP.

    • Clusters d'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.

  • 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 que l'adresse IP concerne un nœud de plan de contrôle, incluez isControlPlane: true. Pour les nœuds de calcul du cluster d'utilisateur, spécifiez false ou omettez le champ, car la valeur par défaut est false.

Exemples de fichiers de configuration

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

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

Ce fichier de bloc d'adresses IP d'exemple a réservé des adresses IP à partir de trois sous-réseaux, et chaque sous-réseau est représenté par blocks[i]. blocks[i].gateway est important, car il sert d'identification du bloc d'adresses IP. Vous ajoutez la même adresse IP à topologyDomains[i].network.gateway dans la ressource personnaliséeVSphereInfraConfig à 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.