4bca243c86
No updates on distro packages yet. This deserves more automation with templates in the future, but get this in for now. Change-Id: I2cac95b57febe067e956be9d14808d1209b42495
148 lines
5.4 KiB
ReStructuredText
148 lines
5.4 KiB
ReStructuredText
.. _launch-instance-cinder:
|
|
|
|
Block Storage
|
|
~~~~~~~~~~~~~
|
|
|
|
Create a volume
|
|
---------------
|
|
|
|
#. Source the ``demo`` credentials to perform
|
|
the following steps as a non-administrative project:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . demo-openrc
|
|
|
|
.. end
|
|
|
|
#. Create a 1 GB volume:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --size 1 volume1
|
|
|
|
+---------------------+--------------------------------------+
|
|
| Field | Value |
|
|
+---------------------+--------------------------------------+
|
|
| attachments | [] |
|
|
| availability_zone | nova |
|
|
| bootable | false |
|
|
| consistencygroup_id | None |
|
|
| created_at | 2016-03-08T14:30:48.391027 |
|
|
| description | None |
|
|
| encrypted | False |
|
|
| id | a1e8be72-a395-4a6f-8e07-856a57c39524 |
|
|
| multiattach | False |
|
|
| name | volume1 |
|
|
| properties | |
|
|
| replication_status | disabled |
|
|
| size | 1 |
|
|
| snapshot_id | None |
|
|
| source_volid | None |
|
|
| status | creating |
|
|
| type | None |
|
|
| updated_at | None |
|
|
| user_id | 684286a9079845359882afc3aa5011fb |
|
|
+---------------------+--------------------------------------+
|
|
|
|
.. end
|
|
|
|
#. After a short time, the volume status should change from ``creating``
|
|
to ``available``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume list
|
|
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
| ID | Display Name | Status | Size | Attached to |
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
| a1e8be72-a395-4a6f-8e07-856a57c39524 | volume1 | available | 1 | |
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
|
|
.. end
|
|
|
|
Attach the volume to an instance
|
|
--------------------------------
|
|
|
|
#. Attach a volume to an instance:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server add volume INSTANCE_NAME VOLUME_NAME
|
|
|
|
.. end
|
|
|
|
Replace ``INSTANCE_NAME`` with the name of the instance and ``VOLUME_NAME``
|
|
with the name of the volume you want to attach to it.
|
|
|
|
**Example**
|
|
|
|
Attach the ``volume1`` volume to the ``provider-instance`` instance:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server add volume provider-instance volume1
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
#. List volumes:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume list
|
|
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
| ID | Display Name | Status | Size | Attached to |
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
| a1e8be72-a395-4a6f-8e07-856a57c39524 | volume1 | in-use | 1 | Attached to provider-instance on /dev/vdb |
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
|
|
.. end
|
|
|
|
#. Access your instance using SSH and use the ``fdisk`` command to verify
|
|
presence of the volume as the ``/dev/vdb`` block storage device:
|
|
|
|
.. code-block:: console
|
|
|
|
$ sudo fdisk -l
|
|
|
|
Disk /dev/vda: 1073 MB, 1073741824 bytes
|
|
255 heads, 63 sectors/track, 130 cylinders, total 2097152 sectors
|
|
Units = sectors of 1 * 512 = 512 bytes
|
|
Sector size (logical/physical): 512 bytes / 512 bytes
|
|
I/O size (minimum/optimal): 512 bytes / 512 bytes
|
|
Disk identifier: 0x00000000
|
|
|
|
Device Boot Start End Blocks Id System
|
|
/dev/vda1 * 16065 2088449 1036192+ 83 Linux
|
|
|
|
Disk /dev/vdb: 1073 MB, 1073741824 bytes
|
|
16 heads, 63 sectors/track, 2080 cylinders, total 2097152 sectors
|
|
Units = sectors of 1 * 512 = 512 bytes
|
|
Sector size (logical/physical): 512 bytes / 512 bytes
|
|
I/O size (minimum/optimal): 512 bytes / 512 bytes
|
|
Disk identifier: 0x00000000
|
|
|
|
Disk /dev/vdb doesn't contain a valid partition table
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
You must create a file system on the device and mount it
|
|
to use the volume.
|
|
|
|
For more information about how to manage volumes, see the
|
|
`python-openstackclient documentation for Pike <https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html>`_,
|
|
the
|
|
`python-openstackclient documentation for Queens <https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/volume.html>`_,
|
|
or the
|
|
`python-openstackclient documentation for Rocky <https://docs.openstack.org/python-openstackclient/rocky/cli/command-objects/volume.html>`_.
|
|
|
|
Return to :ref:`launch-instance`.
|