2 つ以上の vSphere Distributed Switch (vDS) を持つ vSphere クラスタを追加する場合、または 3 つ以上の物理 NIC を持つ ESXi ホストを使用する場合は、VMware Cloud Foundation API を使用する必要があります。

管理ドメインの場合、すべての vSphere クラスタは、プリンシパル ストレージに vSAN を使用する必要があります。VI ワークロード ドメインの場合、vSphere クラスタは、プリンシパル ストレージに vSAN、NFS、VMFS on FC、または vVol を使用できます。VI ワークロード ドメインに複数のクラスタがある場合、vSphere クラスタ内のすべてのホストが同じタイプを使用していれば、各クラスタは異なるタイプのプリンシパル ストレージを使用できます。

複数のクラスタ追加タスクを同時に実行できます。

この手順では、clusterCreationSpec を使用して、VMware Cloud Foundation API を介して vSphere クラスタをワークロード ドメインに追加します。2 つ以上の Distributed Switch を持つ vSphere クラスタを追加したり、3 つ以上の物理 NIC を持つ ESXi ホストを使用したりするための、clusterCreationSpechostSpecsnetworkSpec の 2 つのセクションに焦点を当てます。

これらのセクションを変更し、環境に必要な clusterCreationSpec の他のセクションを完了する必要があります。 のすべてのセクションの詳細については、『VMware Cloud Foundation API リファレンス ガイドclusterCreationSpec』を参照してください。この手順の最後の完全な clusterCreationSpec の例を参照してください。

手順の例は、次のシナリオに基づいています。
2 台の vSphere Distributed Switch
  • sfo-w01-cl02-vds01
  • sfo-w01-cl02-vds02
4 つの物理 NIC
  • vmnic0
  • vmnic1
  • vmnic2
  • vmnic3
物理 NIC から Distributed Switch へのマッピング
  • vmnic0 および vmnic1 から sfo-w01-cl02-vds01
  • vmnic2 および vmnic3 から sfo-w01-cl02-vds02
Distributed Switch からトラフィック タイプへのマッピング
  • sfo-w01-cl02-vds01:管理および vMotion
  • sfo-w01-cl02-vds02:vSAN、ホスト オーバーレイ、Edge アップリンク
VMware Cloud Foundation 環境に基づいて例を変更します。

前提条件

  • SDDC Manager インベントリで、少なくとも 3 台のホストが使用可能であることを確認します。ホストのコミッショニングの詳細については、ホストのコミッショニングを参照してください。
    注: vSphere クラスタが NFS、VMFS on FC、または vVol をプリンシパル ストレージとして使用しており、VI ワークロード ドメインが更新方法として vSphere Lifecycle Manager イメージを使用している場合は、2 台のホストのみが必要です。 Workload Management には、少なくとも 3 台の ESXi ホストを持つ vSphere クラスタが必要です。
  • vSphere クラスタに追加するホストがアクティブ状態になっていることを確認します。
  • SDDC Manager ユーザー インターフェイス の [ライセンス] タブで、追加するホストで使用できる適切なソケットを備えた有効な vSphere および vSAN(vSAN ストレージを使用している場合)ライセンスが指定されている必要があります。詳細については、ライセンス キーの追加 を参照してください。
    注: VCF+ を使用している場合、ライセンス キーは必要ありません。
  • NSX ホスト オーバーレイ ネットワークに DHCP を使用している場合は、管理ドメインの NSX ホスト オーバーレイ VLAN に DHCP サーバを構成する必要があります。NSX が VI ワークロード ドメインの TEP を作成すると、DHCP サーバから IP アドレスが割り当てられます。

手順

  1. vSphere クラスタに追加する ESXi ホストの ID を取得します。
    1. SDDC Manager ユーザー インターフェイス で、[デベロッパー センター] > [API Explorer] の順にクリックします。
    2. [ホスト管理用の API] セクションを展開し、[GET/v1/hosts] を展開します。
    3. ステータス テキスト ボックスに UNASSIGNED_USEABLE と入力し、[実行] をクリックします。
    4. 応答で、VI ワークロード ドメインに追加する各ホストの ID を見つけてコピーします。
  2. テキスト エディタで、[hostSpecs] の JSON 仕様を作成します。例:
    "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"
              } ]
            }
          },
    ESXi ホストごとに、以下を含むセクションを追加します。
    • id
    • licenseKey
      注: VCF+ を使用している場合、ライセンス キーは必要ありません。
    • userName
    • hostNetworkSpec
    手順 1 の ESXi ホスト ID を使用します。
  3. vSphere クラスタを追加するワークロード ドメインの ID を取得します。
    1. SDDC Manager ユーザー インターフェイス で、[デベロッパー センター] > [API Explorer] の順にクリックします。
    2. [ドメイン管理用の API] セクションを展開し、[GET/v1/domains] をクリックします。
    3. [実行] をクリックします。
    4. 応答で、vSphere クラスタを追加するワークロード ドメインの ID を見つけてコピーします。
  4. テキスト エディタで、[networkSpec] の JSON 仕様を作成します。例:
     "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
                           }
                        }
              }
    注: Distributed Switch がホスト オーバーレイ トラフィックに使用する "isUsedByNsxt": true を指定します。vSphere Distributed Switch が複数ある場合は、そのうちの 1 つのみが "isUsedByNsxt": true を指定できます。
  5. SDDC Manager ユーザー インターフェイス で、[デベロッパー センター] > [API Explorer] の順にクリックします。
  6. [クラスタ管理用の API] セクションを展開し、[POST/v1/clusters/validations] をクリックします。
  7. [説明/データ型] 列で、[ClusterCreationSpec] をクリックします。
    API Explorer の clusterCreationSpec
  8. [hostSpecs] セクションを hostSpecs JSON ファイルの情報に置き換えます。
  9. [networkSpec] セクションを networkSpec JSON ファイルの情報に置き換えます。
  10. domainId を手順 3 のワークロード ドメインの ID に置き換えます。
  11. 追加する vSphere クラスタに基づいて、必要に応じて [clusterCreationSpec] の他のセクションを更新または削除します。
    この手順の最後の完全な clusterCreationSpec の例を参照してください。
  12. [実行] をクリックして、[clusterCreationSpec] を検証します。
    検証が成功した場合は、clusterCreationSpec コンテンツをコピーして、次の手順に進みます。検証に失敗した場合は、応答内のエラーを確認し、clusterCreationSpec を更新して、再度検証します。
  13. [クラスタ管理用の API] セクションを展開し、[POST /v1/clusters] を展開します。
  14. 検証済みの clusterCreationSpec コンテンツを貼り付け、[実行] をクリックします。
    skipFailedHosts プロパティを使用すると、クラスタについて選択した 1 台以上の ESXi ホストが健全でない場合の動作を決定できます。 "skipFailedHosts":false を指定した場合に、健全でないホストが新しいクラスタに含まれていると、クラスタの作成は失敗します。 "skipFailedHosts":true を指定した場合に、健全でないホストが新しいクラスタに含まれていても、新しいクラスタの最小要件を満たすのに十分な台数の健全なホストが選択されていれば、クラスタの作成は成功します。十分な台数の健全なホストがない場合、クラスタの作成は失敗します。 skipFailedHosts に値を指定しない場合、デフォルトで "skipFailedHosts":true になります。
    SDDC Manager ユーザー インターフェイス[タスク] パネルを使用して、vSphere クラスタのワークロード ドメインへの追加を監視します。

完全な 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
    }
  }
}