Aggiunta di un host a un cluster vSphere tramite l'API di VMware Cloud Foundation

Se si desidera aggiungere un host ESXi con più di due pNIC oppure un host a un cluster vSphere con più di un vSphere Distributed Switch (vDS), è necessario utilizzare l'API di VMware Cloud Foundation.

Questa procedura utilizza clusterUpdateSpec per aggiungere un host ESXi con più di due pNIC oppure un host a un cluster vSphere con più di un vSphere Distributed Switch (vDS) tramite l'API di VMware Cloud Foundation.

Gli esempi della procedura seguente si basano su uno scenario in cui il cluster vSphere esistente e gli host ESXi hanno la configurazione seguente:

Due vSphere Distributed Switch	sfo-w01-cl02-vds01 sfo-w01-cl02-vds02
Quattro pNIC	vmnic0 vmnic1 vmnic2 vmnic3
Mappatura da pNIC a vDS	Da vmnic0 e vmnic1 a sfo-w01-cl02-vds01 Da vmnic2 e vmnic3 a sfo-w01-cl02-vds02

Modificare gli esempi in base all'ambiente in uso. Vedere Espansione di un cluster nella Guida di riferimento dell'API di VMware Cloud Foundation per ulteriori informazioni su clusterUpdateSpec, inclusi i parametri aggiuntivi.

Nota: Quando si aggiunge un host ESXi a un cluster vSphere, non si specifica la mappatura di vDS al tipo di traffico. Per un nuovo host ESXi, il traffico viene distribuito come per gli altri host ESXi nel cluster vSphere.

È possibile aggiungere host a più cluster vSphere diversi in parallelo oppure rimuovere host da più cluster vSphere diversi in parallelo. Ad esempio, si aggiungono tre host al cluster A e, mentre tale attività è in esecuzione, è possibile avviare un'attività separata per aggiungere (o rimuovere) quattro host al Cluster B. Vedere Valori massimi di configurazione di VMware per informazioni sul numero massimo di attività di aggiunta/rimozione di host che è possibile eseguire in parallelo.

Prerequisiti

Verificare che sia disponibile un host nell'inventario di SDDC Manager. Per informazioni sul commissioning degli host, vedere Commissioning degli host.
Verificare che l'host che si desidera aggiungere abbia stato attivo. Vedere Visualizzazione dell'inventario degli host.
Verificare che nell'inventario di SDDC Manager sia disponibile una licenza di vSphere valida con socket adeguati. Vedere Aggiunta di una chiave di licenza
Nota: Se si utilizza VCF+, le chiavi di licenza non sono necessarie.
Verificare che l'host da aggiungere corrisponda alla configurazione degli host già presenti nel cluster vSphere. In questo modo, la configurazione del cluster vSphere rimane bilanciata. Se l'host da aggiungere non corrisponde agli host preesistenti nel cluster vSphere, il cluster non sarà bilanciato e verrà visualizzato un avviso. L'avviso non impedisce l'espansione e può essere ignorato se necessario.
Verificare che l'host che si sta aggiungendo disponga dello stesso tipo di storage principale degli host esistenti nel cluster vSphere. Per il dominio di gestione l'host deve utilizzare vSAN come storage principale. Per i domini del carico di lavoro VI, l'host può utilizzare vSAN, NFS, VMFS su FC o vVols come storage principale. Un host che utilizza NFS come storage principale userà automaticamente la stessa configurazione di NFS degli altri host nel cluster vSphere. Per un host che utilizza VMFS su FC, è necessario configurare la creazione di zone, montare i volumi associati e creare il datastore nell'host prima di aggiungere l'host a un cluster vSphere. Un host che utilizza vVols come storage principale userà automaticamente la stessa configurazione di vVols degli altri host nel cluster vSphere.
Se il cluster vSphere ospita un cluster NSX Edge, è possibile aggiungere solo nuovi host con le stesse reti di gestione, di uplink, di overlay dell'host NSX e di overlay di NSX Edge (uniforme L2) degli host esistenti.
Se il cluster vSphere a cui si aggiungono host utilizza un pool di IP statici per i TEP della rete di overlay dell'host NSX, tale pool deve includere indirizzi IP sufficienti per gli host che si stanno aggiungendo.
Affinché sia possibile aggiungere un host ESXi con più di due pNIC, il cluster vSphere deve già contenere host ESXi con più di due pNIC.

Procedura

Recuperare l'ID dell'host ESXi che si desidera aggiungere a un cluster vSphere.
1. Nell'Interfaccia utente di SDDC Manager fare clic su Centro sviluppatori > Esplora API.
2. Espandere la sezione API per la gestione degli host e fare clic su GET /v1/hosts.
3. Immettere UNASSIGNED_USEABLE nella casella di testo dello stato e fare clic su Esegui.
4. Nella risposta individuare e copiare l'ID dell'host che si desidera aggiungere al cluster vSphere.

In un editor di testo creare una specifica JSON per clusterUpdateSpec. Ad esempio:

Nota: Se si utilizza VCF+, le chiavi di licenza non sono necessarie.

{
    "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"
               }]
           }
       }]
   }
}

Recuperare l'ID per il cluster vSphere a cui si desidera aggiungere l'host ESXi.
1. Nell'Interfaccia utente di SDDC Manager fare clic su Centro sviluppatori > Esplora API.
2. Espandere la sezione API per la gestione dei cluster e fare clic su GET /v1/clusters.
3. Nella risposta individuare e copiare l'ID del cluster vSphere di destinazione.
Convalidare clusterUpdateSpec.
1. Espandere la sezione API per la gestione dei cluster e fare clic su POST /v1/clusters/{id}/validations.
2. Incollare l'ID del cluster del passaggio 3, incollare clusterUpdateSpec del passaggio 2 e fare clic su Esegui.
  Se la convalida riesce, procedere con il passaggio successivo. Se la convalida non riesce, controllare gli errori nella risposta, aggiornare clusterUpdateSpec ed eseguire nuovamente la convalida.
Aggiungere l'host ESXi al cluster vSphere.
1. Espandere la sezione API per la gestione dei cluster e fare clic su PATCH /v1/clusters/{id}.
2. Incollare l'ID del cluster del passaggio 3, incollare la specifica clusterUpdateSpec convalidata e fare clic su Esegui.
  
  Utilizzare il pannello Attività in Interfaccia utente di SDDC Manager per monitorare l'aggiunta dell'host ESXi al cluster vSphere.