第2章 Bare Metal デプロイメントの設定

OpenStack Networking が Bare Metal Provisioning と通信するための設定

1. Identity に管理ユーザーとしてアクセスするためのシェルを設定します。

   # source ~stack/overcloudrc

2. ベアメタルインスタンスをプロビジョニングするためのフラットなネットワークを作成します。

   # neutron net-create --tenant-id TENANT_ID sharednet1 --shared \
   --provider:network_type flat --provider:physical_network PHYSNET

   TENANT_ID はネットワークを作成するテナントの一意識別子に、PHYSNET は物理ネットワークの名前に置き換えます。

3. フラットネットワーク上にサブネットを作成します。

   # neutron subnet-create sharednet1 NETWORK_CIDR --name SUBNET_NAME \
   --ip-version 4 --gateway GATEWAY_IP --allocation-pool \
   start=START_IP,end=END_IP --enable-dhcp

   以下の値を置き換えてください。

   • NETWORK_CIDR は、サブネットが示す IP アドレスブロックの Classless Inter-Domain Routing (CIDR) 表記に置き換えます。 START_IP で始まり END_IP で終る範囲で指定する IP アドレスブロックは、NETWORK_CIDR で指定されている IP アドレスブロックの範囲内に入る必要があります。
   • SUBNET_NAME はサブネットの名前に置き換えます。
   • GATEWAY_IP は新しいサブネットのゲートウェイとして機能するシステムの IP アドレスまたはホスト名に置き換えます。このアドレスは、 NETWORK_CIDR で指定されている IP アドレスブロック内で、かつ START_IP で始まり END_IP で終わる範囲で指定されている IP アドレスブロック外である必要があります。
   • START_IP は、Floating IP アドレスの割り当て元となる新規サブネット内の IP アドレス範囲の開始アドレスを示す IP アドレスに置き換えます。
   • END_IP は、Floating IP アドレスの割り当て元となる新規サブネット内の IP アドレス範囲の終了アドレスを示す IP アドレスに置き換えます。

4. ネットワークとサブネットをルーターに接続して、メタデータ要求が OpenStack Networking サービスによって応答されるようにします。

   # neutron router-create ROUTER_NAME

   ROUTER_NAME はルーターの名前に置き換えます。

5. ベアメタルのサブネットにこのルーターをインターフェースとして追加します。

   # neutron router-interface-add ROUTER_NAME BAREMETAL_SUBNET

   ROUTER_NAME は、ルーターの名前に、BAREMETAL_SUBNET は以前に作成した ID またはサブネット名に置き換えます。これにより、cloud-init からのメタデータ要求に応答することができます。

6. Bare Metal Provisioning サービスを実行するコンピュートノード上の /etc/ironic/ironic.conf ファイルを更新して、クリーニングサービスに同じネットワークを使用するようにします。Bare Metal Provisioning を実行しているコンピュートノードにログインして、以下のコマンドを root ユーザーとして実行します。

   # openstack-config --set /etc/ironic/ironic.conf neutron cleaning_network_uuid NETWORK_UUID

   NETWORK_UUID は、前のステップで作成したベアメタルプロビジョニングネットワークの ID に置き換えます。

7. Bare Metal Provisioning サービスを再起動します。

   # systemctl restart openstack-ironic-conductor.service

1. Identity に管理ユーザーとしてアクセスするためのシェルを設定します。

   # source ~stack/overcloudrc

2. 既存のフレーバーを一覧表示します。

   # openstack flavor list

3. Bare Metal Provisioning サービス向けに新規フレーバーを作成します。

   # openstack flavor create --id auto --ram RAM --vcpus VCPU --disk DISK --public baremetal

   RAM は RAM のメモリーに、VCPU は仮想 CPU 数に、DISK はディスクストレージの値に置き換えます。

4. 指定したそれぞれの値を使用して新規フレーバーが作成されたことを確認します。

   # openstack flavor list

1. overcloudrc ファイルを読み込んで、.json ファイルをインポートします。

   # source ~stack/overcloudrc
   # openstack baremetal import --json ./baremetal.json

2. Bare Metal Provisioning サービス内のベアメタルノードの driver_info セクションの deploy_kernel と deploy_ramdisk を指定して、そのノードが初期ブートイメージとしてデプロイ済みのイメージを使用するように設定します。

   # ironic node-update NODE_UUID add driver_info/deploy_kernel=DEPLOY_KERNEL_ID driver_info/deploy_ramdisk=DEPLOY_RAMDISK_ID

