Ajouter un hôte à un cluster vSphere à l'aide de l'API VMware Cloud Foundation

Si vous souhaitez ajouter un hôte ESXi avec plus de deux pNIC ou ajouter un hôte à un cluster vSphere comportant plusieurs vSphere Distributed Switch (vDS), vous devez utiliser l'API VMware Cloud Foundation.

Cette procédure utilise clusterUpdateSpec pour ajouter un hôte ESXi avec plus de deux pNIC ou ajoute un hôte à un cluster vSphere comportant plusieurs commutateurs vSphere Distributed Switch (vDS) à l'aide de l'API VMware Cloud Foundation.

Les exemples de la procédure suivante sont basés sur un scénario dans lequel le cluster vSphere existant et les hôtes ESXi ont la configuration suivante :

Deux commutateurs vSphere Distributed Switch	sfo-w01-cl02-vds01 sfo-w01-cl02-vds02
Quatre pNIC	vmnic0 vmnic1 vmnic2 vmnic3
Mappage pNIC vers vDS	vmnic0 et vmnic1 vers sfo-w01-cl02-vds01 vmnic2 et vmnic3 vers sfo-w01-cl02-vds02

Modifiez les exemples en fonction de votre environnement. Pour plus d'informations sur clusterUpdateSpec, y compris les paramètres en option, reportez-vous à la section Développer un cluster du Guide de référence de l'API VMware Cloud Foundation.

Note : Ne spécifiez pas le mappage de vDS vers le type de trafic lors de l'ajout d'un hôte ESXi à un cluster vSphere. Pour un nouvel hôte ESXi, le trafic est distribué de la même manière que pour les autres hôtes ESXi du cluster vSphere.

Vous pouvez ajouter des hôtes à plusieurs clusters vSphere différents ou les supprimer en parallèle. Par exemple, vous ajoutez trois hôtes au cluster A et, pendant que cette tâche est en cours d'exécution, vous pouvez démarrer une tâche distincte pour ajouter (ou supprimer) quatre hôtes au cluster B. Reportez-vous à la section Valeurs maximales de configuration VMware pour plus d'informations sur le nombre maximal de tâches d'ajout/suppression d'hôtes que vous pouvez exécuter en parallèle.

Conditions préalables

Vérifiez qu'un hôte est disponible dans l'inventaire SDDC Manager. Pour plus d'informations sur la mise en service des hôtes, reportez-vous à la section Mettre en service des hôtes.
Vérifiez que l'hôte que vous souhaitez ajouter est dans un état actif. Reportez-vous à la section Afficher l'inventaire des hôtes.
Vérifiez que vous disposez d'une licence vSphere valide avec des sockets adéquats disponibles dans l'inventaire SDDC Manager. Reportez-vous à la section Ajouter une clé de licence.
Note : Si vous utilisez VCF+, les clés de licence ne sont pas requises.
Vérifiez que l'hôte à ajouter correspond à la configuration des hôtes déjà dans le cluster vSphere. Cela permet à la configuration du cluster vSphere de rester équilibrée. Si l'hôte à ajouter ne correspond pas aux hôtes préexistants dans le cluster vSphere, le cluster est déséquilibré et un avertissement s'affiche. L'avertissement n'empêche pas l'extension et peut être ignoré si nécessaire.
Vérifiez que l'hôte que vous ajoutez dispose du même type de stockage principal que les hôtes existants dans le cluster vSphere. Pour le domaine de gestion, l'hôte doit utiliser vSAN pour le stockage principal. Pour les domaines de charge de travail VI, l'hôte peut utiliser vSAN, NFS, VMFS sur FC ou vVols pour le stockage principal. Un hôte utilisant NFS pour le stockage principal utilisera automatiquement la même configuration NFS que les autres hôtes du cluster vSphere. Pour un hôte utilisant VMFS sur FC, vous devez configurer les volumes associés et créer la banque de données sur l'hôte avant d'ajouter l'hôte à un cluster vSphere. Un hôte utilisant des vVols pour le stockage principal utilisera automatiquement la même configuration de vVols que les autres hôtes du cluster vSphere.
Si le cluster vSphere héberge un cluster NSX Edge, vous pouvez uniquement ajouter de nouveaux hôtes avec les mêmes réseaux de gestion, de liaison montante, de superposition de l'hôte NSX et de superposition NSX Edge (Uniforme L2) comme hôtes existants.
Si le cluster vSphere auquel vous ajoutez des hôtes utilise un pool d'adresses IP statiques pour les TEP de réseau de superposition de l'hôte NSX, ce pool doit inclure suffisamment d'adresses IP pour les hôtes que vous ajoutez.
Pour ajouter un hôte ESXi avec plus de deux pNIC, le cluster vSphere doit déjà contenir des hôtes ESXi disposant de plus de deux pNIC.

Procédure

Obtenez l'ID de l'hôte ESXi que vous souhaitez ajouter à un cluster vSphere.
1. Dans Interface utilisateur de SDDC Manager, cliquez sur Centre de développement > Explorateur d'API.
2. Développez la section API pour la gestion des hôtes et cliquez sur GET /v1/hosts.
3. Entrez UNASSIGNED_USEABLE dans la zone de texte État et cliquez sur Exécuter.
4. Dans la réponse, localisez et copiez l'ID de l'hôte que vous souhaitez ajouter au cluster vSphere.

Dans un éditeur de texte, créez une spécification JSON pour clusterUpdateSpec. Par exemple :

Note : Si vous utilisez VCF+, les clés de licence ne sont pas requises.

{
    "clusterExpansionSpec": {
        "hostSpecs": [{
           "id": "d7c64c4f-6ca6-46f3-9527-b2c737cc4e92",
           "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
           "username": "root",
           "hostNetworkSpec": {
               "vmNics": [{
                   "id": "vmnic0",
                   "vdsName": "sfo-w01-cl01-vds01"
               }, {
                   "id": "vmnic1",
                   "vdsName": "sfo-w01-cl01-vds01"
               }, {
                   "id": "vmnic2",
                   "vdsName": "sfo-w01-cl01-vds02"
               }, {
                   "id": "vmnic3",
                   "vdsName": "sfo-w01-cl01-vds02"
               }]
           }
       }]
   }
}

Obtenez l'ID du cluster vSphere auquel vous souhaitez ajouter l'hôte ESXi.
1. Dans Interface utilisateur de SDDC Manager, cliquez sur Centre de développement > Explorateur d'API.
2. Développez la section API pour la gestion des clusters et cliquez sur GET /v1/clusters.
3. Dans la réponse, localisez et copiez l'ID du cluster vSphere cible.
Validez la spécification clusterUpdateSpec.
1. Développez la section API pour la gestion des clusters et cliquez sur POST /v1/clusters/{id}/validations.
2. Collez l'ID de cluster de l'étape 3, collez la spécification clusterUpdateSpec de l'étape 2, puis cliquez sur Exécuter.
  Si la validation réussit, passez à l'étape suivante. Si la validation échoue, vérifiez les erreurs dans la réponse, mettez à jour la spécification clusterUpdateSpec et validez-la de nouveau.
Ajoutez l'hôte ESXi au cluster vSphere.
1. Développez la section API pour la gestion des clusters et cliquez sur PATCH /v1/clusters/{id}.
2. Collez l'ID de cluster de l'étape 3, collez la spécification clusterUpdateSpec validée et cliquez sur Exécuter.
  
  Utilisez le panneau Tâches de l' Interface utilisateur de SDDC Manager pour surveiller l'ajout de l'hôte ESXi au cluster vSphere.