7.5. インスタンスへのボリュームの接続

永続ストレージ用にインスタンスにボリュームを接続することができます。ボリュームがマルチ接続ボリュームとして設定されていない限り、ボリュームは一度に 1 つのインスタンスにしか接続することができません。マルチ接続可能なボリュームを作成する方法は、Attach a volume to multiple instances を参照してください。

前提条件

  • マルチアタッチボリュームをアタッチするために、環境変数 OS_COMPUTE_API_VERSION を 2.60 以降に設定する。

手順

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