Image プロキシーの設定

1. Identity に管理ユーザーとしてアクセスするためのシェルを設定します。

   # source ~stack/overcloudrc

2. ベアメタルノードドライバーが HTTP または HTTPS を使用するための設定

   # openstack baremetal node set NODE_UUID \
      --driver_info image_https_proxy=HTTPS://PROXYIP:PORT

   この例では、HTTPS プロトコルを使用します。HTTPS の代わりに HTTP を使用する場合には、driverinfo/image_http_proxy パラメーターを指定してください。

3. イメージが要求された時に、Bare Metal Provisioning が Object Storage のキャッシュ済み一時 URL を再使用するように設定します。

   # openstack-config --set /etc/ironic/ironic.conf glance swift_temp_url_cache_enabled=true

   プロキシーサーバーは、URL のクエリーの部分に基づいて、要求が生成される度に毎回変更されるクエリーパラメーターが含まれている場合には、同じイメージには新規キャッシュエントリーを作成しません。

4. 生成された URL の有効期間を (秒単位で) 設定します。

   # openstack-config --set /etc/ironic/ironic.conf glance swift_temp_url_duration=DURATION

   Object Storage サービスの一時 URL のキャッシュからは、有効期限が切れていないイメージリンクのみが返されます。swift_temp_url_duration=1200 と設定した場合には、新しいイメージはプロキシーサーバーによって 20分後にキャッシュされます。このオプションの値は、 swift_temp_url_expected_download_start_delay の値以上である必要があります。

5. ハードウェアに対して、ダウンロードを開始するまでの遅延時間 (秒単位) を設定します。

   # openstack-config --set /etc/ironic/ironic.conf glance swift_temp_url_expected_download_start_delay=DELAY

   DELAY には、デプロイが要求 (一時 URL が生成) されてから、その URL を使用してイメージがベアメタルにダウンロードされるまでの遅延時間を設定します。この遅延時間により、ramdisk を起動してからイメージのダウンロードを開始することができます。この値により、イメージのダウンロード開始時にキャッシュされたエントリーが引き続き有効な状態となるかどうかが決定します。

ハードウェア検査を使用してノードを追加する方法

1. Identity を管理ユーザーとして使用するためのシェルを設定します。

   # source ~/keystonerc_admin

2. 新規ノードを追加します。

   # ironic node-create -d DRIVER_NAME

   DRIVER_NAME は、Bare Metal Provisioning がこのノードのプロビジョニングに使用するドライバーの名前に置き換えます。このドライバーは、/etc/ironic/ironic.conf ファイルで有効にしておく必要があります。ノードを作成するには、少なくともドライバーの名前を指定する必要があります。

   重要

   ノードの一意識別子を書き留めておきます。

3. ノードは論理名または UUID で参照することができます。オプションで、ノードに論理名を割り当てます。

   # ironic node-update NODE_UUID add name=NAME

   NODE_UUID は、ノードの一意識別子に置き換えます。NAME は、ノードの論理名に置き換えます。

4. ドライバーが必要とするノードの情報を確認してから、Bare Metal Provisioning がノードを管理するようにノードドライバーの情報を更新します。

   # ironic driver-properties DRIVER_NAME
   # ironic node-update NODE_UUID add \
      driver_info/PROPERTY=VALUE \
      driver_info/PROPERTY=VALUE

   以下の値を置き換えてください。

   • DRIVER_NAME は、プロパティーを表示するドライバーの名前に置き換えます。この情報は、/etc/ironic/ironic.conf ファイルでドライバーを有効にしていなければ返されません。
   • NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。
   • PROPERTY は、ironic driver-properties コマンドで返された必要なプロパティーに置き換えます。
   • VALUE は、プロパティーの有効な値に置き換えます。

5. ノードドライバーのデプロイカーネルとデプロイ RAM ディスクを指定します。

   # ironic node-update NODE_UUID add \
     driver_info/deploy_kernel=KERNEL_UUID \
     driver_info/deploy_ramdisk=INITRAMFS_UUID

   以下の値を置き換えてください。

   • NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。
   • KERNEL_UUID は、Image サービスにアップロードされた .kernel イメージの一意識別子に置き換えます。
   • INITRAMFS_UUID は、Image サービスにアップロードされた .initramfs イメージの一意識別子に置き換えます。

