openstack/cinder
Code Issues Proposed changes

Merge "docs: Migrate docs from cinderclient to OSC (part 1)"

Browse Source
This commit is contained in:
Zuul 2024-04-19 16:36:16 +00:00 committed by Gerrit Code Review
commit 7e9626404c
4 changed files with 102 additions and 142 deletions

2
doc/source/admin/volume-backups.rst

@ -158,7 +158,7 @@ Run this command to restore the state of a backup:
.. code-block:: console .. code-block:: console
$ cinder backup-reset-state [--state STATE] BACKUP_ID-1 BACKUP_ID-2 ... $ openstack volume backup set --state <state> BACKUP
Run this command to create a backup of a snapshot: Run this command to create a backup of a snapshot:

6
doc/source/admin/volume-multiattach.rst

@ -54,8 +54,8 @@ volume type the following way:
.. code-block:: console .. code-block:: console
$ cinder type-create multiattach $ openstack volume type create multiattach
$ cinder type-key multiattach set multiattach="<is> True" $ openstack volume type set --property multiattach="<is> True" multiattach
.. note:: .. note::
@ -69,7 +69,7 @@ this:
.. code-block:: console .. code-block:: console
$ cinder create <volume_size> --name <volume_name> --volume-type <volume_type_uuid> $ openstack volume create --size 10 --type multiattach my-volume
In addition, it is possible to retype a volume to be (or not to be) multiattach In addition, it is possible to retype a volume to be (or not to be) multiattach
capable. Currently however we only allow retyping a volume if its status is capable. Currently however we only allow retyping a volume if its status is

86
doc/source/cli/cli-cinder-quotas.rst

@ -88,69 +88,47 @@ Administrative users can view Block Storage service quotas.
.. code-block:: console .. code-block:: console
$ openstack quota show $PROJECT_ID $ openstack quota show --volume $PROJECT_ID
+-----------------------+-------+ +-----------------------+-------+
| Field | Value | | Resource | Limit |
+-----------------------+-------+ +-----------------------+-------+
| backup-gigabytes | 1000 |
| backups | 10 |
| cores | 20 |
| fixed-ips | -1 |
| floating-ips | 50 |
| gigabytes | 1000 |
| gigabytes_lvmdriver-1 | -1 |
| health_monitors | None |
| injected-file-size | 10240 |
| injected-files | 5 |
| injected-path-size | 255 |
| instances | 10 |
| key-pairs | 100 |
| l7_policies | None |
| listeners | None |
| load_balancers | None |
| location | None |
| name | None |
| networks | 10 |
| per-volume-gigabytes | -1 |
| pools | None |
| ports | 50 |
| project | None |
| project_id | None |
| properties | 128 |
| ram | 51200 |
| rbac_policies | 10 |
| routers | 10 |
| secgroup-rules | 100 |
| secgroups | 10 |
| server-group-members | 10 |
| server-groups | 10 |
| snapshots | 10 |
| snapshots_lvmdriver-1 | -1 |
| subnet_pools | -1 |
| subnets | 10 |
| volumes | 10 | | volumes | 10 |
| snapshots | 10 |
| gigabytes | 1000 |
| backups | 10 |
| volumes_lvmdriver-1 | -1 | | volumes_lvmdriver-1 | -1 |
| gigabytes_lvmdriver-1 | -1 |
| snapshots_lvmdriver-1 | -1 |
| volumes___DEFAULT__ | -1 |
| gigabytes___DEFAULT__ | -1 |
| snapshots___DEFAULT__ | -1 |
| groups | 10 |
| backup-gigabytes | 1000 |
| per-volume-gigabytes | -1 |
+-----------------------+-------+ +-----------------------+-------+
#. Show the current usage of a per-project quota: #. Show the current usage of a per-project quota:
.. code-block:: console .. code-block:: console
$ cinder quota-usage $PROJECT_ID $ openstack quota show --volume --usage $PROJECT_ID
+-----------------------+--------+----------+-------+ +-----------------------+-------+--------+----------+
| Type | In_use | Reserved | Limit | | Resource | Limit | In Use | Reserved |
+-----------------------+--------+----------+-------+ +-----------------------+-------+--------+----------+
| backup_gigabytes | 0 | 0 | 1000 | | volumes | 10 | 1 | 0 |
| backups | 0 | 0 | 10 | | snapshots | 10 | 0 | 0 |
| gigabytes | 0 | 0 | 1000 | | gigabytes | 1000 | 1 | 0 |
| gigabytes_lvmdriver-1 | 0 | 0 | -1 | | backups | 10 | 0 | 0 |
| per_volume_gigabytes | 0 | 0 | -1 | | volumes_lvmdriver-1 | -1 | 1 | 0 |
| snapshots | 0 | 0 | 10 | | gigabytes_lvmdriver-1 | -1 | 1 | 0 |
| snapshots_lvmdriver-1 | 0 | 0 | -1 | | snapshots_lvmdriver-1 | -1 | 0 | 0 |
| volumes | 0 | 0 | 10 | | volumes___DEFAULT__ | -1 | 0 | 0 |
| volumes_lvmdriver-1 | 0 | 0 | -1 | | gigabytes___DEFAULT__ | -1 | 0 | 0 |
+-----------------------+--------+----------+-------+ | snapshots___DEFAULT__ | -1 | 0 | 0 |
| groups | 10 | 0 | 0 |
| backup-gigabytes | 1000 | 0 | 0 |
| per-volume-gigabytes | -1 | 0 | 0 |
+-----------------------+-------+--------+----------+
Edit and update Block Storage service quotas Edit and update Block Storage service quotas
@ -245,4 +223,4 @@ service quotas.
.. code-block:: console .. code-block:: console
$ cinder quota-delete $PROJECT_ID $ openstack quota delete --volume $PROJECT_ID

