インスタンスの作成と管理

手順

1. インスタンスが要求するハードウェアプロファイルを持つフレーバーの名前または ID を取得します。

   $ openstack flavor list

   注記

   イメージが正常に起動するのに十分なサイズを持つフレーバーを選択します。そうでないと、インスタンスの起動に失敗します。

2. インスタンスが要求するソフトウェアプロファイルを持つイメージの名前または ID を取得します。

   $ openstack image list

   必要なイメージが利用できない場合は、新しいイメージをダウンロードまたは作成できます。クラウドイメージの作成またはダウンロードの方法は、Image service を参照してください。

   注記

   26 を超えるボリュームをインスタンスにアタッチする必要がある場合は、インスタンスの作成に使用するイメージに以下のプロパティーが必要です。

   • hw_scsi_model=virtio-scsi
   • hw_disk_bus=scsi

3. インスタンスを接続するネットワークの名前または ID を取得します。

   $ openstack network list

4. インスタンスを作成します。

   $ openstack server create --flavor <flavor> \
     --image <image> --network <network> \
     --wait myInstanceFromImage

   • <flavor> を、ステップ 1 で取得したフレーバーの名前または ID に置き換えてください。
   • <image> を、ステップ 2 で取得したイメージの名前または ID に置き換えてください。
   • <network> を、ステップ 3 で取得したネットワークの名前または ID に置き換えてください。必要に応じて、--network オプションを複数回使用して、インスタンスを複数のネットワークに接続することができます。

手順

1. インスタンスが要求するソフトウェアプロファイルを持つイメージの名前または ID を取得します。

   $ openstack image list

   必要なイメージが利用できない場合は、新しいイメージをダウンロードまたは作成できます。クラウドイメージの作成またはダウンロードの方法は、Image service を参照してください。

   注記

   26 を超えるボリュームをインスタンスにアタッチする必要がある場合は、インスタンスの作成に使用するイメージに以下のプロパティーが必要です。

   • hw_scsi_model=virtio-scsi
   • hw_disk_bus=scsi

2. イメージからブート可能なボリュームを作成します。

   $ openstack volume create --image <image> \
   --size <size_gb> --bootable myBootableVolume

   • <image> を、ステップ 1 で取得したボリュームに書き込むイメージの名前または ID に置き換えてください。
   • <size_gb> をボリュームのサイズ (GB 単位) に置き換えます。

3. インスタンスが要求するハードウェアプロファイルを持つフレーバーの名前または ID を取得します。

   $ openstack flavor list

4. インスタンスを接続するネットワークの名前または ID を取得します。

   $ openstack network list

5. ブート可能なボリュームでインスタンスを作成します。

   $ openstack server create --flavor <flavor> \
    --volume myBootableVolume --network <network> \
    --wait myInstanceFromVolume

   • <flavor> を、ステップ 3 で取得したフレーバーの名前または ID に置き換えてください。
   • <network> を、ステップ 4 で取得したネットワークの名前または ID に置き換えてください。必要に応じて、--network オプションを複数回使用して、インスタンスを複数のネットワークに接続することができます。

手順

1. インスタンスが要求するハードウェアプロファイルを持つフレーバーの名前または ID を取得します。

   $ openstack flavor list

   注記

   イメージが正常に起動するのに十分なサイズを持つフレーバーを選択します。そうでないと、インスタンスの起動に失敗します。

   ヒント

   必要なポリシーを持つフレーバーを選択して、PCI パススルーデバイスおよび SR-IOV インターフェイス用にインスタンスに適用される NUMA アフィニティーポリシーを指定することができます。利用可能なポリシーについての詳しい情報は、Flavor metadata のInstance PCI NUMA affinity policyを参照してください。NUMA アフィニティーポリシーが指定されたフレーバーを選択する場合には、使用するイメージには同じ NUMA アフィニティーポリシーが設定されているか、NUMA アフィニティーポリシーが設定されていない必要があります。

