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

Per il dominio di gestione, tutti i cluster vSphere devono utilizzare vSAN come storage principale. Per i domini del carico di lavoro VI, i cluster vSphere possono utilizzare vSAN, NFS, VMFS su FC o vVols come storage principale. Se un dominio del carico di lavoro VI dispone di più cluster, ogni cluster può utilizzare un tipo diverso di storage principale, purché tutti gli host di un cluster vSphere utilizzino lo stesso tipo.

È possibile eseguire più attività di aggiunta di cluster contemporaneamente.

Questa procedura utilizza clusterCreationSpec per aggiungere un cluster vSphere a un dominio del carico di lavoro tramite l'API di VMware Cloud Foundation. Si concentra su due sezioni specifiche di clusterCreationSpec, ovvero hostSpecs e networkSpec che consentono di aggiungere un cluster vSphere con più di un vDS o di utilizzare host ESXi con più di due pNIC.

Sarà necessario modificare queste sezioni e completare le altre sezioni di clusterCreationSpec richieste per l'ambiente in uso. Per informazioni dettagliate su tutte le sezioni di clusterCreationSpec, vedere la Guida di riferimento dell'API di VMware Cloud Foundation. Alla fine di questa procedura, è disponibile un esempio di clusterCreationSpec.

Gli esempi nella procedura seguente si basano sullo scenario 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
Mappatura da vDS al tipo di traffico
  • sfo-w01-cl02-vds01: gestione e vMotion
  • sfo-w01-cl02-vds02: vSAN, overlay host e uplink Edge
Modificare gli esempi in base all'ambiente di VMware Cloud Foundation in uso.

Prerequisiti

  • Verificare che nell'inventario di SDDC Manager siano disponibili almeno tre host. Per informazioni sul commissioning degli host, vedere Commissioning degli host.
    Nota: Se il cluster vSphere utilizza NFS, VMFS su FC o vVols come storage principale e il dominio del carico di lavoro VI utilizza le immagini di vSphere Lifecycle Manager come metodo di aggiornamento, sono necessari solo due host. Workload Management richiede un cluster vSphere con almeno tre host ESXi.
  • Assicurarsi che gli host che si desidera aggiungere al cluster vSphere abbiano stato attivo.
  • Per l'host da aggiungere, è necessario disporre di una licenza di vSphere e vSAN (se si utilizza lo storage vSAN) valida specificata nella scheda Licenze dell'Interfaccia utente di SDDC Manager con socket adeguati. Per ulteriori informazioni, vedere Aggiunta di una chiave di licenza.
    Nota: Se si utilizza VCF+, le chiavi di licenza non sono necessarie.
  • Se si utilizza DHCP per la rete di overlay dell'host NSX, è necessario configurare un server DHCP nella VLAN di overlay dell'host NSX del dominio di gestione. Quando NSX crea TEP per il dominio del carico di lavoro VI, a tali TEP vengono assegnati indirizzi IP dal server DHCP.

