VMware Cloud Foundation API を使用した vSphere クラスタへのホストの追加

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

この手順では clusterUpdateSpec を使用し、VMware Cloud Foundation API を介して 3 つ以上の物理 NIC を持つ ESXi ホストを追加するか、または 2 つ以上の vSphere Distributed Switch (vDS) を持つ vSphere クラスタにホストを追加します。

次の手順の例は、既存の vSphere クラスタと ESXi ホストが次の構成を持つシナリオに基づいています。

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

環境に基づいて例を変更します。オプションのパラメータを含む clusterUpdateSpec の詳細については、『 VMware Cloud Foundation API リファレンスガイド』のクラスタの拡張を参照してください。

注： ESXi ホストを vSphere クラスタに追加するときは、Distributed Switch からトラフィックタイプへのマッピングを指定しないでください。新しい ESXi ホストの場合、トラフィックは、vSphere クラスタ内の他の ESXi ホストと同じように分散されます。

複数の異なる vSphere クラスタに対してホストを並行して追加または削除できます。たとえば、クラスタ A に 3 台のホストを追加し、そのタスクの実行中に別のタスクを開始して、クラスタ B に 4 台のホストを追加（または削除）することができます。並行して実行できる追加/削除タスクの最大数については、VMware 構成の上限を参照してください。

前提条件

SDDC Manager インベントリ内でホストが利用可能であることを確認します。ホストのコミッショニングの詳細については、ホストのコミッショニングを参照してください。
追加するホストがアクティブになっていることを確認します。ホストインベントリの表示を参照してください。
適切なソケットを備えた有効な vSphere ライセンスが SDDC Manager インベントリにあることを確認します。ライセンスキーの追加を参照してください。
注： VCF+ を使用している場合、ライセンスキーは必要ありません。
追加するホストが vSphere クラスタ内にすでに存在するホストの構成と一致していることを確認します。これにより、vSphere クラスタ構成の均衡を保つことができます。追加するホストが vSphere クラスタ内の既存のホストと一致しない場合、クラスタは不均衡となり、警告が表示されます。この警告は拡張を妨げるものではないため、無視してもかまいません。
追加するホストに、vSphere クラスタ内の既存のホストと同じタイプのプリンシパルストレージがあることを確認します。管理ドメインの場合、ホストはプリンシパルストレージに vSAN を使用する必要があります。VI ワークロードドメインの場合、ホストはプリンシパルストレージに vSAN、NFS、VMFS on FC、または vVol を使用できます。プリンシパルストレージに NFS を使用しているホストの場合、vSphere クラスタ内の他のホストと同じ NFS 構成が自動的に使用されます。VMFS on FC を使用しているホストの場合、ホストを vSphere クラスタに追加する前に、ゾーニングを構成し、関連付けられたボリュームをマウントして、データストアをホストに作成する必要があります。プリンシパルストレージに vVol を使用するホストの場合、vSphere クラスタ内の他のホストと同じ vVol 構成が自動的に使用されます。
vSphere クラスタが NSX Edge クラスタをホストしている場合、既存のホストと同じ管理、アップリンク、NSX ホストオーバーレイ、および NSX Edge オーバーレイネットワーク（L2 同型）がある新しいホストのみを追加できます。
ホストを追加する vSphere クラスタが NSX ホストオーバーレイネットワーク TEP に静的 IP アドレスプールを使用する場合、そのプールには、追加するホストのための十分な IP アドレスが含まれている必要があります。
3 つ以上の物理 NIC を持つ ESXi ホストを追加するには、vSphere クラスタに 3 つ以上の物理 NIC を持つ ESXi ホストがすでに含まれている必要があります。

手順

vSphere クラスタに追加する ESXi ホストの ID を取得します。
1. SDDC Manager ユーザーインターフェイスで、[デベロッパーセンター] > [API Explorer] の順にクリックします。
2. [ホスト管理用の API] セクションを展開し、[GET/v1/hosts] を展開します。
3. ステータステキストボックスに UNASSIGNED_USEABLE と入力し、[実行] をクリックします。
4. 応答で、vSphere クラスタに追加するホストの ID を見つけてコピーします。

テキストエディタで、[clusterUpdateSpec] の JSON 仕様を作成します。例：

注： VCF+ を使用している場合、ライセンスキーは必要ありません。

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

ESXi ホストを追加する vSphere クラスタの ID を取得します。
1. SDDC Manager ユーザーインターフェイスで、[デベロッパーセンター] > [API Explorer] の順にクリックします。
2. [クラスタ管理用の API] セクションを展開し、[GET/v1/clusters] を展開します。
3. 応答で、ターゲット vSphere クラスタの ID を見つけてコピーします。
[clusterUpdateSpec] を検証します。
1. [クラスタ管理用の API] セクションを展開し、[POST /v1/clusters/{id}/validations] を展開します。
2. 手順 3 のクラスタ ID を貼り付け、手順 2 の clusterUpdateSpec を貼り付けてから [実行] をクリックします。
  検証が成功した場合は、次の手順に進みます。検証に失敗した場合は、応答内のエラーを確認し、clusterUpdateSpec を更新して、再度検証します。
ESXi ホストを vSphere クラスタに追加します。
1. [クラスタ管理用の API] セクションを展開し、[PATCH /v1/clusters/{id}] を展開します。
2. 手順 3 のクラスタ ID を貼り付け、検証された clusterUpdateSpec を貼り付け、[実行] をクリックします。
  
  SDDC Manager ユーザーインターフェイスの [タスク] パネルを使用して、vSphere クラスタへの ESXi ホストの追加を監視します。