2. インスタンスが要求するソフトウェアプロファイルを持つイメージの名前または ID を取得します。

   $ openstack image list

   必要なイメージが利用できない場合は、新しいイメージをダウンロードまたは作成できます。クラウドイメージの作成またはダウンロードの方法は、Image service を参照してください。

   ヒント

   必要なポリシーを持つイメージを選択して、PCI パススルーデバイスおよび SR-IOV インターフェイス用にインスタンスに適用される NUMA アフィニティーポリシーを指定することができます。利用可能なポリシーについての詳しい情報は、Flavor metadata のInstance PCI NUMA affinity policyを参照してください。NUMA アフィニティーポリシーが指定されたイメージを選択する場合には、使用するフレーバーには同じ NUMA アフィニティーポリシーが設定されているか、NUMA アフィニティーポリシーが設定されていない必要があります。

3. インスタンスを接続するネットワークの名前または ID を取得します。

   $ openstack network list

4. SR-IOV インターフェイスに必要なポート種別を作成します。

   $ openstack port create --network <network> \
    --vnic-type <vnic_type> mySriovPort

   • <network> を、ステップ 3 で取得したネットワークの名前または ID に置き換えてください。

   • <vnic_type> を以下の値のいずれかに置き換えます。

     • direct: ダイレクトモードの SR-IOV Virtual Function (VF) ポートを作成します。
     • direct-physical: ダイレクトモードの SR-IOV Physical Function (PF) ポートを作成します。
     • macvtap: MacVTap を使用して virtio インターフェイスをインスタンスに公開する間接モードの SR-IOV VF ポートを作成します。

5. インスタンスを作成します。

   $ openstack server create --flavor <flavor> \
     --image <image> --port <port> \
     --wait mySriovInstance

   • <flavor> を、ステップ 1 で取得したフレーバーの名前または ID に置き換えてください。
   • <image> を、ステップ 2 で取得したイメージの名前または ID に置き換えてください。
   • <port> を、ステップ 4 で作成したポートの名前または ID に置き換えてください。

手順

1. 利用可能なネットワークを特定し、インスタンスに接続するネットワークの名前または ID をメモします。

   (overcloud)$ openstack network list

   必要なネットワークが利用できない場合は、新規ネットワークを作成します。

   (overcloud)$ openstack network create <network>

2. インスタンスにネットワークを接続します。

   $ openstack server add network <instance> <network>

   • <instance> を、ネットワークを接続するインスタンスの名前または ID に置き換えてください。
   • <network> をインスタンスに接続するネットワークの名前または ID に置き換えてください。

手順

1. インスタンスに接続されているネットワークを特定します。

   (overcloud)$ openstack server show <instance>

2. インスタンスからネットワークを切断します。

   $ openstack server remove network <instance> <network>

   • <instance> を、ネットワークを削除するインスタンスの名前または ID に置き換えてください。
   • <network> をインスタンスから削除するネットワークの名前または ID に置き換えてください。

手順

1. 利用可能なポートを特定し、インスタンスに接続するポートの名前または ID をメモします。

   (overcloud)$ openstack port list

   必要なポートが利用できない場合は、新規ポートを作成します。

   (overcloud)$ openstack port create --network <network> <port>

   • <network> を、ポートを作成するネットワークの名前または ID に置き換えてください。
   • <port> を、インスタンスに接続するポートの名前または ID に置き換えてください。

2. インスタンスにポートを接続します。

   $ openstack server add port <instance> <port>

   • <instance> を、ポートを接続するインスタンスの名前または ID に置き換えてください。
   • <port> を、インスタンスに接続するポートの名前または ID に置き換えてください。

手順

1. インスタンスに接続されているポートを特定します。

   (overcloud)$ openstack server show <instance>

2. インスタンスからポートを切断します。

   $ openstack server remove port <instance> <port>

   • <instance> を、ポートを削除するインスタンスの名前または ID に置き換えてください。
   • <port> をインスタンスから削除するポートの名前または ID に置き換えてください。

手順