Procedura

  1. Recuperare gli ID per gli host ESXi che si desidera aggiungere al 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 di ogni host che si desidera aggiungere al dominio del carico di lavoro VI.
  2. In un editor di testo creare una specifica JSON per hostSpecs. Ad esempio:
    "hostSpecs" : [ {
            "id" : "0ac30e66-7f65-4477-8331-80c3777c153c",
            "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
            "username" : "root",
            "hostNetworkSpec" : {
              "vmNics" : [ {
                "id" : "vmnic0",
                "vdsName" : "sfo-w01-cl02-vds01"
              }, {
                "id" : "vmnic1",
                "vdsName" : "sfo-w01-cl02-vds01"
              }, {
                "id" : "vmnic2",
                "vdsName" : "sfo-w01-cl02-vds02"
              }, {
                "id" : "vmnic3",
                "vdsName" : "sfo-w01-cl02-vds02"
              } ]
            }
          },
    Per ogni host ESXi aggiungere una sezione che includa:
    • id
    • licenseKey
      Nota: Se si utilizza VCF+, le chiavi di licenza non sono necessarie.
    • userName
    • hostNetworkSpec
    Utilizzare gli ID degli host ESXi del passaggio 1.
  3. Recuperare l'ID del dominio del carico di lavoro a cui si sta aggiungendo 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 dei domini e fare clic su GET /v1/domains.
    3. Fare clic su Esegui.
    4. Nella risposta individuare e copiare l'ID del dominio del carico di lavoro a cui si desidera aggiungere un cluster vSphere.
  4. In un editor di testo creare una specifica JSON per networkSpec. Ad esempio:
     "networkSpec" : {
                 "vdsSpecs": [
                   {
                       "name": "sfo-w01-cl02-vds01",
                       "portGroupSpecs": [
                           {
                               "name": "sfo01-w01-cl02-vds01-pg-mgmt",
                               "transportType": "MANAGEMENT"
                           },
                           {
                               "name": "sfo01-w01-cl02-vds01-pg-vmotion",
                               "transportType": "VMOTION"
                           }
                       ]
                   },
                   {
                       "name": "sfo-w01-cl02-vds02",
                       "isUsedByNsxt": true,
                       "portGroupSpecs": [
                           {
                               "name": "sfo01-w01-cl02-vds02-pg-vsan",
                               "transportType": "VSAN"
                           }
                       ]
                    }],
                     "nsxClusterSpec" : 
                        {
                        "nsxTClusterSpec" : 
                           {
                        "geneveVlanId" : 12
                           }
                        }
              }
    Nota: Specificare "isUsedByNsxt": true per il vDS da utilizzare per il traffico di overlay dell'host. Se sono presenti più vSphere Distributed Switch, solo uno può specificare "isUsedByNsxt": true.
  5. Nell'Interfaccia utente di SDDC Manager fare clic su Centro sviluppatori > Esplora API.
  6. Espandere la sezione API per la gestione dei cluster e fare clic su POST /v1/clusters/validations.
  7. Nella colonna Descrizione/Tipo di dati fare clic su ClusterCreationSpec.
    clusterCreationSpec in Esplora API
  8. Sostituire la sezione hostSpecs con le informazioni del file JSON hostSpecs.
  9. Sostituire la sezione networkSpec con le informazioni del file JSON networkSpec.
  10. Sostituire domainId con l'ID del dominio del carico di lavoro del passaggio 3.
  11. Aggiornare o rimuovere le altre sezioni di clusterCreationSpec in base ai requisiti del cluster vSphere che si sta aggiungendo.
    Alla fine di questa procedura, è disponibile un esempio di clusterCreationSpec.
  12. Fare clic su Esegui per convalidare clusterCreationSpec.
    Se la convalida riesce, copiare il contenuto di clusterCreationSpec e procedere con il passaggio successivo. Se la convalida non riesce, controllare gli errori nella risposta, aggiornare clusterCreationSpec ed eseguire nuovamente la convalida.
  13. Espandere la sezione API per la gestione dei cluster e fare clic su POST /v1/clusters.
  14. Incollare il contenuto della specifica clusterCreationSpec convalidata e fare clic su Esegui.
    È possibile utilizzare la proprietà skipFailedHosts per stabilire cosa succede quando uno o più degli host ESXi selezionati per il cluster non sono integri. Se si specifica "skipFailedHosts":false e il nuovo cluster include un host non integro, la creazione del cluster non riesce. Se si specifica "skipFailedHosts":true e il nuovo cluster include un host non integro, la creazione del cluster riesce purché sia stato selezionato un numero sufficiente di host integri da soddisfare i requisiti minimi per un nuovo cluster. Se non è presente un numero sufficiente di host integri, la creazione del cluster non riuscirà. Se non si specifica alcun valore per skipFailedHosts, viene impostato il valore predefinito del sistema, ovvero "skipFailedHosts":true.
    Utilizzare il pannello Attività nell' Interfaccia utente di SDDC Manager per monitorare l'aggiunta del cluster vSphere al dominio del carico di lavoro.

Esempio

Esempio di una specifica di clusterCreationSpec completa
{
  "domainId": "7d7cf328-5e79-45f5-9b1c-3973f951a910",
  "computeSpec": {
    "clusterSpecs": [
      {
        "name": "sfo-w01-cl02",
        "hostSpecs": [
          {
            "id": "e0579270-7a67-4af6-9f5b-99905160c953",
            "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
            "hostNetworkSpec": {
              "vmNics": [
                {
                  "id": "vmnic0",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic1",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic2",
                  "vdsName": "sfo-w01-cl02-vds02"
                },
                {
                  "id": "vmnic3",
                  "vdsName": "sfo-w01-cl02-vds02"
                }
              ]
            }
          },
          {
            "id": "d9db5f30-72a0-4829-8882-17fe5610a03b",
            "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
            "hostNetworkSpec": {
              "vmNics": [
                {
                  "id": "vmnic0",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic1",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic2",
                  "vdsName": "sfo-w01-cl02-vds02"
                },
                {
                  "id": "vmnic3",
                  "vdsName": "sfo-w01-cl02-vds02"
                }
              ]
            }
          },
          {
            "id": "13148430-f151-4fdc-b5f3-083590674e12",
            "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
            "hostNetworkSpec": {
              "vmNics": [
                {
                  "id": "vmnic0",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic1",
                  "vdsName": "sfo-w01-cl02-vds01"
                },
                {
                  "id": "vmnic2",
                  "vdsName": "sfo-w01-cl02-vds02"
                },
                {
                  "id": "vmnic3",
                  "vdsName": "sfo-w01-cl02-vds02"
                }
              ]
            }
          }
        ],
        "datastoreSpec": {
          "vsanDatastoreSpec": {
            "failuresToTolerate": 1,
            "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
            "datastoreName": "sfo-w01-cl02-ds-vsan01"
          }
        },
        "networkSpec": {
          "vdsSpecs": [
            {
              "name": "sfo-w01-cl02-vds01",
              "portGroupSpecs": [
                {
                  "name": "sfo-w01-cl02-vds01-pg-mgmt",
                  "transportType": "MANAGEMENT"
                },
                {
                  "name": "sfo-w01-cl02-vds01-pg-vmotion",
                  "transportType": "VMOTION"
                }
              ]
            },
            {
              "name": "sfo-w01-cl02-vds02",
              "isUsedByNsxt": true,
              "portGroupSpecs": [
                {
                  "name": "sfo-w01-cl02-vds02-pg-vsan",
                  "transportType": "VSAN"
                }
              ]
            }
          ],
          "nsxClusterSpec": {
            "nsxTClusterSpec": {
              "geneveVlanId": ""
            }
          }
        }
      }
    ]
  },
  "advancedOptions": {
    "evcMode": "",
    "highAvailability": {
      "enabled": true
    }
  }
}