Mithilfe der VMware Cloud Foundation-API können Sie einen vSphere-Cluster mit mehr als einem vSphere Distributed Switch (vDS) hinzufügen oder ESXi-Hosts mit mehr als zwei pNICs verwenden.

In der Verwaltungsdomäne müssen alle vSphere-Cluster vSAN als Prinzipalspeicher verwenden. In VI-Arbeitslastdomänen können vSphere-Cluster vSAN, NFS, VMFS auf FC oder vVols als Prinzipalspeicher verwenden. Wenn eine VI-Arbeitslastdomäne über mehrere Cluster verfügt, kann jeder Cluster einen anderen Prinzipalspeichertyp verwenden, solange alle Hosts innerhalb eines vSphere-Clusters denselben Typ verwenden.

Sie können mehrere Aufgaben zum Hinzufügen von Clustern gleichzeitig ausführen.

In diesem Verfahren wird clusterCreationSpec zum Hinzufügen eines vSphere-Clusters zu einer Arbeitslastdomäne mithilfe der VMware Cloud Foundation-API verwendet. Der Schwerpunkt liegt auf zwei speziellen Abschnitten von clusterCreationSpec, mit denen Sie einen vSphere-Cluster mit mehr als einem vDS hinzufügen oder ESXi-Hosts mit mehr als zwei pNICS (hostSpecs und networkSpec) verwenden können.

Sie müssen diese Abschnitte ändern und die anderen für Ihre Umgebung erforderlichen Abschnitte von clusterCreationSpec ausfüllen. Im API-Referenzhandbuch zu VMware Cloud Foundation finden Sie Informationen zu allen Abschnitten von clusterCreationSpec. Am Ende dieses Verfahrens wird ein Beispiel für eine vollständige clusterCreationSpec angezeigt.

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

Voraussetzungen

  • Stellen Sie sicher, dass mindestens drei Hosts in der SDDC Manager-Bestandsliste verfügbar sind. Informationen zur Inbetriebnahme von Hosts finden Sie unter Inbetriebnahme von Hosts.
    Hinweis: Wenn der vSphere-Cluster NFS, VMFS auf FC oder vVols als Prinzipalspeicher und die VI-Arbeitslastdomäne vSphere Lifecycle Manager-Images als Aktualisierungsmethode verwendet, sind nur zwei Hosts erforderlich. Workload Management benötigt einen vSphere-Cluster mit mindestens drei ESXi-Hosts.
  • Stellen Sie sicher, dass sich die Hosts, die Sie zum vSphere-Cluster hinzufügen möchten, in einem aktiven Zustand befinden.
  • Sie müssen über eine gültige vSphere- und vSAN-Lizenz (bei Verwendung von vSAN-Speicher) verfügen, die auf der Registerkarte „Lizenzierung“ der SDDC Manager-Benutzeroberfläche angegeben ist und über geeignete Sockets für den hinzuzufügenden Host verfügt. Weitere Informationen finden Sie unter Hinzufügen eines Lizenzschlüssels.
    Hinweis: Wenn Sie VCF+ verwenden, sind keine Lizenzschlüssel erforderlich.
  • Wenn Sie DHCP für das NSX-Host-Overlay-Netzwerk verwenden, muss ein DHCP-Server auf dem NSX-Host-Overlay-VLAN der Verwaltungsdomäne konfiguriert werden. Wenn NSX TEPs für die VI-Arbeitslastdomäne erstellt, werden diesen IP-Adressen des DHCP-Servers zugewiesen.