1. 利用可能なボリュームを特定し、インスタンスに接続するボリュームの名前または ID をメモします。

   (overcloud)$ openstack volume list

2. インスタンスにボリュームを接続します。

   $ openstack server add volume <instance> <volume>

   • <instance> を、ボリュームを接続するインスタンスの名前または ID に置き換えてください。

   • <volume> を、インスタンスに接続するボリュームの名前または ID に置き換えてください。

     注記

     コマンドが次のエラーを返した場合、インスタンスにアタッチするために選択したボリュームはマルチアタッチであるため、Compute API バージョン 2.60 以降を使用する必要があります。

     Multiattach volumes are only supported starting with compute API version 2.60. (HTTP 400) (Request-ID: req-3a969c31-e360-4c79-a403-75cc6053c9e5)

     インスタンスにボリュームを追加するときに、環境変数 OS_COMPUTE_API_VERSION=2.72 を設定するか、--os-compute-api-version 引数を含めることができます。

     $ openstack --os-compute-api-version 2.72 server add volume <instance> <volume>

   ヒント

   --os-compute-api-version 2.20 以降を指定して、ステータスが SHELVED または SHELVED_OFFLOADED のインスタンスにボリュームを追加します。

3. ボリュームがインスタンスにアタッチされていることを確認します。

   $ openstack volume show <volume>

   <volume> は、表示するボリュームの名前または ID に置き換えます。

   出力例:

   +-----------------------------------------------------+----------------------+---------+-----+-----------------------------------------------------------------------------------------------+
   | ID                                                             | Name                | Status | Size| Attached to
   +-----------------------------------------------------+---------------------+---------+------+---------------------------------------------------------------------------------------------+
   | f3fb92f6-c77b-429f-871d-65b1e3afa750 | volMultiattach | in-use |   50 | Attached to instance1 on /dev/vdb Attached to instance2 on /dev/vdb  |
   +-----------------------------------------------------+----------------------+---------+-----+-----------------------------------------------------------------------------------------------+

手順

1. インスタンスに接続されているボリュームを特定します。

   (overcloud)$ openstack server show <instance>

2. インスタンスからボリュームを切断します。

   $ openstack server remove volume <instance> <volume>

   • <instance> を、ボリュームを削除するインスタンスの名前または ID に置き換えてください。

   • <volume> をインスタンスから削除するボリュームの名前または ID に置き換えてください。

     注記

     --os-compute-api-version 2.20 以降を指定して、ステータスが SHELVED または SHELVED_OFFLOADED のインスタンスからボリュームを削除します。

手順

1. 現在のプロジェクトに確保されている Floating IP アドレスを確認します。

   $ openstack floating ip list

   使用できる Floating IP アドレスがない場合は、外部ネットワークの割り当てプールから Floating IP アドレスを現在のプロジェクトに確保します。

   $ openstack floating ip create <provider-network>

   <provider-network> を、外部アクセスを提供するのに使用する外部ネットワークの名前または ID に置き換えてください。

   ヒント

   デフォルトでは、Floating IP アドレスは外部ネットワークのプールから無作為に確保されます。クラウド管理者は、--floating-ip-address オプションを使用して、外部ネットワークから特定の Floating IP アドレスを確保することができます。

2. インスタンスに Floating IP アドレスを割り当てます。

   $ openstack server add floating ip [--fixed-ip-address <ip_address>] \
    <instance> <floating_ip>

   • <instance> をパブリックアクセスを提供するインスタンスの名前または ID に置き換えてください。
   • <floating_ip> を、インスタンスに割り当てる Floating IP アドレスに置き換えてください。
   • (オプション) <ip_address> を、Floating IP を割り当てるインターフェイスの IP アドレスに置き換えます。デフォルトでは、Floating IP アドレスは最初のポートに割り当てられます。

3. Floating IP アドレスがインスタンスに割り当てられていることを確認します。

   $ openstack server show <instance>

手順

