手順

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. 各カスタムロール用のフレーバーを作成します。

   $ ROLES="control compute_leaf0 compute_leaf1 compute_leaf2 ceph-storage_leaf0 ceph-storage_leaf1 ceph-storage_leaf2"
   $ for ROLE in $ROLES; do openstack flavor create --id auto --ram <ram_size_mb> --disk <disk_size_gb> --vcpus <no_vcpus> $ROLE ; done
   $ for ROLE in $ROLES; do openstack flavor set --property "cpu_arch"="x86_64" --property "capabilities:boot_option"="local" --property resources:DISK_GB='0' --property resources:MEMORY_MB='0' --property resources:VCPU='0' $ROLE ; done

   • <ram_size_mb> をベアメタルノードの RAM (MB 単位) に置き換えます。
   • <disk_size_gb> をベアメタルノード上のディスク容量 (GB 単位) に置き換えます。
   • <no_vcpus> をベアメタルノードの CPU 数に置き換えます。

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

   (undercloud)$ openstack baremetal node list

4. カスタムリソースクラスを使用して、各ベアメタルノードをリーフネットワークおよびロールにタグ付けします。

   (undercloud)$ openstack baremetal node set \
    --resource-class baremetal.LEAF-ROLE <node>

   <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

5. 各リーフネットワークロールフレーバーをカスタムリソースクラスに関連付けます。

   (undercloud)$ openstack flavor set \
    --property resources:CUSTOM_BAREMETAL_LEAF_ROLE=1 \
   <custom_role>

   Bare Metal Provisioning サービスノードのリソースクラスに対応するカスタムリソースクラスの名前を指定するには、リソースクラスを大文字に変換し、それぞれの句読点をアンダースコアに置き換え、CUSTOM_ の接頭辞を追加します。

   注記

   フレーバーが要求できるのは、ベアメタルリソースクラスの 1 つのインスタンスだけです。

6. node-info.yaml ファイルで、各カスタムリーフロールに使用するフレーバーおよび各カスタムリーフロールに割り当てるノード数を指定します。たとえば、以下の設定では、使用するフレーバーと、カスタムのリーフロール compute_leaf0、compute_leaf1、compute_leaf2、ceph-storage_leaf0、ceph-storage_leaf1、および ceph-storage_leaf2 に割り当てるノード数を指定します。

   parameter_defaults:
     OvercloudControllerFlavor: control
     OvercloudComputeLeaf0Flavor: compute_leaf0
     OvercloudComputeLeaf1Flavor: compute_leaf1
     OvercloudComputeLeaf2Flavor: compute_leaf2
     OvercloudCephStorageLeaf0Flavor: ceph-storage_leaf0
     OvercloudCephStorageLeaf1Flavor: ceph-storage_leaf1
     OvercloudCephStorageLeaf2Flavor: ceph-storage_leaf2
     ControllerLeaf0Count: 3
     ComputeLeaf0Count: 3
     ComputeLeaf1Count: 3
     ComputeLeaf2Count: 3
     CephStorageLeaf0Count: 3
     CephStorageLeaf1Count: 3
     CephStorageLeaf2Count: 3

手順

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. source コマンドでアンダークラウドの認証情報ファイルを読み込みます。

   $ 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 ユーザーのホームディレクトリーに、新たな network_data_spine_leaf.yaml ファイルを作成します。デフォルトの network_data_subnets_routed.yaml ファイルをベースとして使用します。

   $ cp /usr/share/openstack-tripleo-heat-templates/network_data_subnets_routed.yaml /home/stack/network_data_spine_leaf.yaml

