Mithilfe der VMware Cloud Foundation-API können Sie eine VI-Arbeitslastdomäne mit mehr als einem vSphere Distributed Switch (vDS) erstellen oder ESXi-Hosts mit mehr als zwei pNICs verwenden.

In diesem Verfahren wird die domainCreationSpec zum Erstellen einer neuen VI-Arbeitslastdomäne mithilfe der VMware Cloud Foundation-API verwendet. Der Schwerpunkt liegt auf zwei speziellen Abschnitten der domainCreationSpec, mit denen Sie eine VI-Arbeitslastdomäne mit mehr als einem vDS erstellen oder ESXi-Hosts mit mehr als zwei pNICS (hostSpecs und vdsSpecs) verwenden können.

Ändern Sie diese Abschnitte und füllen Sie die anderen für Ihre Umgebung erforderlichen Abschnitte der domainCreationSpec aus. Im API-Referenzhandbuch zu VMware Cloud Foundation finden Sie Informationen zu allen Abschnitten von domainCreationSpec. Am Ende dieses Verfahrens wird ein Beispiel für eine vollständige domainCreationSpec angezeigt.
Hinweis: Wenn die neue VI-Arbeitslastdomäne eine neue vCenter Single Sign-On-Domäne verwenden soll, die von keiner anderen Arbeitslastdomäne genutzt wird, müssen Sie die ssoDomainSpec einschließen. Alle Komponenten in der Verwaltungsdomäne müssen auf VMware Cloud Foundation 5.0 aktualisiert werden, bevor Sie eine neue SSO-Domäne erstellen können.

Sie können die VMware Cloud Foundation-API verwenden, um mehrere POST /v1/domains-Aufgaben gleichzeitig auszuführen. Wenn die von Ihnen erstellten VI-Arbeitslastdomänen eine vorhandene NSX-Instanz verwenden, muss diese NSX-Instanz bereits Teil einer erfolgreich bereitgestellten Arbeitslastdomäne sein.

Die Beispiele im folgenden Verfahren basieren auf dem folgenden Szenario.
Zwei vSphere Distributed Switches
  • sfo-w01-cl01-vds01
  • sfo-w01-cl01-vds02
Vier pNICs
  • vmnic0
  • vmnic1
  • vmnic2
  • vmnic3
Zuordnung zwischen pNIC und vDS
  • vmnic0 und vmnic1 zu sfo-w01-cl01-vds01
  • vmnic2 und vmnic3 zu sfo-w01-cl01-vds02
Zuordnung zwischen vDS und Datenverkehrstyp
  • sfo-w01-cl01-vds01: Verwaltung und vMotion
  • sfo-w01-cl01-vds02: vSAN, Host-Overlay und Edge-Uplinks
Ändern Sie die Beispiele auf Basis Ihrer VMware Cloud Foundation-Umgebung.
Hinweis: Wenn Sie VCF+ verwenden, sind keine Lizenzschlüssel erforderlich.

Voraussetzungen

Weitere Informationen finden Sie unter Voraussetzungen für eine Arbeitslastdomäne.

Prozedur

  1. Rufen Sie die IDs für die ESXi-Hosts ab, die Sie der VI-Arbeitslastdomäne hinzufügen möchten.
    1. Klicken Sie in der SDDC Manager-Benutzeroberfläche auf Developer Center > API-Explorer.
    2. Erweitern Sie den Abschnitt APIs für die Verwaltung von Hosts und klicken Sie auf GET /v1/hosts.
    3. Geben Sie UNASSIGNED_USEABLE im Textfeld „Status“ ein und klicken Sie auf Ausführen.
    4. Suchen Sie in der Antwort nach der ID jedes Hosts, den Sie zur VI-Arbeitslastdomäne hinzufügen möchten, und kopieren Sie die ID.
  2. Erstellen Sie in einem Texteditor eine JSON-Spezifikation für hostSpecs. Beispiel:
    "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"
              } ]
            }
          },
    Fügen Sie für jeden ESXi-Host einen Abschnitt hinzu, der Folgendes enthält:
    • id
    • licenseKey
    • userName
    • hostNetworkSpec
    Verwenden Sie die IDs des ESXi-Hosts aus Schritt 1.
  3. Erstellen Sie in einem Texteditor eine JSON-Spezifikation für die vdsSpecs. Beispiel:
    "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
                   }
    Hinweis: Geben Sie "isUsedByNsxt": true für den vDS an, der für Host-Overlay-Datenverkehr verwendet werden soll. Wenn Sie über mehrere vSphere Distributed Switches verfügen, kann nur einer von ihnen "isUsedByNsxt": true angeben.
  4. Klicken Sie in der SDDC Manager-Benutzeroberfläche auf Developer Center > API-Explorer.
  5. Erweitern Sie den Abschnitt APIs für die Verwaltung von Domänen und klicken Sie auf POST /v1/domains/validations.
  6. Klicken Sie in der Spalte Beschreibung/Datentyp auf DomainCreationSpec.
    domainCreationSpec-Validierung im API-Explorer
  7. Ersetzen Sie den Abschnitt hostSpecs durch die Informationen aus der JSON-Datei von hostSpecs.
  8. Ersetzen Sie den Abschnitt vdsSpecs durch die Informationen aus der JSON-Datei der vdsSpecs.
  9. Aktualisieren oder entfernen Sie die anderen Abschnitte der domainCreationSpec nach Bedarf auf Basis der VI-Arbeitslastdomäne, die Sie erstellen.
    Am Ende dieses Verfahrens wird ein Beispiel für eine vollständige domainCreationSpec angezeigt.
  10. Klicken Sie auf Ausführen, um die domainCreationSpec zu validieren.
    Kopieren Sie bei erfolgreicher Validierung den Inhalt der domainCreationSpec und fahren Sie mit dem nächsten Schritt fort. Wenn die Validierung fehlschlägt, überprüfen Sie die Fehler in der Antwort, aktualisieren Sie die domainCreationSpec und führen Sie eine erneute Validierung durch.
  11. Erweitern Sie den Abschnitt APIs für die Verwaltung von Domänen und klicken Sie auf POST /v1/domains.
  12. Fügen Sie den validierten Inhalt der domainCreationSpec ein und klicken Sie auf Ausführen.
    Verwenden Sie den Bereich Aufgaben auf der SDDC Manager-Benutzeroberfläche, um die Erstellung der VI-Arbeitslastdomäne zu überwachen.

Beispiel

Beispiel für eine vollständige domainCreationSpec
{
  "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"
  }
}