Hinzufügen eines Hosts zu einem vSphere-Cluster mithilfe der VMware Cloud Foundation-API

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

In diesem Verfahren wird der Parameter clusterUpdateSpec zum Hinzufügen eines ESXi-Hosts mit mehr als zwei pNICs verwendet. Fügen Sie alternativ mithilfe der VMware Cloud Foundation-API einen vSphere-Cluster mit mehr als einem vSphere Distributed Switch (vDS) hinzu.

"Die Beispiele im folgenden Verfahren basieren auf einem Szenario, in dem die vorhandenen vSphere-Cluster und ESXi-Hosts über die folgende Konfiguration verfügen:"

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

Ändern Sie die Beispiele auf Basis Ihrer Umgebung. Unter Erweitern eines Clusters im API-Referenzhandbuch zu VMware Cloud Foundation finden Sie weitere Informationen zu clusterUpdateSpec, einschließlich optionaler Parameter.

Hinweis: Sie geben keine Zuordnung zwischen vDS und Datenverkehrstyp an, wenn Sie einen ESXi-Host zu einem vSphere-Cluster hinzufügen. Bei einem neuen ESXi-Host wird der Datenverkehr genauso verteilt wie bei den anderen ESXi-Hosts im vSphere-Cluster.

Sie können mehreren verschiedenen vSphere-Clustern gleichzeitig Hosts hinzufügen oder Hosts daraus entfernen. Beispiel: Sie fügen drei Hosts zu Cluster A hinzu. Während diese Aufgabe ausgeführt wird, können Sie eine separate Aufgabe starten, um vier Hosts zu Cluster B hinzuzufügen (oder daraus zu entfernen). Informationen zur maximalen Anzahl an Aufgaben zum Hinzufügen/Entfernen von Hosts, die gleichzeitig ausgeführt werden können, finden Sie unter Maximalwerte für VMware-Konfiguration.

Voraussetzungen

Stellen Sie sicher, dass in der SDDC Manager-Bestandsliste ein Host vorhanden ist. Informationen zur Inbetriebnahme von Hosts finden Sie unter Inbetriebnahme von Hosts.
Stellen Sie sicher, dass sich der hinzuzufügende Host in einem aktiven Zustand befindet. Weitere Informationen finden Sie unter Anzeigen der Hostbestandsliste.
Stellen Sie sicher, dass Sie eine gültige vSphere-Lizenz mit geeigneten in der SDDC Manager-Bestandsliste verfügbaren Sockets besitzen. Siehe Hinzufügen eines Lizenzschlüssels.
Hinweis: Wenn Sie VCF+ verwenden, sind keine Lizenzschlüssel erforderlich.
Stellen Sie sicher, dass der hinzuzufügende Host mit der Konfiguration der Hosts übereinstimmt, die sich bereits im vSphere-Cluster befinden. Auf diese Weise bleibt die Konfiguration des vSphere-Clusters ausgeglichen. "Wenn der hinzuzufügende Host nicht mit den bereits vorhandenen Hosts im vSphere-Cluster übereinstimmt, ist der Cluster nicht ausgeglichen und eine Warnung wird angezeigt." Die Warnung verhindert die Erweiterung nicht und kann bei Bedarf verworfen werden.
Stellen Sie sicher, dass der hinzuzufügende Host denselben Prinzipalspeichertyp wie die vorhandenen Hosts im vSphere-Cluster aufweist. Der Host muss für die Verwaltungsdomäne vSAN als Prinzipalspeicher verwenden. Für VI-Arbeitslastdomänen kann der Host vSAN, NFS, VMFS auf FC oder vVols als Prinzipalspeicher verwenden. Ein Host, der NFS als Prinzipalspeicher verwendet, nutzt automatisch dieselbe NFS-Konfiguration wie die anderen Hosts im vSphere-Cluster. Für einen Host, der VMFS auf FC verwendet, müssen Sie die Zonenzuweisung konfigurieren, die zugehörigen Volumes mounten und den Datenspeicher auf dem Host erstellen, bevor Sie den Host zu einem vSphere-Cluster hinzufügen. Ein Host, der vVols als Prinzipalspeicher verwendet, nutzt automatisch dieselbe vVols-Konfiguration wie die anderen Hosts im vSphere-Cluster.
Wenn der vSphere-Cluster einen NSX Edge-Cluster hostet, können Sie nur neue Hosts mit denselben Verwaltungs-, Uplink- und NSX Edge-Overlay-Netzwerken (L2 (einheitlich)) wie die vorhandenen Hosts hinzufügen.
Wenn der vSphere-Cluster, dem Hosts hinzugefügt werden, einen statischen IP-Pool für die NSX-Host-Overlay-Netzwerk-TEPs verwendet, muss dieser Pool genügend IP-Adressen für die hinzuzufügenden Hosts enthalten.
Zum Hinzufügen eines ESXi-Hosts mit mehr als zwei pNICs muss der vSphere-Cluster bereits ESXi-Hosts mit mehr als zwei pNICs enthalten.

Prozedur

Rufen Sie die ID für den ESXi-Host ab, den Sie einem 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 des Hosts, den Sie zum vSphere-Cluster hinzufügen möchten, und kopieren Sie die ID.

Erstellen Sie in einem Texteditor eine JSON-Spezifikation für die clusterUpdateSpec. Beispiel:

Hinweis: Wenn Sie VCF+ verwenden, sind keine Lizenzschlüssel erforderlich.

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

Rufen Sie die ID für den vSphere-Cluster ab, dem Sie den ESXi-Host 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 Clustern und klicken Sie auf GET /v1/Cluster.
3. Suchen Sie in der Antwort nach der ID für den vSphere-Zielcluster und kopieren Sie die ID.
Überprüfen Sie die clusterUpdateSpec.
1. Erweitern Sie den Abschnitt APIs für die Verwaltung von Clustern und klicken Sie auf POST /v1/clusters/{id}/validations.
2. Fügen Sie die Cluster-ID aus Schritt 3 und die clusterUpdateSpec aus Schritt 2 ein und klicken Sie auf Ausführen.
  Fahren Sie bei erfolgreicher Validierung mit dem nächsten Schritt fort. Wenn die Validierung fehlschlägt, überprüfen Sie die Fehler in der Antwort, aktualisieren Sie die clusterUpdateSpec und führen Sie eine erneute Validierung durch.
Fügen Sie den ESXi-Host zum vSphere-Cluster hinzu.
1. Erweitern Sie den Abschnitt APIs für die Verwaltung von Clustern und klicken Sie auf PATCH /v1/clusters/{id}.
2. Fügen Sie die Cluster-ID aus Schritt 3 und die validierte clusterUpdateSpec ein und klicken Sie auf Ausführen.
  
  Verwenden Sie den Bereich Aufgaben auf der SDDC Manager-Benutzeroberfläche, um das Hinzufügen des ESXi-Hosts zum vSphere-Cluster zu überwachen.