2. network_data_spine_leaf.yaml ファイルの YAML リストを編集して、各ベースネットワークおよび対応するリーフサブネットをコンポーザブルネットワーク項目として定義します。以下に示す構文の例を使用して、ベースのリーフおよび 2 つのリーフサブネットを定義します。

   - name: <base_name>
     name_lower: <lowercase_name>
     vip: <true/false>
     vlan: '<vlan_id>'
     ip_subnet: '<network_address>/<prefix>'
     allocation_pools: [{'start': '<start_address>', 'end': '<end_address>'}]
     gateway_ip: '<router_ip_address>'
     subnets:
       <leaf_subnet_name>:
         vlan: '<vlan_id>'
         ip_subnet: '<network_address>/<prefix>'
         allocation_pools: [{'start': '<start_address>', 'end': '<end_address>'}]
         gateway_ip: '<router_ip_address>'
       <leaf_subnet_name>:
         vlan: '<vlan_id>'
         ip_subnet: '<network_address>/<prefix>'
         allocation_pools: [{'start': '<start_address>', 'end': '<end_address>'}]
         gateway_ip: '<router_ip_address>'

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

   - 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'

手順

1. stack ユーザーのホームディレクトリーに、カスタム roles ディレクトリーを作成します。

   $ mkdir ~/roles

2. デフォルトの Controller、Compute、Ceph Storage ロールを、director のコアテンプレートコレクションから roles ディレクトリーにコピーします。Leaf 0 に合わせて、Compute および Ceph Storage 用ファイルの名前を変更します。

   $ cp /usr/share/openstack-tripleo-heat-templates/roles/Controller.yaml ~/roles/Controller.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

3. Leaf 0 の Compute および Ceph Storage ファイルをベースとして、Leaf 1 および Leaf 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

4. それぞれのリーフパラメーターと整合するように、Leaf 0、Leaf 1、および Leaf 2 ファイルの name、HostnameFormatDefault、および deprecated_nic_config_name パラメーターを編集します。たとえば、Leaf 0 Compute ファイルのパラメーター値は、以下のように設定します。

   - name: ComputeLeaf0
     HostnameFormatDefault: '%stackname%-compute-leaf0-%index%'
     deprecated_nic_config_name: 'computeleaf0.yaml'

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

   - name: CephStorageLeaf0
     HostnameFormatDefault: '%stackname%-cephstorage-leaf0-%index%'
     deprecated_nic_config_name: 'ceph-strorageleaf0.yaml'

5. それぞれのリーフネットワークのパラメーターと整合するように、Leaf 1 および Leaf 2 ファイルの 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

   注記

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

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

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

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

手順

1. コア Heat テンプレートディレクトリーに移動します。

   $ cd /usr/share/openstack-tripleo-heat-templates

2. tools/process-templates.py スクリプト、カスタム network_data ファイル、およびカスタム roles_data ファイルを使用して、Jinja2 テンプレートをレンダリングします。

   $ tools/process-templates.py \
       -n /home/stack/network_data_spine_leaf.yaml \
       -r /home/stack/roles_data_spine_leaf.yaml \
       -o /home/stack/openstack-tripleo-heat-templates-spine-leaf

3. ホームディレクトリーに移動します。

   $ cd /home/stack