1. インスタンスへの Floating IP アドレスの割り当てを解除します。

   $ openstack server remove floating ip <instance> <ip_address>

   • <instance> を、パブリックアクセスを削除するインスタンスの名前または ID に置き換えてください。
   • <floating_ip> をインスタンスに割り当てられた Floating IP アドレスに置き換えてください。

2. 割り当てプールに Floating IP アドレスを解放します。

   $ openstack floating ip delete <ip_address>

3. Floating IP アドレスが削除され、割り当てに利用できないことを確認します。

   $ openstack floating ip list

手順

1. インスタンスが要求するハードウェアプロファイルを持つフレーバーの名前または ID を取得します。

   $ openstack flavor list

   注記

   イメージが正常に起動するのに十分なサイズを持つフレーバーを選択します。そうでないと、インスタンスの起動に失敗します。

2. インスタンスが要求するソフトウェアプロファイルを持つイメージの名前または ID を取得します。

   $ openstack image list

   必要なイメージが利用できない場合は、新しいイメージをダウンロードまたは作成できます。クラウドイメージの作成またはダウンロードの情報は、Image service を参照してください。

3. インスタンスを接続するネットワークの名前または ID を取得します。

   $ openstack network list

4. インスタンスにリモートでアクセスするために使用するキーペアの名前を取得します。

   $ openstack keypair list

5. SSH アクセスを設定してインスタンスを作成します。

   $ openstack server create --flavor <flavor> \
     --image <image> --network <network> \
     [--security-group <secgroup>] \
     --key-name <keypair> --wait myInstancewithSSH

   • <flavor> を、ステップ 1 で取得したフレーバーの名前または ID に置き換えてください。
   • <image> を、ステップ 2 で取得したイメージの名前または ID に置き換えてください。
   • <network> を、ステップ 3 で取得したネットワークの名前または ID に置き換えてください。必要に応じて、--network オプションを複数回使用して、インスタンスを複数のネットワークに接続することができます。
   • (オプション) default セキュリティーグループは、代替のセキュリティーグループを指定しないインスタンスに適用されます。インスタンスの作成時に別のセキュリティーグループをインスタンスに直接適用することや、実行中のインスタンスのポートに適用することができます。インスタンスの作成時に別のセキュリティーグループを指定するには、--security-group オプションを使用します。実行中のインスタンスのポートにセキュリティーグループを追加する方法は、セキュリティーグループのポートへの追加 を参照してください。
   • <keypair> を、ステップ 4 で取得したキーペアの名前または ID に置き換えてください。

6. インスタンスに Floating IP アドレスを割り当てます。

   $ openstack server add floating ip myInstancewithSSH <floating_ip>

   <floating_ip> を、インスタンスに割り当てる Floating IP アドレスに置き換えてください。

7. 自動的に作成された cloud-user アカウントを使用して、SSH を使用してインスタンスにログインできることを確認します。

   $ ssh -i ~/.ssh/<keypair>.pem cloud-user@<floatingIP>
   [cloud-user@demo-server1 ~]$

手順

1. インスタンスの VNC コンソールの URL を表示するには、以下のコマンドを入力します。

   $ openstack console url show <vm_name>
   +-------+------------------------------------------------------+
   | Field | Value					     	        |
   +-------+------------------------------------------------------+
   | type  | novnc					               |
   | url	| http://172.25.250.50:6080/vnc_auto.html?token=       |
   |	| 962dfd71-f047-43d3-89a5-13cb88261eb9         	  |
   +-------+-------------------------------------------------------+

2. VNC コンソールに直接接続するには、ブラウザーに表示される URL を入力します。

手順

1. ログインするインスタンスの Floating IP アドレスを取得します。

   $ openstack server show <instance>

   <instance> を接続するインスタンスの名前または ID に置き換えてください。

