Se si desidera creare un dominio del carico di lavoro VI 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.

Questa procedura utilizza domainCreationSpec per creare un nuovo dominio del carico di lavoro VI tramite l'API di VMware Cloud Foundation. Si concentra su due sezioni specifiche di domainCreationSpec che consentono di creare un dominio del carico di lavoro VI con più di un vDS o di utilizzare host ESXi con più di due pNIC, ovvero hostSpecs e vdsSpecs.

Modificare queste sezioni e completare le altre sezioni di domainCreationSpec necessarie per l'ambiente in uso. Per informazioni dettagliate su tutte le sezioni di domainCreationSpec, vedere la Guida di riferimento dell'API di VMware Cloud Foundation. Alla fine di questa procedura, è disponibile un esempio di domainCreationSpec.
Nota: Se si desidera che il nuovo dominio del carico di lavoro VI utilizzi un nuovo dominio di vCenter Single Sign-On non utilizzato da altri domini del carico di lavoro, è necessario includere ssoDomainSpec. Prima di poter creare un nuovo dominio SSO, è necessario aggiornare tutti i componenti del dominio di gestione a VMware Cloud Foundation 5.0.

È possibile utilizzare l'API di VMware Cloud Foundation per eseguire più attività POST /v1/domains in parallelo. Se i domini del carico di lavoro VI che si stanno creando utilizzeranno un'istanza di NSX esistente, tale istanza deve già appartenere a un dominio del carico di lavoro distribuito correttamente.

Gli esempi nella procedura seguente si basano sullo scenario seguente.
Due vSphere Distributed Switch
  • sfo-w01-cl01-vds01
  • sfo-w01-cl01-vds02
Quattro pNIC
  • vmnic0
  • vmnic1
  • vmnic2
  • vmnic3
Mappatura da pNIC a vDS
  • vmnic0 e da vmnic1 a sfo-w01-cl01-vds01
  • vmnic2 e da vmnic3 a sfo-w01-cl01-vds02
Mappatura da vDS al tipo di traffico
  • sfo-w01-cl01-vds01: gestione e vMotion
  • sfo-w01-cl01-vds02: vSAN, overlay host e uplink Edge
Modificare gli esempi in base all'ambiente di VMware Cloud Foundation in uso.
Nota: Se si utilizza VCF+, le chiavi di licenza non sono necessarie.

Prerequisiti

Vedere Prerequisiti per un dominio del carico di lavoro.

