020778ddd9
Not only were the docs and release info here not being maintainted properly, but the examples that were given were not correct. This change is an attempt to set us on the right path going forward and includes info on how to import the API and history info for the upcoming release/push to PyPi. Fixes bug: 1156994 Change-Id: I169b1c01380ef653a6a25eb8946b9a06d6419e62
50 lines
1.4 KiB
ReStructuredText
50 lines
1.4 KiB
ReStructuredText
The :program:`cinder` shell utility
|
|
=========================================
|
|
|
|
.. program:: cinder
|
|
.. highlight:: bash
|
|
|
|
The :program:`cinder` shell utility interacts with the OpenStack Cinder API
|
|
from the command line. It supports the entirety of the OpenStack Cinder API.
|
|
|
|
You'll need to provide :program:`cinder` with your OpenStack username and
|
|
API key. You can do this with the :option:`--os-username`, :option:`--os-password`
|
|
and :option:`--os-tenant-name` options, but it's easier to just set them as
|
|
environment variables by setting two environment variables:
|
|
|
|
.. envvar:: OS_USERNAME or CINDER_USERNAME
|
|
|
|
Your OpenStack Cinder username.
|
|
|
|
.. envvar:: OS_PASSWORD or CINDER_PASSWORD
|
|
|
|
Your password.
|
|
|
|
.. envvar:: OS_TENANT_NAME or CINDER_PROJECT_ID
|
|
|
|
Project for work.
|
|
|
|
.. envvar:: OS_AUTH_URL or CINDER_URL
|
|
|
|
The OpenStack API server URL.
|
|
|
|
.. envvar:: OS_VOLUME_API_VERSION
|
|
|
|
The OpenStack Block Storage API version.
|
|
|
|
For example, in Bash you'd use::
|
|
|
|
export OS_USERNAME=yourname
|
|
export OS_PASSWORD=yadayadayada
|
|
export OS_TENANT_NAME=myproject
|
|
export OS_AUTH_URL=http://...
|
|
export OS_VOLUME_API_VERSION=1
|
|
|
|
From there, all shell commands take the form::
|
|
|
|
cinder <command> [arguments...]
|
|
|
|
Run :program:`cinder help` to get a full list of all possible commands,
|
|
and run :program:`cinder help <command>` to get detailed help for that
|
|
command.
|