40
doc/source/cli/cli-manage-volumes.rst

@ -27,13 +27,12 @@ This example creates a ``my-new-volume`` volume based on an image.
| 4b227119-68a1-4b28-8505-f94c6ea4c6dc | cirros-0.3.5-x86_64-uec-ramdisk | | 4b227119-68a1-4b28-8505-f94c6ea4c6dc | cirros-0.3.5-x86_64-uec-ramdisk |
+--------------------------------------+---------------------------------+ +--------------------------------------+---------------------------------+
#. List the availability zones, and note the ID of the availability zone in #. List the availability zones, and note the ID of the availability zone in
which you want to create your volume: which you want to create your volume:
.. code-block:: console .. code-block:: console
$ openstack availability zone list $ openstack availability zone list --volume
+-----------+-------------+ +-----------+-------------+
| Zone Name | Zone Status | | Zone Name | Zone Status |
+-----------+-------------+ +-----------+-------------+
@ -85,7 +84,6 @@ This example creates a ``my-new-volume`` volume based on an image.
| bab4b0e0-ce3d-4d57-bf57-3c51319f5202 | my-new-volume | available | 8 | | | bab4b0e0-ce3d-4d57-bf57-3c51319f5202 | my-new-volume | available | 8 | |
+--------------------------------------+---------------+-----------+------+-------------+ +--------------------------------------+---------------+-----------+------+-------------+
If your volume was created successfully, its status is ``available``. If If your volume was created successfully, its status is ``available``. If
its status is ``error``, you might have exceeded your quota. its status is ``error``, you might have exceeded your quota.
@ -101,7 +99,6 @@ volume creation.
#. cinder_img_volume_type (via glance image metadata) #. cinder_img_volume_type (via glance image metadata)
#. default volume type (via project defaults or cinder.conf) #. default volume type (via project defaults or cinder.conf)
volume-type volume-type
^^^^^^^^^^^ ^^^^^^^^^^^
@ -109,17 +106,7 @@ User can specify `volume type` when creating a volume.
.. code-block:: console .. code-block:: console
$ openstack volume create -h -f {json,shell,table,value,yaml} $ openstack volume create --type <volume-type> ...
-c COLUMN --max-width <integer>
--noindent --prefix PREFIX --size <size>
--type <volume-type> --image <image>
--snapshot <snapshot> --source <volume>
--description <description> --user <user>
--project <project>
--availability-zone <availability-zone>
--property <key=value>
<name>
cinder_img_volume_type cinder_img_volume_type
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
@ -133,17 +120,13 @@ a volume from the image.
.. code-block:: console .. code-block:: console
$ openstack image list $ openstack image list
+----------------------------------+---------------------------------+--------+ +--------------------------------------+---------------------------------+--------+
| ID | Name | Status | | ID | Name | Status |
+----------------------------------+---------------------------------+--------+ +--------------------------------------+---------------------------------+--------+
| 376bd633-c9c9-4c5d-a588-342f4f66 | cirros-0.3.5-x86_64-uec | active | | 376bd633-c9c9-4c5d-a588-342f4f66d086 | cirros-0.3.5-x86_64-uec | active |
| d086 | | | | 2c20fce7-2e68-45ee-ba8d-beba27a91ab5 | cirros-0.3.5-x86_64-uec-ramdisk | active |
| 2c20fce7-2e68-45ee-ba8d- | cirros-0.3.5-x86_64-uec-ramdisk | active | | a5752de4-9faf-4c47-acbc-78a5efa7cc6e | cirros-0.3.5-x86_64-uec-kernel | active |
| beba27a91ab5 | | | +--------------------------------------+---------------------------------+--------+
| a5752de4-9faf-4c47-acbc- | cirros-0.3.5-x86_64-uec-kernel | active |
| 78a5efa7cc6e | | |
+----------------------------------+---------------------------------+--------+
$ openstack image show 376bd633-c9c9-4c5d-a588-342f4f66d086 $ openstack image show 376bd633-c9c9-4c5d-a588-342f4f66d086
+------------------------+------------------------------------------------------+ +------------------------+------------------------------------------------------+
@ -209,9 +192,9 @@ default_volume_type) can be checked with the following command:
.. code-block:: console .. code-block:: console
$ cinder type-default $ openstack volume type list --default
There are 2 ways to set the default volume type: There are two ways to set the default volume type:
1) Project specific defaults 1) Project specific defaults
2) default_volume_type defined in cinder.conf 2) default_volume_type defined in cinder.conf
@ -232,14 +215,13 @@ configured in cinder.conf is used to create volumes.
Example cinder.conf file configuration. Example cinder.conf file configuration.
.. code-block:: console .. code-block:: ini
[default] [default]
default_volume_type = lvmdriver-1 default_volume_type = lvmdriver-1
.. _Attach_a_volume_to_an_instance: .. _Attach_a_volume_to_an_instance:
Attach a volume to an instance Attach a volume to an instance
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~