Procedura

  1. Recuperare gli ID per gli host ESXi che si desidera aggiungere al dominio del carico di lavoro VI.
    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-cl01-vds01"
          }, {
            "id" : "vmnic1",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic2",
            "vdsName" : "sfo-w01-cl01-vds02"
          }, {
            "id" : "vmnic3",
            "vdsName" : "sfo-w01-cl01-vds02"
          } ]
        }
      },
    Per ogni host ESXi aggiungere una sezione che includa:
    • id
    • licenseKey
    • userName
    • hostNetworkSpec
    Utilizzare gli ID degli host ESXi del passaggio 1.
  3. In un editor di testo creare una specifica JSON per vdsSpecs. Ad esempio: 
    "vdsSpecs": [
               {
                   "name": "sfo-w01-cl01-vds01",
                   "portGroupSpecs": [
                       {
                           "name": "sfo01-w01-cl01-vds01-pg-mgmt",
                           "transportType": "MANAGEMENT"
                       },
                       {
                           "name": "sfo01-w01-cl01-vds01-pg-vmotion",
                           "transportType": "VMOTION"
                       }
                   ]
               },
               {
                   "name": "sfo-w01-cl01-vds02",
                   "portGroupSpecs": [
                       {
                           "name": "sfo01-w01-cl01-vds02-pg-vsan",
                           "transportType": "VSAN"
                       }
                   ],
                   "isUsedByNsxt": true
               }
    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.
  4. Nell'Interfaccia utente di SDDC Manager fare clic su Centro sviluppatori > Esplora API.
  5. Espandere la sezione API per la gestione dei domini e fare clic su POST /v1/domains/validations.
  6. Nella colonna Descrizione/Tipo di dati fare clic su DomainCreationSpec.
    Convalida di domainCreationSpec in Esplora API
  7. Sostituire la sezione hostSpecs con le informazioni del file JSON hostSpecs.
  8. Sostituire la sezione vdsSpecs con le informazioni del file JSON vdsSpecs.
  9. Aggiornare o rimuovere le altre sezioni di domainCreationSpec in base al dominio del carico di lavoro VI che si sta creando.
    Alla fine di questa procedura, è disponibile un esempio di domainCreationSpec.
  10. Fare clic su Esegui per convalidare domainCreationSpec.
    Se la convalida riesce, copiare il contenuto di domainCreationSpec e procedere con il passaggio successivo. Se la convalida non riesce, controllare gli errori nella risposta, aggiornare domainCreationSpec ed eseguire nuovamente la convalida.
  11. Espandere la sezione API per la gestione dei domini e fare clic su POST /v1/domains.
  12. Incollare il contenuto di domainCreationSpec convalidato e fare clic su Esegui.
    Utilizzare il pannello Attività in Interfaccia utente di SDDC Manager per monitorare la creazione del dominio del carico di lavoro VI.

Esempio

Esempio di una specifica di domainCreationSpec completa 
{
  "domainName" : "sfo-w01",
  "vcenterSpec" : {
    "name" : "sfo-w01-vc01",
    "networkDetailsSpec" : {
      "ipAddress" : "10.0.0.43",
      "dnsName" : "sfo-w01-vc01.vrack.vsphere.local",
      "gateway" : "10.0.0.250",
      "subnetMask" : "255.255.255.0"
    },
    "rootPassword" : "<password>",
    "datacenterName" : "sfo-w01-dc01",
    "vmSize" : "medium",
    "storageSize" : "lstorage"
  },
  "computeSpec" : {
    "clusterSpecs" : [ {
      "name" : "sfo-w01-cl01",
      "hostSpecs" : [ {
        "id" : "0ac30e66-7f65-4477-8331-80c3777c153c",
        "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"
          } ]
        }
      }, {
        "id" : "05d1a8df-773a-46bb-8838-dcb5bb3358ea",
        "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"
          } ]
        }
      }, {
        "id" : "2b8b770f-265d-4a63-b830-9c98038c81b2",
        "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"
          } ]
        }
      } ],
      "datastoreSpec" : {
        "vsanDatastoreSpec" : {
          "failuresToTolerate" : 1,
          "licenseKey" : "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
          "datastoreName" : "sfo-w01-cl01-ds-vsan01"
        }
      },
      "networkSpec" : {
        "vdsSpecs" : [ {
          "name" : "sfo-w01-cl01-vds01",
          "portGroupSpecs" : [ {
            "name" : "sfo-w01-cl01-vds01-pg-mgmt",
            "transportType" : "MANAGEMENT"
          }, {
            "name" : "sfo-w01-cl01-vds01-pg-vmotion",
            "transportType" : "VMOTION"
          }]
        }, {
          "name" : "sfo-w01-cl01-vds02",
          "portGroupSpecs" : [ {
            "name" : "sfo-w01-cl01-vds02-pg-vsan",
            "transportType" : "VSAN"
          } ],
          "isUsedByNsxt" : true
        } ],
        "nsxClusterSpec" : {
          "nsxTClusterSpec" : {
            "geneveVlanId" : 2,
            "ipAddressPoolSpec" : {
                "name" : "static-ip-pool-01",
                "subnets" : [ {
                  "ipAddressPoolRanges" : [ {
                    "start" : "10.0.11.50",
                    "end" : "10.0.11.70"
                  }, {
                    "start" : "10.0.11.80",
                    "end" : "10.0.11.150"
                  } ],
                  "cidr" : "10.0.11.0/24",
                  "gateway" : "10.0.11.250"
                } ]
              }
          }
        }
      }
    } ]
  },
  "nsxTSpec" : {
    "nsxManagerSpecs" : [ {
      "name" : "sfo-w01-nsx01a",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.44",
        "dnsName" : "sfo-w01-nsx01a.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    }, {
      "name" : "sfo-w01-nsx01b",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.45",
        "dnsName" : "sfo-w01-nsx01b.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    }, {
      "name" : "sfo-w01-nsx01c",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.46",
        "dnsName" : "sfo-w01-nsx01c.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    } ],
    "vip" : "10.0.0.166",
    "vipFqdn" : "sfo-w01-nsx01.vrack.vsphere.local",
    "licenseKey" : "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
    "nsxManagerAdminPassword" : "<password>",
    "formFactor" : "large"
  }
}