6. ノードを設定して、初回のデプロイの後には、PXE や仮想メディアの代わりに、そのノードのディスクにインストールされたローカルのブートローダーからリブートするようにします。ノードのプロビジョニングに使用するフレーバーでも、ローカルブートの機能を設定する必要があります。ローカルブートを有効にするには、ノードのデプロイに使用するイメージに grub2 が含まれる必要があります。ローカルブートを以下のように設定します。

   # ironic node-update NODE_UUID add \
      properties/capabilities="boot_option:local"

   NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。

7. ベアメタルノードを manageable 状態に切り替えます。

   # ironic node-set-provision-state NODE_UUID manage

   NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。

8. 検査を開始します。

   # openstack baremetal introspection start NODE_UUID --discoverd-url http://overcloud IP:5050

   • NODE_UUID はノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。ノードをプロビジョニングする前に、ノードの検出および検査プロセスは完了するまで実行する必要があります。ノードの検査のステータスを確認するには、ironic node-list を実行して Provision State の箇所を探します。検査が正常に完了すると、ノードは available の状態になります。
   • overcloud IP は ironic.conf で以前設定した service_url の値に置き換えます。

9. ノードの設定を検証します。

   # ironic node-validate NODE_UUID
   +------------+--------+----------------------------+
   | Interface  | Result | Reason                     |
   +------------+--------+----------------------------+
   | console    | None   | not supported              |
   | deploy     | True   |                            |
   | inspect    | True   |                            |
   | management | True   |                            |
   | power      | True   |                            |
   +------------+--------+----------------------------+

   NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。上記のコマンドの出力には、各インターフェースが True または None のいずれかと報告されるはずです。None とマークされたインターフェースは、設定していないか、ドライバーがサポートしていないインターフェースです。

ハードウェア検査を使用せずにノードを追加する方法

1. Identity を管理ユーザーとして使用するためのシェルを設定します。

   # source ~/keystonerc_admin

2. 新規ノードを追加します。

   # ironic node-create -d DRIVER_NAME

   DRIVER_NAME は、Bare Metal Provisioning がこのノードのプロビジョニングに使用するドライバーの名前に置き換えます。このドライバーは、/etc/ironic/ironic.conf ファイルで有効にしておく必要があります。ノードを作成するには、少なくともドライバーの名前を指定する必要があります。

   重要

   ノードの一意識別子を書き留めておきます。

3. ノードは論理名または UUID で参照することができます。オプションで、ノードに論理名を割り当てます。

   # ironic node-update NODE_UUID add name=NAME

   NODE_UUID は、ノードの一意識別子に置き換えます。NAME は、ノードの論理名に置き換えます。

4. ドライバーが必要とするノードの情報を確認してから、Bare Metal Provisioning がノードを管理するようにノードドライバーの情報を更新します。

   # ironic driver-properties DRIVER_NAME
   # ironic node-update NODE_UUID add \
      driver_info/PROPERTY=VALUE \
      driver_info/PROPERTY=VALUE

   以下の値を置き換えてください。

   • DRIVER_NAME は、プロパティーを表示するドライバーの名前に置き換えます。この情報は、/etc/ironic/ironic.conf ファイルでドライバーを有効にしていなければ返されません。
   • NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。
   • PROPERTY は、ironic driver-properties コマンドで返された必要なプロパティーに置き換えます。
   • VALUE は、プロパティーの有効な値に置き換えます。

5. ノードドライバーのデプロイカーネルとデプロイ RAM ディスクを指定します。

   # ironic node-update NODE_UUID add \
     driver_info/deploy_kernel=KERNEL_UUID \
     driver_info/deploy_ramdisk=INITRAMFS_UUID

   以下の値を置き換えてください。

   • NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。
   • KERNEL_UUID は、Image サービスにアップロードされた .kernel イメージの一意識別子に置き換えます。
   • INITRAMFS_UUID は、Image サービスにアップロードされた .initramfs イメージの一意識別子に置き換えます。

