スパイン/リーフ型ネットワークの設定

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. undercloud.conf ファイルがまだない場合には、サンプルのテンプレートファイルをコピーします。

   [stack@director ~]$ cp /usr/share/python-tripleoclient/undercloud.conf.sample ~/undercloud.conf

3. undercloud.conf ファイルを編集します。

4. [DEFAULT] セクションに以下の値を設定します。

   1. local_ip を leaf0 上のアンダークラウド IP に設定します。

      local_ip = 192.168.10.1/24

   2. undercloud_public_host をアンダークラウドの外部向け IP アドレスに設定します。

      undercloud_public_host = 10.1.1.1

   3. undercloud_admin_host をアンダークラウドの管理用 IP アドレスに設定します。この IP アドレスは、通常 leaf0 上にあります。

      undercloud_admin_host = 192.168.10.2

   4. local_interface を、ローカルネットワーク用にブリッジを設定するインターフェイスに設定します。

      local_interface = eth1

   5. enable_routed_networks を true に設定します。

      enable_routed_networks = true

   6. subnets パラメーターを使用してサブネットのリストを定義します。ルーティング対応のスパイン/リーフ内の各 L2 セグメントにサブネットを 1 つ定義します。

      subnets = leaf0,leaf1,leaf2

   7. local_subnet パラメーターを使用して、アンダークラウドにローカルな物理 L2 セグメントに関連付けられるサブネットを指定します。

      local_subnet = leaf0

   8. undercloud_nameservers の値を設定します。

      undercloud_nameservers = 10.11.5.19,10.11.5.20

      ヒント

      アンダークラウドのネームサーバーに使用する DNS サーバーの現在の IP アドレスは、/etc/resolv.conf を参照して確認することができます。

5. subnets パラメーターで定義するサブネットごとに、新規セクションを作成します。

   [leaf0]
   cidr = 192.168.10.0/24
   dhcp_start = 192.168.10.10
   dhcp_end = 192.168.10.90
   inspection_iprange = 192.168.10.100,192.168.10.190
   gateway = 192.168.10.1
   masquerade = False
   
   [leaf1]
   cidr = 192.168.11.0/24
   dhcp_start = 192.168.11.10
   dhcp_end = 192.168.11.90
   inspection_iprange = 192.168.11.100,192.168.11.190
   gateway = 192.168.11.1
   masquerade = False
   
   [leaf2]
   cidr = 192.168.12.0/24
   dhcp_start = 192.168.12.10
   dhcp_end = 192.168.12.90
   inspection_iprange = 192.168.12.100,192.168.12.190
   gateway = 192.168.12.1
   masquerade = False

6. undercloud.conf ファイルを保存します。

7. アンダークラウドをインストールするコマンドを実行します。

   [stack@director ~]$ openstack undercloud install

手順

1. stackrc ファイルを取得します。

   [stack@director ~]$ source ~/stackrc

2. ノードリストを取得して UUID を把握します。

   (undercloud)$ openstack baremetal node list

3. リーフネットワークとロールを識別するカスタムリソースクラスを使用して、ロールに指定する各ベアメタルノードを割り当てます。

   openstack baremetal node set \
    --resource-class baremetal.<ROLE> <node>

   • <ROLE> をロールを識別する名前に置き換えます。

   • <node> をベアメタルノードの ID に置き換えます。

     たとえば、以下のコマンドを実行して、UUID 58c3d07e-24f2-48a7-bbb6-6843f0e8ee13 のノードを Leaf2 上の Compute ロールにタグ付けします。

     (undercloud)$ openstack baremetal node set \
      --resource-class baremetal.COMPUTE-LEAF2 58c3d07e-24f2-48a7-bbb6-6843f0e8ee13

4. 各ロールがまだ定義されていない場合は、overcloud-baremetal-deploy.yaml に追加します。

5. ロールのノードに割り当てるリソースクラスを定義します。

   - name: <role>
     count: 1
     defaults:
       resource_class: baremetal.<ROLE>

   • <role> をロールの名前に置き換えます。
   • <ROLE> をロールを識別する名前に置き換えます。

6. Baremetal-deploy.yaml ファイルで、ロールのノードに割り当てるリソースクラスを定義します。展開するロール、プロファイル、数量、および関連付けられているネットワークを指定します。

   - name: <role>
     count: 1
     hostname_format: <role>-%index%
     ansible_playbooks:
       - playbook: bm-deploy-playbook.yaml
     defaults:
       resource_class: baremetal.<ROLE>
       profile: control
       networks:
         - network: external
           subnet: external_subnet
         - network: internal_api
           subnet: internal_api_subnet01
         - network: storage
           subnet: storage_subnet01
         - network: storage_mgmt
           subnet: storage_mgmt_subnet01
         - network: tenant
           subnet: tenant_subnet01
       network_config:
         template: templates/multiple_nics/multiple_nics_dvr.j2
         default_route_network:
           - external

   • <role> をロールの名前に置き換えます。

   • <ROLE> をロールを識別する名前に置き換えます。

     注記

     /home/stack/<stack> に、デプロイするすべてのスタックに対して、baremetal-deploy.yaml 環境ファイルを作成する必要があります。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. ベアメタルノードをチェックします。

   $ openstack baremetal node list