4. デフォルト NIC テンプレートのいずれかからコンテンツをコピーし、スパイン/リーフ型テンプレートのベースとして使用します。たとえば、single-nic-vlans NIC テンプレートをコピーするには、以下のコマンドを実行します。

   $ cp -r openstack-tripleo-heat-templates-spine-leaf/network/config/single-nic-vlans/* /home/stack/templates/spine-leaf-nics/.

5. /home/stack/templates/spine-leaf-nics/ の各 NIC 設定を編集し、設定スクリプトの場所を絶対パスに変更します。以下のスニペットに示すような、ネットワーク設定のセクションにスクロールします。

   resources:
     OsNetConfigImpl:
       type: OS::Heat::SoftwareConfig
       properties:
         group: script
         config:
           str_replace:
             template:
               get_file: ../../scripts/run-os-net-config.sh
             params:
               $network_config:
                 network_config:

   スクリプトの場所を絶対パスに変更します。

   resources:
     OsNetConfigImpl:
       type: OS::Heat::SoftwareConfig
       properties:
         group: script
         config:
           str_replace:
             template:
               get_file: /usr/share/openstack-tripleo-heat-templates/network/scripts/run-os-net-config.sh
             params:
               $network_config:
                 network_config:

   それぞれのリーフの各ファイルについてこの変更を行い、変更を保存します。

   注記

   NIC をさらに変更する場合には、Advanced Overcloud Customization の Custom network interface templates を参照してください。

6. spine-leaf-nics.yaml という名前のファイルを作成し、そのファイルを編集します。

7. ファイルに resource_registry セクションを作成し、*::Net::SoftwareConfig リソースのセットを追加して、対応する NIC テンプレートにマッピングします。

   resource_registry:
     OS::TripleO::Controller::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/controller.yaml
     OS::TripleO::ComputeLeaf0::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf0.yaml
     OS::TripleO::ComputeLeaf1::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf1.yaml
     OS::TripleO::ComputeLeaf2::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf2.yaml
     OS::TripleO::CephStorageLeaf0::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf0.yaml
     OS::TripleO::CephStorageLeaf1::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf1.yaml
     OS::TripleO::CephStorageLeaf2::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf2.yaml

   これらのリソースマッピングは、デプロイメント時にデフォルトのリソースマッピングをオーバーライドします。

8. spine-leaf-nics.yaml ファイルを保存します。

9. レンダリング済みテンプレートのディレクトリーを削除します。

   $ rm -rf openstack-tripleo-heat-templates-spine-leaf

   上記の手順を実施すると、NIC テンプレートのセットと共に、必要な ::Net::SoftwareConfig リソースをそれらのテンプレートにマッピングする環境ファイルが作成されます。

10. 最終的に openstack overcloud deploy コマンドを実行する際には、環境ファイルを以下の順番で追加するようにしてください。

    1. /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml: ネットワーク分離を有効にします。director はこのファイルを network-isolation.j2.yaml Jinja2 テンプレートからレンダリングする点に注意してください。
    2. /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml: デフォルトの NIC リソースマッピングが含まれるデフォルトのネットワーク環境ファイル。director はこのファイルを network-environment.j2.yaml Jinja2 テンプレートからレンダリングする点に注意してください。

    3. /home/stack/templates/spine-leaf-nics.yaml: カスタム NIC リソースマッピングが含まれるこのファイルは、デフォルトの NIC リソースマッピングをオーバーライドします。

       以下のコマンドスニペットに、環境ファイルの順番を示します。

       $ openstack overcloud deploy --templates
           ...
           -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
           -e /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml \
           -e /home/stack/templates/spine-leaf-nics.yaml \
           ...

11. ネットワーク環境ファイルに情報を追加してスパイン/リーフアーキテクチャーの特定機能を定義するには、以降のセクションに記載する手順を実施します。この設定を完了したら、このファイルを openstack overcloud deploy コマンドに追加します。

手順

1. spine-leaf-ctlplane.yaml という名前のファイルを作成し、そのファイルを編集します。

2. ファイルに parameter_defaults セクションを作成し、それぞれのスパイン/リーフ型ネットワークについてコントロールプレーンのサブネットのマッピングを追加します。

   parameter_defaults:
     ...
     ControllerControlPlaneSubnet: leaf0
     Compute0ControlPlaneSubnet: leaf0
     Compute1ControlPlaneSubnet: leaf1
     Compute2ControlPlaneSubnet: leaf2
     CephStorage0ControlPlaneSubnet: leaf0
     CephStorage1ControlPlaneSubnet: leaf1
     CephStorage2ControlPlaneSubnet: leaf2

3. spine-leaf-ctlplane.yaml ファイルを保存します。

手順

1. spine-leaf-vips.yaml という名前のファイルを作成し、そのファイルを編集します。

2. ファイルに parameter_defaults セクションを作成し、それぞれの要件に応じて VipSubnetMap パラメーターを追加します。

   • プロビジョニング / コントロールプレーンネットワークに leaf0 を使用する場合には、ctlplane の仮想 IP 再マッピングを leaf0 に設定します。

     parameter_defaults:
       VipSubnetMap:
         ctlplane: leaf0

   • 複数の仮想 IP に異なるリーフを使用する場合には、要求に応じて仮想 IP の再マッピングを設定します。たとえば、以下のスニペットを使用して、すべての仮想 IP に leaf1 を使用するように VipSubnetMap パラメーターを設定します。

     parameter_defaults:
       VipSubnetMap:
         ctlplane: leaf1
         redis: internal_api_leaf1
         InternalApi: internal_api_leaf1
         Storage: storage_leaf1
         StorageMgmt: storage_mgmt_leaf1

3. spine-leaf-vips.yaml ファイルを保存します。

手順

1. spine-leaf-separate.yaml という名前のファイルを作成し、そのファイルを編集します。

2. spine-leaf-separate.yaml ファイルに parameter_defaults セクションを作成し、それぞれのスパイン/リーフネットワークについて外部ネットワークのマッピングを追加します。

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

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

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

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

3. spine-leaf-separate.yaml ファイルを保存します。

手順

1. /home/stack/template/network_data_spine_leaf.yaml ファイルをチェックして、各リーフ用のネットワークおよびサブネットがすべて含まれていることを確認します。

   注記

   現在、ネットワークサブネットおよび allocation_pools の値に対する自動検証はありません。これらの値を一貫性を持って定義し、既存のネットワークと競合しないようにしてください。

2. /home/stack/templates/roles_data_spine_leaf.yaml の値をチェックして、各リーフのロールが定義されていることを確認します。
3. ~/templates/spine-leaf-nics/ ディレクトリーの NIC テンプレートをチェックして、各リーフ上のそれぞれのロールのインターフェイスが正しく定義されていることを確認します。
4. spine-leaf-nics.yaml カスタム環境ファイルをチェックして、各ロールのカスタム NIC テンプレートを参照する resource_registry セクションが含まれていることを確認します。
5. /home/stack/templates/nodes_data.yaml ファイルをチェックして、全ロールにフレーバーとノード数が割り当てられていることを確認します。また、各リーフのノードがすべて適切にタグ付けされていることを確認します。

6. openstack overcloud deploy コマンドを実行して、スパイン/リーフの設定を適用します。以下に例を示します。

   $ openstack overcloud deploy --templates \
       -n /home/stack/templates/network_data_spine_leaf.yaml \
       -r /home/stack/templates/roles_data_spine_leaf.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml \
       -e /home/stack/templates/spine-leaf-nics.yaml \
       -e /home/stack/templates/spine-leaf-ctlplane.yaml \
       -e /home/stack/templates/spine-leaf-vips.yaml \
       -e /home/stack/templates/spine-leaf-separate.yaml \
       -e /home/stack/templates/nodes_data.yaml \
       -e [OTHER ENVIRONMENT FILES]

   • network-isolation.yaml は、同じ場所にある Jinja2 ファイル (network-isolation.j2.yaml) のレンダリング後の名前です。デプロイメントコマンドにこのファイルを追加して、director が各ネットワークを正しいリーフに分離できるようにします。これにより、ネットワークはオーバークラウドの作成プロセス中に動的に作成されるようになります。
   • network-isolation.yaml ファイルの後に network-environment.yaml ファイルを指定します。network-environment.yaml ファイルにより、コンポーザブルネットワークパラメーターのデフォルトネットワーク設定が提供されます。
   • network-environment.yaml ファイルの後に spine-leaf-nics.yaml ファイルを指定します。spine-leaf-nics.yaml ファイルは、network-environment.yaml ファイルで定義されるデフォルト NIC テンプレートマッピングをオーバーライドします。
   • これ以外にスパイン/リーフネットワークの環境ファイルを作成した場合には、spine-leaf-nics.yaml ファイルの後にそれらの環境ファイルを追加します。
   • 環境ファイルを更に追加します。(例: コンテナーイメージの場所や Ceph クラスターの設定を定義した環境ファイルなど)。
7. スパイン/リーフ対応のオーバークラウドがデプロイされるまで待ちます。

手順

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

2. source コマンドでアンダークラウドの認証情報ファイルを読み込みます。

   $ source ~/stackrc

3. /usr/share/openstack-tripleo-heat-templates/network_data_spine_leaf.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. それぞれのリーフパラメーターと整合するように、新しい leaf ファイルの name、HostnameFormatDefault、および deprecated_nic_config_name パラメーターを編集します。

      例

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

      - name: ComputeLeaf1
        HostnameFormatDefault: '%stackname%-compute-leaf1-%index%'
        deprecated_nic_config_name: 'computeleaf1.yaml'

      例

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

      - name: CephStorageLeaf1
        HostnameFormatDefault: '%stackname%-cephstorage-leaf1-%index%'
        deprecated_nic_config_name: 'ceph-strorageleaf1.yaml'

   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 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

   2. /usr/share/openstack-tripleo-heat-templates/network_data_spine_leaf.yaml のファイルの resource_registry セクションで、::Net::SoftwareConfig リソースのセットを追加して、各 NIC テンプレートにマップします。

      例

      以下の例では、新たなリーフ NIC 設定ファイル (computeleaf3.yaml および ceph-storageleaf3.yaml) が追加されました。

      resource_registry:
        OS::TripleO::Controller::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/controller.yaml
        OS::TripleO::ComputeLeaf0::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf0.yaml
        OS::TripleO::ComputeLeaf1::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf1.yaml
        OS::TripleO::ComputeLeaf2::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf2.yaml
        OS::TripleO::ComputeLeaf3::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/computeleaf3.yaml
        OS::TripleO::CephStorageLeaf0::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf0.yaml
        OS::TripleO::CephStorageLeaf1::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf1.yaml
        OS::TripleO::CephStorageLeaf2::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf2.yaml
        OS::TripleO::CephStorageLeaf3::Net::SoftwareConfig: /home/stack/templates/spine-leaf-nics/ceph-storageleaf3.yaml

      これらのリソースマッピングは、デプロイメント時にデフォルトのリソースマッピングをオーバーライドします。

      上記の手順を実施すると、NIC テンプレートのセットと共に、必要な ::Net::SoftwareConfig リソースをそれらのテンプレートにマッピングする環境ファイルが作成されます。最終的に openstack overcloud deploy コマンドを実行する際には、環境ファイルを以下の順番で追加するようにしてください。

   3. /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml: ネットワーク分離を有効にします。

      director はこのファイルを network-isolation.j2.yaml Jinja2 テンプレートからレンダリングする点に注意してください。

   4. /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml: デフォルトの NIC リソースマッピングが含まれるデフォルトのネットワーク環境ファイル。

      director はこのファイルを network-environment.j2.yaml Jinja2 テンプレートからレンダリングする点に注意してください。

   5. /home/stack/templates/spine-leaf-nics.yaml: カスタム NIC リソースマッピングが含まれるこのファイルは、デフォルトの NIC リソースマッピングをオーバーライドします。

      以下のコマンドスニペットに、環境ファイルの順番を示します。

      $ openstack overcloud deploy --templates
          ...
          -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
          -e /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml \
          -e /home/stack/templates/spine-leaf-nics.yaml \
          ...

6. コントロールプレーンのパラメーターを更新します。

   ~/templates/spine-leaf-ctlplane.yaml の parameter_defaults セクションに、新しいリーフネットワーク用のコントロールプレーンのサブネットマッピングを追加します。

   例

   以下の例では、新しいリーフ (leaf3) エントリーを追加します。

   parameter_defaults:
     ...
     ControllerControlPlaneSubnet: leaf0
     Compute0ControlPlaneSubnet: leaf0
     Compute1ControlPlaneSubnet: leaf1
     Compute2ControlPlaneSubnet: leaf2
     Compute3ControlPlaneSubnet: leaf3
     CephStorage0ControlPlaneSubnet: leaf0
     CephStorage1ControlPlaneSubnet: leaf1
     CephStorage2ControlPlaneSubnet: leaf2
     CephStorage3ControlPlaneSubnet: leaf3

7. 新しいリーフネットワークをマッピングします。

   ~/templates/spine-leaf-separate.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'

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