2. 自動的に作成された cloud-user アカウントを使用して、インスタンスにログインします。

   $ ssh -i ~/.ssh/<keypair>.pem cloud-user@<floatingIP>
   [cloud-user@demo-server1 ~]$

   • <keypair> をキーペアの名前に置き換えます。

   • <floating_ip> をインスタンスの Floating IP アドレスに置き換えます。

     ヒント

     次のコマンドを使用して、Floating IP アドレスなしでインスタンスにログインすることができます。

     $ openstack server ssh --login cloud-user \
      --identity ~/.ssh/<keypair>.pem --private <instance>

     • <keypair> をキーペアの名前に置き換えます。
     • <instance> を接続するインスタンスの名前または ID に置き換えてください。

手順

1. サイズ変更するインスタンスの名前または ID を取得します。

   $ openstack server list

2. インスタンスのサイズ変更に使用するフレーバーの名前または ID を取得します。

   $ openstack flavor list

3. インスタンスのサイズを変更します。

   $ openstack server resize --flavor <flavor> \
     --wait <instance>

   • <flavor> を、ステップ 2 で取得したフレーバーの名前または ID に置き換えてください。
   • <instance> を、サイズを変更するインスタンスの名前または ID に置き換えてください。
   注記

   サイズ変更には時間がかかる場合があります。インスタンスの電源がオフになり、インスタンスのサイズが変更される前に、インスタンスのオペレーティングシステムは制御されたシャットダウンを実行します。この間、インスタンスのステータスは RESIZE になります。

   $ openstack server list
   +----------------------+----------------+--------+----------------------------+
   | ID                   | Name           | Status | Networks                                |
   +----------------------+----------------+--------+----------------------------+
   | 67bc9a9a-5928-47c... | myCirrosServer | RESIZE | admin_internal_net=192.168.111.139    |
   +----------------------+----------------+--------+----------------------------+

4. サイズ変更が完了すると、インスタンスのステータスが VERIFY_RESIZE に変わります。ここで、サイズ変更を確認するか、元に戻す必要があります。

   • サイズ変更を確認するには、以下のコマンドを実行します。

     $ openstack server resize confirm <instance>

   • サイズ変更を元に戻すには、以下のコマンドを入力します。

     $ openstack server resize revert <instance>

     インスタンスは元のフレーバーに戻され、ステータスは ACTIVE に変わります。

手順

1. スナップショットを作成するインスタンスの名前または ID を取得します。

   $ openstack server list

2. スナップショットを作成します。

   $ openstack server image create --name <image_name> <instance>

   • <image_name> を新規スナップショットイメージの名前に置き換えます。
   • <instance> を、スナップショットを作成するインスタンスの名前または ID に置き換えてください。

3. (オプション) インスタンスのスナップショットをテンプレートとして使用し、新規インスタンスを作成する際、ディスクの状態が維持されるようにするには、QEMU ゲストエージェントを有効にし、スナップショットイメージに以下のメタデータを追加して、スナップショット処理中にファイルシステムが休止状態になるようにします。

   $ openstack image set --property hw_qemu_guest_agent=yes \
    --property os_require_quiesce=yes <image_name>

   QEMU ゲストエージェントは、管理アプリケーションがインスタンスの OS レベルのコマンドを実行するのに役立つバックグラウンドプロセスです。このエージェントを有効にすると、別のデバイスがインスタンスに追加され、PCI スロットが使用され、インスタンスに割り当てることができるその他のデバイスの数が制限されます。また、これにより、Windows インスタンスでは、未知のハードウェアデバイスについての警告のメッセージが表示されます。

手順

1. インスタンスのレスキューを実行します。

   $ openstack server rescue [--image <image>] <instance>

   • (オプション) デフォルトでは、インスタンスはクラウド管理者が提供するレスキューイメージまたは元のインスタンスイメージの新規コピーから起動します。レスキューモードでインスタンスをリブートするときに使用する代替イメージを指定するには、--image オプションを使用します。
   • <instance> を、レスキューするインスタンスの名前または ID に置き換えてください。
2. レスキューされたインスタンスに接続して、問題を修正します。

3. 通常のブートディスクからインスタンスを再起動します。

   $ openstack server unrescue <instance>

手順