6. ノードのプロパティーを更新して、ノード上のハードウェアの仕様と一致するようにします。

   # ironic node-update NODE_UUID add \
      properties/cpus=CPU \
      properties/memory_mb=RAM_MB \
      properties/local_gb=DISK_GB \
      properties/cpu_arch=ARCH

   以下の値を置き換えてください。

   • NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。
   • CPU は、使用する CPU 数に置き換えます。
   • RAM_MB は、使用するメモリー (MB 単位) に置き換えます。
   • DISK_GB は、使用するディスクサイズ (GB 単位) に置き換えます。
   • ARCH は使用するアーキテクチャーのタイプに置き換えます。

7. ノードを設定して、初回のデプロイの後には、PXE や仮想メディアの代わりに、そのノードのディスクにインストールされたローカルのブートローダーからリブートするようにします。ノードのプロビジョニングに使用するフレーバーでも、ローカルブートの機能を設定する必要があります。ローカルブートを有効にするには、ノードのデプロイに使用するイメージに grub2 が含まれる必要があります。ローカルブートを以下のように設定します。

   # ironic node-update NODE_UUID add \
      properties/capabilities="boot_option:local"

   NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。

8. Bare Metal Provisioning にノードのネットワークインターフェースカードの情報を提供します。各 NIC の MAC アドレスでポートを作成します。

   # ironic port-create -n NODE_UUID -a MAC_ADDRESS

   NODE_UUID は、ノードの一意識別子に置き換えます。MAC_ADDRESS は、ノード上の NIC の MAC アドレスに置き換えます。

9. ノードの設定を検証します。

   # ironic node-validate NODE_UUID
   +------------+--------+----------------------------+
   | Interface  | Result | Reason                     |
   +------------+--------+----------------------------+
   | console    | None   | not supported              |
   | deploy     | True   |                            |
   | inspect    | None   | not supported              |
   | management | True   |                            |
   | power      | True   |                            |
   +------------+--------+----------------------------+

   NODE_UUID は、ノードの一意識別子に置き換えます。もしくは、ノードの論理名を使用します。上記のコマンドの出力には、各インターフェースが True または None のいずれかと報告されるはずです。None とマークされたインターフェースは、設定していないか、ドライバーがサポートしていないインターフェースです。

1. Identity に管理ユーザーとしてアクセスするためのシェルを設定します。

   # source ~stack/overcloudrc

2. Bare Metal Provisioning がベアメタルサーバーのクリーニングに使用するネットワークの UUID を特定します。

   # openstack network list

   neutron net-list の出力の id フィールドから UUID を選択します。

3. /etc/ironic/ironic.conf ファイルの cleaning_network_uuid をクリーニングネットワークの UUID に設定します。

   # openstack-config --set /etc/ironic/ironic.conf neutron cleaning_network_uuid CLEANING_NETWORK_UUID

   CLEANING_NETWORK_UUID は、以前のステップで取得したネットワークの id に置き換えます。

4. Bare Metal Provisioning サービスを再起動します。

   # systemctl restart openstack-ironic-conductor

手動クリーニングの設定

1. ベアメタルサーバーが管理可能な状態であることを確認します。

   # ironic node-set-provision-state NODE_ID manage

   NODE_ID はベアメタルサーバーの UUID またはノード名に置き換えます。

2. ベアメタルサーバーをクリーニングの状態に切り替えてクリーニングのステップを実行します。

   # ironic node-set-provision-state NODE_ID clean --clean-steps CLEAN_STEPS

   NODE_ID は、ベアメタルサーバーの UUID またはノード名に置き換えます。CLEAN_STEPS は JSON 形式のクリーニングステップまたはクリーニングステップが記載されたファイルへのパスに置き換えるか、標準入力から直接置き換えます。

    '[{"interface": "deploy", "step": "erase_devices"}]'

仮想ベアメタルノードの作成

1. libvirt ホストから仮想マシンマネージャーにアクセスします。

2. 以下の設定で仮想マシンを 2 つ作成します。

   • 1 x 仮想 CPU
   • 2048 MB のメモリー
   • ネットワークブート (PXE)
   • 20 GB のストレージ
   • ネットワークソース: ホストデバイス eth0: macvtap、ソースモード: Bridge。macvtap を選択すると、仮想マシンはホストのイーサネットネットワークインターフェースを共有します。このように設定すると、Bare Metal Provisioning ノードは仮想ノードに直接アクセスすることが可能となります。
3. 両仮想マシンをシャットダウンします。

SSH キーペアの作成