Prozedur

  1. Rufen Sie die IDs für die ESXi-Hosts ab, die Sie dem vSphere-Cluster 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-cl02-vds01"
              }, {
                "id" : "vmnic1",
                "vdsName" : "sfo-w01-cl02-vds01"
              }, {
                "id" : "vmnic2",
                "vdsName" : "sfo-w01-cl02-vds02"
              }, {
                "id" : "vmnic3",
                "vdsName" : "sfo-w01-cl02-vds02"
              } ]
            }
          },
    Fügen Sie für jeden ESXi-Host einen Abschnitt hinzu, der Folgendes enthält:
    • id
    • licenseKey
      Hinweis: Wenn Sie VCF+ verwenden, sind keine Lizenzschlüssel erforderlich.
    • userName
    • hostNetworkSpec
    Verwenden Sie die IDs des ESXi-Hosts aus Schritt 1.
  3. Rufen Sie die ID der Arbeitslastdomäne ab, der Sie einen vSphere-Cluster hinzufügen.
    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 Domänen und klicken Sie auf GET /v1/domains.
    3. Klicken Sie auf Ausführen.
    4. Suchen Sie in der Antwort nach der ID der Arbeitslastdomäne, der Sie einen vSphere-Cluster hinzufügen möchten, und kopieren Sie die ID.
  4. Erstellen Sie in einem Texteditor eine JSON-Spezifikation für networkSpec. Beispiel:
     "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
                           }
                        }
              }
    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.
  5. Klicken Sie in der SDDC Manager-Benutzeroberfläche auf Developer Center > API-Explorer.
  6. Erweitern Sie den Abschnitt APIs für die Verwaltung von Clustern und klicken Sie auf POST /v1/clusters/validations.
  7. Klicken Sie in der Spalte Beschreibung/Datentyp auf ClusterCreationSpec.
    clusterCreationSpec im API-Explorer
  8. Ersetzen Sie den Abschnitt hostSpecs durch die Informationen aus der JSON-Datei von hostSpecs.
  9. Ersetzen Sie den Abschnitt networkSpec durch die Informationen aus der JSON-Datei von networkSpec.
  10. Ersetzen Sie die domainId durch die ID der Arbeitslastdomäne aus Schritt 3.
  11. Aktualisieren oder entfernen Sie die anderen Abschnitte der clusterCreationSpec nach Bedarf auf Basis des vSphere-Clusters, den Sie hinzufügen.
    Am Ende dieses Verfahrens wird ein Beispiel für eine vollständige clusterCreationSpec angezeigt.
  12. Klicken Sie auf Ausführen, um clusterCreationSpec zu validieren.
    Kopieren Sie bei erfolgreicher Validierung den Inhalt von clusterCreationSpec und fahren Sie mit dem nächsten Schritt fort. Wenn die Validierung fehlschlägt, überprüfen Sie die Fehler in der Antwort, aktualisieren Sie clusterCreationSpec und führen Sie eine erneute Validierung durch.
  13. Erweitern Sie den Abschnitt APIs für die Verwaltung von Clustern und klicken Sie auf POST /v1/clusters.
  14. Fügen Sie den validierten Inhalt von clusterCreationSpec ein und klicken Sie auf Ausführen.
    Mithilfe der Eigenschaft skipFailedHosts können Sie die Aufgaben festlegen, die durchgeführt werden müssen, wenn einer oder mehrere ESXi-Hosts, die Sie für den Cluster ausgewählt haben, fehlerhaft sind. Wenn Sie "skipFailedHosts":false angeben und Ihr neuer Cluster einen fehlerhaften Host enthält, schlägt die Clustererstellung fehl. Wenn Sie "skipFailedHosts":true angeben und Ihr neuer Cluster einen fehlerhaften Host enthält, wird die Clustererstellung erfolgreich ausgeführt, solange Sie genügend fehlerfreie Hosts ausgewählt haben, um die Mindestanforderungen für einen neuen Cluster zu erfüllen. Wenn Sie nicht über genügend ordnungsgemäße Hosts verfügen, schlägt die Clustererstellung fehl. Wenn Sie keinen Wert für skipFailedHosts angeben, wird vom System standardmäßig "skipFailedHosts":true verwendet.
    Überwachen Sie mithilfe des Bereichs Aufgaben auf der SDDC Manager-Benutzeroberfläche das Hinzufügen des vSphere-Clusters zur Arbeitslastdomäne.

Beispiel

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