1. 復元するインスタンスの名前または ID を取得します。

   $ openstack server list

2. インスタンスを退避させます。

   $ openstack server shelve <instance> [<instance> ...]

   <instance> を、退避するインスタンスの名前または ID に置き換えてください。必要に応じて、複数のインスタンスを指定して退避できます。

3. インスタンスが退避されていることを確認します。

   $ openstack server list

   退避したインスタンスのステータスは SHELVED_OFFLOADED になります。

手順

1. cloud-init への指示が含まれるファイルを作成します。たとえば、インスタンス上に Web サーバーをインストールして有効にする bash スクリプトを作成します。

   $ vim /home/scripts/install_httpd
   #!/bin/bash
   
   yum -y install httpd python-psycopg2
   systemctl enable httpd --now

2. --user-data オプションを使用してインスタンスを起動し、bash スクリプトを渡します。

   $ openstack server create \
   --image rhel8 \
   --flavor default \
   --nic net-id=web-server-network \
   --security-group default \
   --key-name web-server-keypair \
   --user-data /home/scripts/install_httpd \
   --wait web-server-instance

3. インスタンスの状態がアクティブになったら、Floating IP アドレスを割り当てます。

   $ openstack floating ip create web-server-network
   $ openstack server add floating ip web-server-instance 172.25.250.123

4. SSH でインスタンスにログインします。

   $ ssh -i ~/.ssh/web-server-keypair cloud-user@172.25.250.123

5. カスタマイズが正常に実行されたことを確認します。たとえば、Web サーバーがインストールされ有効になっていることを確認するには、以下のコマンドを入力します。

   $ curl http://localhost | grep Test
   <title>Test Page for the Apache HTTP Server on Red Hat Enterprise Linux</title>
   <h1>Red Hat Enterprise Linux <strong>Test Page</strong></h1>

6. /var/log/cloud-init.log が実行したかどうかなど、関連するメッセージの有無を cloud-init ファイルで確認します。

   $ sudo less /var/log/cloud-init.log
   ...output omitted...
   ...util.py[DEBUG]: Cloud-init v. 0.7.9 finished at Sat, 23 Jun 2018 02:26:02 +0000. Datasource DataSourceOpenStack [net,ver=2].  Up 21.25 seconds

手順

1. --property <key=value> オプションでインスタンスを起動します。たとえば、インスタンスを Web サーバーとして識別するには、以下の属性を設定します。

   $ openstack server create \
   --image rhel8 \
   --flavor default \
   --property role=webservers \
   --wait web-server-instance

2. (オプション) インスタンスの作成後に、さらにインスタンスに属性を追加します。以下に例を示します。

   $ openstack server set \
   --property region=emea \
   --wait web-server-instance

手順

1. コンフィグドライブを有効にし、コンフィグドライブで利用可能にするコンテンツが含まれるファイルを指定します。たとえば、以下のコマンドは config-drive-instance という名前の新規インスタンスを作成し、ファイル my-user-data.txt のコンテンツが含まれるコンフィグドライブをアタッチします。

   (overcloud)$ openstack server create --flavor m1.tiny \
     --config-drive true \
     --user-data ./my-user-data.txt \
     --image cirros config-drive-instance

   このコマンドにより、ボリュームラベルが config-2 のコンフィグドライブが作成され、インスタンスのブート時にアタッチされます。また、my-user-data.txt のコンテンツが、コンフィグドライブの openstack/{version}/ ディレクトリーにある user_data ファイルに追加されます。

2. インスタンスにログインします。

3. コンフィグドライブをマウントします。

   • インスタンスの OS が udev を使用する場合:

     # mkdir -p /mnt/config
     # mount /dev/disk/by-label/config-2 /mnt/config

   • インスタンスの OS が udev を使用しない場合は、まずコンフィグドライブに対応するブロックデバイスを特定する必要があります。

     # blkid -t LABEL="config-2" -odevice
     /dev/vdb
     # mkdir -p /mnt/config
     # mount /dev/vdb /mnt/config