1. Bare Metal Provisioning ノードで、SSH キーを作成します。

   # ssh-keygen -t rsa -b 2048 -C "user@domain.com" -f ./virtkey

   user@domain.com は、このキーを特定するメールアドレスまたはその他のコメントに置き換えます。コマンドがパスフレーズの入力を要求したら、パスフレーズは入力せずに Enter を押して次に進みます。このコマンドにより、秘密鍵 (virtkey) と公開鍵 (virtkey.pub) の 2 つのファイルが作成されます。

2. 公開鍵の内容を libvirt ホストの root ユーザーの /root/.ssh/authorized_keys ファイルにコピーします。

   # ssh-copy-id -i virtkey root@LIBVIRT_HOST

   LIBVIRT_HOST は libvirt ホストの IP アドレスまたはホスト名に置き換えます。

仮想ノードをベアメタルノードとして追加する手順

1. Bare Metal Provisioning コンダクターサービスノードで、pxe_ssh ドライバーを有効にします。

   # openstack-config --set /etc/ironic/ironic.conf \
      DEFAULT enabled_drivers pxe_ssh

   pxe_ssh を既存のドライバーの一覧に追加する場合には、ファイルを開いて、enabled_drivers に記載されているリストにドライバーをコンマ区切りで追加します。

2. Identity を管理ユーザーとして使用するためのシェルを設定します。

   # source ~/keystonerc_admin

3. 最初のノードを追加して、libvirt ホストの SSH 情報を登録します。

   # ironic node-create -d pxe_ssh -n Node1 \
      -i ssh_virt_type=virsh \
      -i ssh_username=root \
      -i ssh_key_filename=VIRTKEY_FILE_PATH \
      -i ssh_address=LIBVIRT_HOST_IP \
      -i deploy_kernel=KERNEL_UUID \
      -i deploy_ramdisk=INITRAMFS_UUID

   以下の値を置き換えてください。

   • VIRTKEY_FILE_PATH は virtkey SSH 秘密鍵ファイルの絶対パスに置き換えます。
   • LIBVIRT_HOST_IP は、libvirt ホストの IP アドレスまたはホスト名に置き換えます。
   • KERNEL_UUID は、Image サービスにアップロードされた .kernel イメージの一意識別子に置き換えます。
   • INITRAMFS_UUID は、Image サービスにアップロードされた .initramfs イメージの一意識別子に置き換えます。
4. 上記と同じコマンドで、 Node1 を Node2 に置き換えて実行し、2 番目のノードを追加します。

5. ノードを設定して、初回のデプロイの後には、PXE や仮想メディアの代わりに、そのノードのディスクにインストールされたローカルのブートローダーからリブートするようにします。ノードのプロビジョニングに使用するフレーバーでも、ローカルブートの機能を設定しておく必要があります。ローカルブートを有効にするには、ノードのデプロイに使用するイメージに grub2 が含まれる必要があります。ローカルブートを以下のように設定します。

   # ironic node-update Node1 add \
      properties/capabilities="boot_option:local"
   # ironic node-update Node2 add \
      properties/capabilities="boot_option:local"

6. ノードを管理可能な状態に切り替えます。

   # ironic node-set-provision-state Node1 manage
   # ironic node-set-provision-state Node2 manage

7. ノードに対する検査を開始します。

   # ironic node-set-provision-state Node1 inspect
   # ironic node-set-provision-state Node2 inspect

   ノードをプロビジョニングする前に、ノードの検出および検査プロセスは完了するまで実行する必要があります。ノードの検査のステータスを確認するには、ironic node-list を実行して Provision State の箇所を探します。検査が正常に完了すると、ノードは available の状態になります。

8. ノードの設定を検証します。

   # ironic node-validate Node1
   # ironic node-validate Node2
   +------------+--------+----------------------------+
   | Interface  | Result | Reason                     |
   +------------+--------+----------------------------+
   | console    | None   | not supported              |
   | deploy     | True   |                            |
   | inspect    | True   |                            |
   | management | True   |                            |
   | power      | True   |                            |
   +------------+--------+----------------------------+

   上記のコマンドの出力には、各インターフェースが True または None と報告されるはずです。None とマークされたインターフェースは、設定していないか、ドライバーがサポートしていないインターフェースです。

9. ノードの追加が正常に完了したら、「3章ベアメタルインスタンスの起動」の手順に従って 2 つのノードを起動します。