3. ベアメタルノードは enroll または manageable の状態であることを確認してください。ベアメタルノードがこれらのいずれかの状態にない場合、ベアメタルポートで physical_network プロパティーを設定するコマンドは失敗します。全ノードを manageable の状態に設定するには、以下のコマンドを実行します。

   $ for node in $(openstack baremetal node list -f value -c Name); do openstack baremetal node manage $node --wait; done

4. ベアメタルポートとベアメタルノードの関連付けを確認します。

   $ openstack baremetal port list --node <node-uuid>

5. ポートの physical-network パラメーターを設定します。以下の例では、leaf0、leaf1、および leaf2 の 3 つのサブネットが設定で定義されています。local_subnet は leaf0 です。local_subnet の物理ネットワークは常に ctlplane であるため、leaf0 に接続されたベアメタルポートは必ず ctlplane を使用します。残りのポートは他のリーフ名を使用します。

   $ openstack baremetal port set --physical-network ctlplane <port-uuid>
   $ openstack baremetal port set --physical-network leaf1 <port-uuid>
   $ openstack baremetal port set --physical-network leaf2 <port-uuid>

6. オーバークラウドをデプロイする前に、ノードをイントロスペクションします。--all-manageable オプションと -provide オプションを付けて、デプロイ可能なノードとして設定します。

   $ openstack overcloud node introspect --all-manageable --provide

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. /home/stack/undercloud.conf ファイルで、以下の手順を実施します。

   1. subnets パラメーターを特定し、追加するリーフ用の新規サブネットを追加します。

      サブネットは、ルーティング対応のスパイン/リーフ内の L2 セグメントを表します。

      例

      以下の例では、新しいリーフ (leaf3) に新規サブネット (leaf3) が追加されます。

      subnets = leaf0,leaf1,leaf2,leaf3

   2. 追加したサブネットのセクションを作成します。

      例

      以下の例では、新しいサブネット (leaf3 に [leaf3] セクションが追加されます。

      [leaf0]
      cidr = 192.168.10.0/24
      dhcp_start = 192.168.10.10
      dhcp_end = 192.168.10.90
      inspection_iprange = 192.168.10.100,192.168.10.190
      gateway = 192.168.10.1
      masquerade = False
      
      [leaf1]
      cidr = 192.168.11.0/24
      dhcp_start = 192.168.11.10
      dhcp_end = 192.168.11.90
      inspection_iprange = 192.168.11.100,192.168.11.190
      gateway = 192.168.11.1
      masquerade = False
      
      [leaf2]
      cidr = 192.168.12.0/24
      dhcp_start = 192.168.12.10
      dhcp_end = 192.168.12.90
      inspection_iprange = 192.168.12.100,192.168.12.190
      gateway = 192.168.12.1
      masquerade = False
      
      [leaf3]
      cidr = 192.168.13.0/24
      dhcp_start = 192.168.13.10
      dhcp_end = 192.168.13.90
      inspection_iprange = 192.168.13.100,192.168.13.190
      gateway = 192.168.13.1
      masquerade = False

4. undercloud.conf ファイルを保存します。

5. アンダークラウドを再インストールします。

   $ openstack undercloud install

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. /home/stack の下に templates ディレクトリーを作成します。

   $ mkdir /home/stack/templates

4. デフォルトのネットワーク定義テンプレート、routed-networks.yaml をカスタムの templates ディレクトリーにコピーします。

   例

   $ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/\
   routed-networks.yaml \
   /home/stack/templates/spine-leaf-networks-data.yaml

5. ネットワーク定義テンプレートのコピーを編集して、各ベースネットワークおよび関連する各リーフサブネットを設定可能なネットワークアイテムとして定義します。

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの ネットワーク定義ファイル設定のオプション を参照してください。

   例

   以下の例は、内部 API ネットワークおよびそのリーフネットワークを定義する方法を示しています。

   - name: InternalApi
     name_lower: internal_api
     vip: true
     mtu: 1500
     subnets:
       internal_api_subnet:
         ip_subnet: 172.16.32.0/24
         gateway_ip: 172.16.32.1
         allocation_pools:
           - start: 172.16.32.4
             end: 172.16.32.250
         vlan: 20
       internal_api_leaf1_subnet:
         ip_subnet: 172.16.33.0/24
         gateway_ip: 172.16.33.1
         allocation_pools:
           - start: 172.16.33.4
             end: 172.16.33.250
         vlan: 30
       internal_api_leaf2_subnet:
         ip_subnet: 172.16.34.0/24
         gateway_ip: 172.16.34.1
         allocation_pools:
           - start: 172.16.34.4
             end: 172.16.34.250
         vlan: 40

次のステップ

1. 作成したカスタムネットワーク定義ファイルのパスとファイル名をメモします。この情報は、後で RHOSP オーバークラウド用にネットワークをプロビジョニングする際に必要になります。
2. 次のステップ リーフロールの定義とネットワークの接続 に進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. RHOSP に同梱されている Controller、Compute、Ceph Storage ロールのデフォルトロールを stack ユーザーのホームディレクトリーにコピーします。ファイルがリーフ 0 であることを示すようにファイルの名前を変更します。

   $ cp /usr/share/openstack-tripleo-heat-templates/roles/Controller.yaml \
   ~/roles/Controller0.yaml
   $ cp /usr/share/openstack-tripleo-heat-templates/roles/Compute.yaml \
   ~/roles/Compute0.yaml
   $ cp /usr/share/openstack-tripleo-heat-templates/roles/CephStorage.yaml \
   ~/roles/CephStorage0.yaml

4. リーフ 0 ファイルをコピーして、リーフ 1 およびリーフ 2 ファイルを作成します。

   $ cp ~/roles/Compute0.yaml ~/roles/Compute1.yaml
   $ cp ~/roles/Compute0.yaml ~/roles/Compute2.yaml
   $ cp ~/roles/CephStorage0.yaml ~/roles/CephStorage1.yaml
   $ cp ~/roles/CephStorage0.yaml ~/roles/CephStorage2.yaml

5. 各ファイルのパラメーターを編集して、それぞれのリーフパラメーターに合わせます。

   ヒント

   ロールデータテンプレートのさまざまなパラメーターの詳細は、Red Hat OpenStack Platform デプロイメントのカスタマイズ ガイドの ロールパラメーターの検査 を参照してください。

   例 - ComputeLeaf0

   - name: ComputeLeaf0
     HostnameFormatDefault: '%stackname%-compute-leaf0-%index%'

   例 - CephStorageLeaf0

   - name: CephStorageLeaf0
     HostnameFormatDefault: '%stackname%-cephstorage-leaf0-%index%'

6. それぞれのリーフネットワークのパラメーターと整合するように、リーフ 1 および リーフ 2 ファイルの network パラメーターを編集します。

   例 - ComputeLeaf1

   - name: ComputeLeaf1
     networks:
       InternalApi:
         subnet: internal_api_leaf1
       Tenant:
         subnet: tenant_leaf1
       Storage:
         subnet: storage_leaf1

   例 - CephStorageLeaf1

   - name: CephStorageLeaf1
     networks:
       Storage:
         subnet: storage_leaf1
       StorageMgmt:
         subnet: storage_mgmt_leaf1

   注記

   この設定を行うのは、リーフ 1 および リーフ 2 だけです。リーフ 0 の network パラメーターは、ベースサブネットの値のままにします (各サブネットの小文字を使用した名前に接尾辞 _subnet を追加したもの)。たとえば、リーフ 0 の内部 API は internal_api_subnet です。

7. コントローラー、コンピュート、および Networker (存在する場合) の各ロールファイルで、ServicesDefault パラメーターの下にあるサービスのリストに OVN BGP エージェントを追加します。

   例

   - name: ControllerRack1
     ...
     ServicesDefault:
       ...
       - OS::TripleO::Services::Frr
       - OS::TripleO::Services::OVNBgpAgent
       ...

8. ロールの設定が完了したら、overcloud roles generate コマンドを実行して完全なロールデータファイルを生成します。

   例

   $ openstack overcloud roles generate --roles-path ~/roles \
   -o spine-leaf-roles-data.yaml Controller Compute Compute1 Compute2 \
   CephStorage CephStorage1 CephStorage2

   これにより、それぞれのリーフネットワークのすべてのカスタムロールを含む 1 つのカスタムロールデータファイルが作成されます。

次のステップ

1. overcloudrolesgenerate コマンドによって作成されたカスタムロールデータファイルのパスとファイル名をメモします。このパスは、後でオーバークラウドをデプロイするときに使用します。
2. 次のステップ リーフロール用のカスタム NIC 設定の作成 に進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. デフォルトの NIC テンプレートの 1 つからコンテンツをコピーして、NIC 設定のカスタムテンプレートを作成します。

   例

   この例では、NIC テンプレート single-nic-vlans をコピーし、NIC 設定のカスタムテンプレートとして使用します。

   $ cp -r /usr/share/ansible/roles/tripleo_network_config/\
   templates/single-nic-vlans/* /home/stack/templates/spine-leaf-nics/.

4. 前の手順で作成した各 NIC テンプレートで、スパイン/リーフトポロジーの詳細に一致するように NIC 設定を変更します。

   例

   {% set mtu_list = [ctlplane_mtu] %}
   {% for network in role_networks %}
   {{ mtu_list.append(lookup('vars', networks_lower[network] ~ '_mtu')) }}
   {%- endfor %}
   {% set min_viable_mtu = mtu_list | max %}
   network_config:
   - type: ovs_bridge
     name: {{ neutron_physical_bridge_name }}
     mtu: {{ min_viable_mtu }}
     use_dhcp: false
     dns_servers: {{ ctlplane_dns_nameservers }}
     domain: {{ dns_search_domains }}
     addresses:
     - ip_netmask: {{ ctlplane_ip }}/{{ ctlplane_subnet_cidr }}
     routes: {{ ctlplane_host_routes }}
     members:
     - type: interface
       name: nic1
       mtu: {{ min_viable_mtu }}
       # force the MAC address of the bridge to this interface
       primary: true
   {% for network in role_networks %}
     - type: vlan
       mtu: {{ lookup('vars', networks_lower[network] ~ '_mtu') }}
       vlan_id: {{ lookup('vars', networks_lower[network] ~ '_vlan_id') }}
       addresses:
       - ip_netmask:
           {{ lookup('vars', networks_lower[network] ~ '_ip') }}/{{ lookup('vars', networks_lower[network] ~ '_cidr') }}
       routes: {{ lookup('vars', networks_lower[network] ~ '_host_routes') }}
   {% endfor %}

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの カスタムネットワークインターフェイステンプレートの定義 を参照してください。

5. カスタム NIC テンプレートを各カスタムロールにマッピングする parameter_defaults セクションを含む、spine-leaf-nic-roles-map.yaml などのカスタム環境ファイルを作成します。

   parameter_defaults:
     %%ROLE%%NetworkConfigTemplate: <path_to_ansible_jinja2_nic_config_file>

   例

   parameter_defaults:
     Controller0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     Controller1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     Controller2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'

次のステップ

1. カスタム NIC テンプレートのパスとファイル名、およびカスタム NIC テンプレートを各カスタムロールにマッピングするカスタム環境ファイルをメモします。このパスは、後でオーバークラウドをデプロイするときに使用します。
2. 次の リーフネットワークの設定 ステップに進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. spin-leaf-ctlplane.yaml などの新しいカスタム環境ファイルで、parameter_defaults セクションを作成し、デフォルトの br-ex ブリッジを使用するリーフごとに NeutronBridgeMappings パラメーターを設定します。

   重要

   ネットワーク定義を含めるために作成するカスタム環境ファイルの名前は、.yaml または .template で終わる必要があります。

   • フラットネットワークのマッピングの場合には、NeutronFlatNetworks パラメーターに各リーフの一覧を定義し、各リーフの NeutronBridgeMappings パラメーターを設定します。

     例

     parameter_defaults:
       NeutronFlatNetworks: leaf0,leaf1,leaf2
       Controller0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Controller1Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Controller2Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Compute0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Compute1Parameters:
         NeutronBridgeMappings: "leaf1:br-ex"
     
       Compute2Parameters:
         NeutronBridgeMappings: "leaf2:br-ex"

     ヒント

     詳細は、第 17 章ネットワーク (neutron) パラメーター (オーバークラウドのパラメーター ガイド) を参照してください。

   • VLAN ネットワークマッピングの場合、vlan を NeutronNetworkType に追加し、NeutronNetworkVLANRanges を使用してリーフネットワークの VLAN をマッピングします。

     例

     parameter_defaults:
       NeutronNetworkType: 'geneve,vlan'
       NeutronNetworkVLANRanges: 'leaf0:1:1000,leaf1:1:1000,leaf2:1:1000'
     
       Controller0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Controller1Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Controller2Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Compute0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
     
       Compute1Parameters:
         NeutronBridgeMappings: "leaf1:br-ex"
     
       Compute2Parameters:
         NeutronBridgeMappings: "leaf2:br-ex"

     注記

     スパイン/リーフトポロジーでは、フラットネットワークと VLAN の両方を使用できます。

4. <role>ControlPlaneSubnet パラメーターを使用して、各スパイン/リーフネットワークのコントロールプレーンサブネットマッピングを追加します。

   例

   parameter_defaults:
     NeutronFlatNetworks: leaf0,leaf1,leaf2
     Controller0Parameters:
       NeutronBridgeMappings: "leaf0:br-ex"
       ControllerControlPlaneSubnet: leaf0
     Controller1Parameters:
       NeutronBridgeMappings: "leaf0:br-ex"
       Controller1ControlPlaneSubnet: leaf0
     Controller2Parameters:
       NeutronBridgeMappings: "leaf0:br-ex"
       Controller2ControlPlaneSubnet: leaf0
     Compute0Parameters:
       NeutronBridgeMappings: "leaf0:br-ex"
       Compute0ControlPlaneSubnet: leaf0
     CephStorage0Parameters:
       CephStorage0ControlPlaneSubnet: leaf0
     Compute1Parameters:
       NeutronBridgeMappings: "leaf1:br-ex"
       Compute1ControlPlaneSubnet: leaf1
     CephStorage1Parameters:
       CephStorage1ControlPlaneSubnet: leaf1
     Compute2Parameters:
       NeutronBridgeMappings: "leaf2:br-ex"
       Compute2ControlPlaneSubnet: leaf2
     CephStorage2Parameters:
       CephStorage2ControlPlaneSubnet: leaf2

次のステップ

1. 作成したカスタムネットワーク環境ファイルのパスとファイル名をメモします。この情報は、後でオーバークラウドをデプロイするときに必要になります。
2. 次のステップ 仮想 IP アドレス用サブネットの設定 に進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. spin-leaf-vip-data.yaml などの新しいカスタムネットワーク仮想 IP 定義テンプレートで、コントローラーノードが使用する特定のサブネット上に作成する必要のある仮想 IP アドレスを一覧表示します。

   例

   - network: storage_mgmt
     subnet: storage_mgmt_subnet_leaf1
   - network: internal_api
     subnet: internal_api_subnet_leaf1
   - network: storage
     subnet: storage_subnet_leaf1
   - network: external
     subnet: external_subnet_leaf1
     ip_address: 172.20.11.50
   - network: ctlplane
     subnet: leaf0
   - network: oc_provisioning
     subnet: oc_provisioning_subnet_leaf1
   - network: storage_nfs
     subnet: storage_nfs_subnet_leaf1

   spine-leaf-vip-data.yaml ファイルで、以下のパラメーターを使用できます。

   network

   neutron ネットワーク名を設定します。これは唯一の必須パラメーターです。

   ip_address

   VIP の IP アドレスを設定します。

   subnet

   neutron サブネット名を設定します。仮想 IP neutron ポートを作成するときにサブネットを指定するために使用します。このパラメーターは、展開でルーティングされたネットワークを使用する場合に必要です。

   dns_name

   FQDN (完全修飾ドメイン名) を設定します

   name

   仮想 IP 名を設定します。

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの コンポーザブルネットワークの追加 を参照してください。

次のステップ

1. 作成したカスタムネットワーク仮想 IP 定義テンプレートのパスとファイル名をメモします。このパスは、後で RHOSP オーバークラウド用にネットワーク仮想 IP をプロビジョニングするときに使用します。
2. 次のステップ オーバークラウド用のネットワークと仮想 IP のプロビジョニング に進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. オーバークラウドネットワークをプロビジョニングします。

   overcloud network professional コマンドを使用して、前に作成したネットワーク定義ファイルへのパスを指定します。

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの オーバークラウドのネットワーク定義の設定とプロビジョニング を参照してください。

   例

   この例では、パスは /home/stack/templates/spine-leaf-networks-data.yaml です。--output 引数を使用して、コマンドによって作成されたファイルに名前を付けます。

   $ openstack overcloud network provision \
     --output spine-leaf-networks-provisioned.yaml \
    /home/stack/templates/spine-leaf-networks-data.yaml

   重要

   指定する出力ファイルの名前は、.yaml または .template で終わる必要があります。

4. オーバークラウド仮想 IP をプロビジョニングします。

   overcloud network vip professional コマンドを --stack 引数とともに使用して、前に作成した仮想 IP 定義ファイルに名前を付けます。--output 引数を使用して、コマンドによって作成されたファイルに名前を付けます。

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの オーバークラウドのネットワーク仮想 IP の設定とプロビジョニング を参照してください。

   $ openstack overcloud network vip provision \
     --stack spine-leaf-overcloud \
    --output spine-leaf-vips-provisioned.yaml \
    /home/stack/templates/spine-leaf-vip-data.yaml

   重要

   指定する出力ファイルの名前は、.yaml または .template で終わる必要があります。

5. 生成された出力ファイルのパスとファイル名に注意してください。この情報は、後でオーバークラウドをデプロイするときに使用します。

次のステップ

1. 事前にプロビジョニングされたノードを使用している場合は、オーバークラウドデプロイメントコマンドの実行 に進んでください。
2. それ以外の場合は、次のステップ オーバークラウドへのベアメタルノードの登録 に進みます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 新しいノード定義テンプレート (barematal-nodes.yaml など) を作成します。ハードウェアと電源管理の詳細を含む物理マシンのリストを追加します。

   例

   nodes:
     - name: "node01"
       ports:
         - address: "aa:aa:aa:aa:aa:aa"
           physical_network: ctlplane
           local_link_connection:
             switch_id: 52:54:00:00:00:00
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.205"
     - name: "node02"
       ports:
         - address: "bb:bb:bb:bb:bb:bb"
           physical_network: ctlplane
           local_link_connection:
             switch_id: 52:54:00:00:00:00
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.206"

   ヒント

   テンプレートパラメーター値と JSON の例の詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの オーバークラウドのノードの登録 を参照してください。

4. テンプレートのフォーマットと構文を確認します。

   例

   $ openstack overcloud node import --validate-only ~/templates/\
   baremetal-nodes.yaml

5. エラーを修正し、ノード定義テンプレートを保存します。

6. ノード定義テンプレートを RHOSP director にインポートして、各ノードをテンプレートから director に登録します。

   例

   $ openstack overcloud node import ~/baremetal-nodes.yaml

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. pre-introspection 検証グループを実行して、プリイントロスペクションの要件を確認します。

   $ validation run --group pre-introspection

4. 検証レポートの結果を確認します。

5. オプション: 特定の検証からの詳細な出力を確認します。

   $ validation history get --full <UUID>

   <UUID> は、確認するレポートの特定の検証の UUID に置き換えます。

   重要

   検証結果が FAILED であっても、RHOSP のデプロイや実行が妨げられることはありません。ただし、FAILED の検証結果は、実稼働環境で問題が発生する可能性があることを意味します。

6. すべてのノードのハードウェア属性を検査します。

   $ openstack overcloud node introspect --all-manageable --provide

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理ガイド の director のイントロスペクションを使用したベアメタルノードのハードウェア情報の収集 を参照してください。

   別のターミナルウィンドウで、イントロスペクションの進捗ログを監視します。

   $ sudo tail -f /var/log/containers/ironic-inspector/ironic-inspector.log

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. spin-leaf-baremetal-nodes.yaml などのベアメタルノード定義ファイルを作成し、プロビジョニングするロールごとにノード数を定義します。

   例

   - name: Controller
     count: 3
     defaults:
       networks:
       - network: ctlplane
         vif: true
       - network: external
         subnet: external_subnet
       - network: internal_api
         subnet: internal_api_subnet01
       - network: storage
         subnet: storage_subnet01
       - network: storage_mgmt
         subnet: storage_mgmt_subnet01
       - network: tenant
         subnet: tenant_subnet01
       network_config:
         template: /home/stack/templates/spine-leaf-nics/single-nic-vlans.j2
         default_route_network:
         - external
   - name: Compute0
     count: 1
     defaults:
       networks:
       - network: ctlplane
         vif: true
       - network: internal_api
         subnet: internal_api_subnet02
       - network: tenant
         subnet: tenant_subnet02
       - network: storage
         subnet: storage_subnet02
       network_config:
         template: /home/stack/templates/spine-leaf-nics/single-nic-vlans.j2
   - name: Compute1
   ...

   ヒント

   ベアメタルノード定義ファイルを設定できるプロパティーの詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの オーバークラウドのベアメタルノードのプロビジョニング を参照してください。

4. overcloud node provision コマンドを使用して、オーバークラウドのベアメタルノードをプロビジョニングします。

   例

   $ openstack overcloud node provision \
    --stack spine_leaf_overcloud \
    --network-config \
    --output spine-leaf-baremetal-nodes-provisioned.yaml \
    /home/stack/templates/spine-leaf-baremetal-nodes.yaml

   重要

   指定する出力ファイルの名前は、.yaml または .template で終わる必要があります。

5. 別のターミナルでプロビジョニングの進捗をモニタリングします。プロビジョニングが成功すると、ノードの状態が available から active に変わります。

   $ watch openstack baremetal node list

6. metalsmith ツールを使用して、割り当てやポートなどを含むノードの統合ビューを取得します。

   $ metalsmith list

7. 生成された出力ファイルのパスとファイル名に注意してください。このパスは、後でオーバークラウドをデプロイするときに必要になります。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. オーバークラウド環境に必要なカスタム環境ファイルとカスタムテンプレートを照合します。このリストには、director インストールで提供される未編集の heat テンプレートファイルと、作成したカスタムファイルが含まれます。次のファイルへのパスがあることを確認します。

   • オーバークラウド上のスパイン/リーフネットワークの仕様を含むカスタムネットワーク定義ファイル (例: spin-leaf-networks-data.yaml)。

     詳細は、リーフネットワークの定義 を参照してください。

   • 各リーフのロールを定義するカスタムロールデータファイル。

     例: spine-leaf-roles.yaml

     詳細は、リーフのロールの定義とネットワークの接続 を参照してください。

   • ロールと各ロールのカスタム NIC テンプレートマッピングを含むカスタム環境ファイル。

     例: spine-leaf-nic-roles-map.yaml

     詳細は、リーフロール用のカスタム NIC 設定の作成 を参照してください。

   • 個別のネットワークマッピングを含み、オーバークラウドのコントロールプレーンネットワークへのアクセスを設定するカスタムネットワーク環境ファイル。

     例: spine-leaf-ctlplane.yaml

     詳細は、リーフネットワークの設定 を参照してください。

   • オーバークラウドネットワークのプロビジョニングからの出力ファイル。

     例: spine-leaf-networks-provisioned.yaml

     詳細は、オーバークラウドのネットワークと仮想 IP のプロビジョニング を参照してください。

   • オーバークラウド仮想 IP のプロビジョニングからの出力ファイル。

     例: spine-leaf-vips-provisioned.yaml

     詳細は、オーバークラウドのネットワークと仮想 IP のプロビジョニング を参照してください。

   • 事前にプロビジョニングされたノードを使用していない場合は、ベアメタルノードのプロビジョニングからの出力ファイル。

     例: spine-leaf-baremetal-nodes-provisioned.yaml

     詳細は、オーバークラウド用のベアメタルノードのプロビジョニング を参照してください。

   • その他のカスタム環境ファイル

4. コマンドへの入力であるカスタム環境ファイルとカスタムテンプレートを慎重に並べ替えて、overcloud deploy コマンドを入力します。

   一般的なルールは、未編集の heat テンプレートファイルを最初に指定し、次にカスタム環境ファイルと、デフォルトプロパティーのオーバーライドなどのカスタム設定を含むカスタムテンプレートを指定することです。

   overclouddeploy コマンドへの入力をリストする際には、次の順序に従います。

   1. 各ロールにマップされたカスタム NIC テンプレートを含むカスタム環境ファイルを含めます。

      例: network-environment.yaml の後に、spine-leaf-nic-roles-map.yaml を追加します。

      network-environment.yaml ファイルは、設定可能なネットワークパラメーターのデフォルトのネットワーク設定を提供します。これは、マッピングファイルによってオーバーライドされます。director はこのファイルを network-environment.j2.yaml Jinja2 テンプレートからレンダリングする点に注意してください。

   2. 他のスパイン/リーフネットワーク環境ファイルを作成した場合は、これらの環境ファイルをロールと NIC テンプレートのマッピングファイルの後に含めます。

   3. 環境ファイルを更に追加します。(例: コンテナーイメージの場所や Ceph クラスターの設定を定義した環境ファイルなど)。

      例

      overcloud deploy コマンド例からの以下の抜粋は、コマンドの入力の適切な順序を示しています。

      $ openstack overcloud deploy --templates \
        -n /home/stack/templates/spine-leaf-networks-data.yaml \
        -e /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml \
        -e /usr/share/openstack-tripleo-heat-templates/environments/services/frr.yaml \
        -e /usr/share/openstack-tripleo-heat-templates/environments/services/ovn-bgp-agent.yaml \
        -e /home/stack/templates/spine-leaf-nic-roles-map.yaml \
        -e /home/stack/templates/spine-leaf-ctlplane.yaml \
        -e /home/stack/templates/spine-leaf-baremetal-provisioned.yaml \
        -e /home/stack/templates/spine-leaf-networks-provisioned.yaml \
        -e /home/stack/templates/spine-leaf-vips-provisioned.yaml \
        -e /home/stack/containers-prepare-parameter.yaml \
        -e /home/stack/inject-trust-anchor-hiera.yaml \
        -r /home/stack/templates/spine-leaf-roles-data.yaml
        ...

   ヒント

   詳細は、director を使用した Red Hat OpenStack Platform のインストールと管理 ガイドの オーバークラウドの作成 を参照してください。

5. overcloud deploy コマンドを実行します。

   オーバークラウドの作成が完了すると、RHOSP director は、オーバークラウドへのアクセスに役立つ詳細を提供します。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. /home/stack/templates/spine-leaf-networks-data.yaml などのネットワーク定義テンプレートを開きます。適切なベースネットワークの下に、追加する新しいリーフの設定可能なネットワークアイテムとしてリーフサブネットを追加します。

   例

   以下の例では、新しいリーフ (leaf3) のサブネットエントリーが追加されました。

   - name: InternalApi
     name_lower: internal_api
     vip: true
     vlan: 10
     ip_subnet: '172.18.0.0/24'
     allocation_pools: [{'start': '172.18.0.4', 'end': '172.18.0.250'}]
     gateway_ip: '172.18.0.1'
     subnets:
       internal_api_leaf1:
         vlan: 11
         ip_subnet: '172.18.1.0/24'
         allocation_pools: [{'start': '172.18.1.4', 'end': '172.18.1.250'}]
         gateway_ip: '172.18.1.1'
       internal_api_leaf2:
         vlan: 12
         ip_subnet: '172.18.2.0/24'
         allocation_pools: [{'start': '172.18.2.4', 'end': '172.18.2.250'}]
         gateway_ip: '172.18.2.1'
       internal_api_leaf3:
         vlan: 13
         ip_subnet: '172.18.3.0/24'
         allocation_pools: [{'start': '172.18.3.4', 'end': '172.18.3.250'}]
         gateway_ip: '172.18.3.1'

4. 追加する新しいリーフ用のロールデータファイルを作成します。

   1. 追加する新しいリーフ用にリーフ Compute およびリーフ Ceph Storage ファイルをコピーします。

      例

      この例では、Compute1.yaml および CephStorage1.yaml が新しいリーフ (Compute3.yaml および CephStorage3.yaml) にコピーされ、再度実行されます。

      $ cp ~/roles/Compute1.yaml ~/roles/Compute3.yaml
      $ cp ~/roles/CephStorage1.yaml ~/roles/CephStorage3.yaml

   2. 新しいリーフファイルのパラメーター name と HostnameFormatDefault を編集して、それぞれのリーフパラメーターと一致するようにします。

      例

      たとえば、Leaf 1 Compute ファイルのパラメーター値は、以下のように設定します。

      - name: ComputeLeaf1
        HostnameFormatDefault: '%stackname%-compute-leaf1-%index%'

      例

      Leaf 1 Ceph Storage ファイルのパラメーター値は、以下のように設定します。

      - name: CephStorageLeaf1
        HostnameFormatDefault: '%stackname%-cephstorage-leaf1-%index%'

   3. それぞれのリーフネットワークのパラメーターと整合するように、新しい Leaf ファイルの networks パラメーターを編集します。

      例

      たとえば、Leaf 1 Compute ファイルのパラメーター値は、以下のように設定します。

      - name: ComputeLeaf1
        networks:
          InternalApi:
            subnet: internal_api_leaf1
          Tenant:
            subnet: tenant_leaf1
          Storage:
            subnet: storage_leaf1

      例

      Leaf 1 Ceph Storage ファイルのパラメーター値は、以下のように設定します。

      - name: CephStorageLeaf1
        networks:
          Storage:
            subnet: storage_leaf1
          StorageMgmt:
            subnet: storage_mgmt_leaf1

   4. ロールの設定が完了したら、以下のコマンドを実行して完全なロールデータファイルを生成します。ネットワークにすべてのリーフと、新たに追加するリーフを含めます。

      例

      以下の例では、leaf3 が leaf0、leaf1、および leaf2 に追加されます。

      $ openstack overcloud roles generate --roles-path ~/roles -o roles_data_spine_leaf.yaml Controller Controller1 Controller2 Compute Compute1 Compute2 Compute3 CephStorage CephStorage1 CephStorage2 CephStorage3

      これにより、各リーフネットワーク用の全カスタムロールが含まれた完全な roles_data_spine_leaf.yaml ファイルが作成されます。

5. 追加するリーフ用のカスタム NIC 設定を作成します。

   1. 追加する新しいリーフ用のリーフ Compute およびリーフ Ceph Storage NIC 設定ファイルをコピーします。

      例

      この例では、computeleaf1.yaml および ceph-storageleaf1.yaml が新しいリーフ (computeleaf3.yaml および ceph-storageleaf3.yaml) にコピーされます。

      $ cp ~/templates/spine-leaf-nics/computeleaf1.yaml ~/templates/spine-leaf-nics/computeleaf3.yaml
      $ cp ~/templates/spine-leaf-nics/ceph-storageleaf1.yaml ~/templates/spine-leaf-nics/ceph-storageleaf3.yaml

6. ロールと各ロールのカスタム NIC テンプレートマッピングを含むカスタム環境ファイル (例: spine-leaf-nic-roles-map.yaml) を開きます。追加する新しいリーフのロールごとにエントリーを挿入します。

   parameter_defaults:
     %%ROLE%%NetworkConfigTemplate: <path_to_ansible_jinja2_nic_config_file>

   例

   この例では、エントリー ComputeLeaf3NetworkConfigTemplate および CephStorage3NetworkConfigTemplate が追加されています。

   parameter_defaults:
     Controller0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     Controller1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     Controller2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     ComputeLeaf3NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage0NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage1NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage2NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'
     CephStorage3NetworkConfigTemplate: '/home/stack/templates/spine-leaf-nics/single-nic-vlans.j2'

7. 個別のネットワークマッピングを含み、オーバークラウドのコントロールプレーンネットワークへのアクセスを設定するカスタムネットワーク環境ファイル (spine-leaf-ctlplane.yaml など) を開き、コントロールプレーンパラメーターを更新します。

   parameter_defaults セクションで、新しいリーフネットワークのコントロールプレーンサブネットマッピングを追加します。また、新しいリーフネットワークの外部ネットワークマッピングも含めます。

   • フラットネットワークのマッピングの場合には、NeutronFlatNetworks パラメーターの新しいリーフ (leaf3) をリスト表示し、新しいリーフの NeutronBridgeMappings パラメーターを設定します。

     parameter_defaults:
       NeutronFlatNetworks: leaf0,leaf1,leaf2,leaf3
       Controller0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       Compute0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       Compute1Parameters:
         NeutronBridgeMappings: "leaf1:br-ex"
       Compute2Parameters:
         NeutronBridgeMappings: "leaf2:br-ex"
       Compute3Parameters:
         NeutronBridgeMappings: "leaf3:br-ex"

   • VLAN ネットワークのマッピングの場合には、さらに NeutronNetworkVLANRanges を設定して、新しいリーフネットワーク用 (leaf3) に VLAN をマッピングします。

       NeutronNetworkType: 'geneve,vlan'
       NeutronNetworkVLANRanges: 'leaf0:1:1000,leaf1:1:1000,leaf2:1:1000,leaf3:1:1000'

     例

     この例では、フラットネットワークマッピングが使用され、新しいリーフ (leaf3) エントリーが追加されます。

     parameter_defaults:
       NeutronFlatNetworks: leaf0,leaf1,leaf2,leaf3
       Controller0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       ControllerControlPlaneSubnet: leaf0
       Controller1Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       Controller1ControlPlaneSubnet: leaf0
       Controller2Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       Controller2ControlPlaneSubnet: leaf0
       Compute0Parameters:
         NeutronBridgeMappings: "leaf0:br-ex"
       Compute0ControlPlaneSubnet: leaf0
       Compute1Parameters:
         NeutronBridgeMappings: "leaf1:br-ex"
       Compute1ControlPlaneSubnet: leaf1
       Compute2Parameters:
         NeutronBridgeMappings: "leaf2:br-ex"
       Compute2ControlPlaneSubnet: leaf2
       Compute3Parameters:
         NeutronBridgeMappings: "leaf3:br-ex"
       Compute3ControlPlaneSubnet: leaf3

8. 変更したネットワークをプロビジョニングします。

   詳細は、オーバークラウドネットワークとオーバークラウド VIP のプロビジョニング を参照してください。

9. 前に作成したベアメタルノード定義ファイル (例: spine-leaf-baremetal-nodes.yaml) で、network_config_update 変数が true に設定されていることを確認します。

   例

   - name: Controller
     count: 3
     defaults:
       networks:
       - network: ctlplane
         vif: true
       - network: external
         subnet: external_subnet
       - network: internal_api
         subnet: internal_api_subnet01
       - network: storage
         subnet: storage_subnet01
       - network: storage_mgmt
         subnet: storage_mgmt_subnet01
       - network: tenant
         subnet: tenant_subnet01
       network_config:
         template: /home/stack/templates/spine-leaf-nics/single-nic-vlans.j2
         default_route_network:
         - external
       network_config_update: true

10. 変更したノードをプロビジョニングします。

    詳細は、ベアメタルノードのプロビジョニング を参照してください。

11. スパイン/リーフ対応オーバークラウドのデプロイの手順に従って、スパイン/リーフ対応オーバークラウド を再デプロイします。