Add prefix "$" for command examples
This commits adds "$" as a prefix for command examples. Change-Id: I372cee5305acc26115ff4ffca58aaa2283a3a033
This commit is contained in:
parent
2a36c060bf
commit
f11ad708fb
22
README.rst
22
README.rst
@ -40,34 +40,34 @@ the ``--os-tenant-name``, ``--os-username``, ``--os-password`` and
|
||||
``--os-auth-url`` parameters, though it may be easier to set them
|
||||
as environment variables::
|
||||
|
||||
export OS_TENANT_NAME=project
|
||||
export OS_USERNAME=user
|
||||
export OS_PASSWORD=pass
|
||||
export OS_AUTH_URL=http://auth.example.com:5000/v2.0
|
||||
$ export OS_TENANT_NAME=project
|
||||
$ export OS_USERNAME=user
|
||||
$ export OS_PASSWORD=pass
|
||||
$ export OS_AUTH_URL=http://auth.example.com:5000/v2.0
|
||||
|
||||
To use a specific Ironic API endpoint::
|
||||
|
||||
export IRONIC_URL=http://ironic.example.com:6385
|
||||
$ export IRONIC_URL=http://ironic.example.com:6385
|
||||
|
||||
An example of how to create a basic node with the pxe_ipmitool driver::
|
||||
|
||||
ironic node-create -d pxe_ipmitool
|
||||
$ ironic node-create -d pxe_ipmitool
|
||||
|
||||
An example of creating a port on a node::
|
||||
|
||||
ironic port-create -a AA:BB:CC:DD:EE:FF -n nodeUUID
|
||||
$ ironic port-create -a AA:BB:CC:DD:EE:FF -n nodeUUID
|
||||
|
||||
An example of updating driver properties for a node::
|
||||
|
||||
ironic node-update nodeUUID add driver_info/ipmi_address=<IPaddress>
|
||||
ironic node-update nodeUUID add driver_info/ipmi_username=<username>
|
||||
ironic node-update nodeUUID add driver_info/ipmi_password=<password>
|
||||
$ ironic node-update nodeUUID add driver_info/ipmi_address=<IPaddress>
|
||||
$ ironic node-update nodeUUID add driver_info/ipmi_username=<username>
|
||||
$ ironic node-update nodeUUID add driver_info/ipmi_password=<password>
|
||||
|
||||
|
||||
For more information about the ``ironic`` command and the subcommands
|
||||
available, run::
|
||||
|
||||
ironic help
|
||||
$ ironic help
|
||||
|
||||
* License: Apache License, Version 2.0
|
||||
* Documentation: http://docs.openstack.org/developer/python-ironicclient
|
||||
|
@ -28,11 +28,11 @@ configuration options :option:`--os-username`, :option:`--os-password`,
|
||||
and :option:`--os-auth-url`, or set the corresponding
|
||||
environment variables::
|
||||
|
||||
export OS_USERNAME=user
|
||||
export OS_PASSWORD=password
|
||||
export OS_TENANT_ID=b363706f891f48019483f8bd6503c54b # or OS_TENANT_NAME
|
||||
export OS_TENANT_NAME=project # or OS_TENANT_ID
|
||||
export OS_AUTH_URL=http://auth.example.com:5000/v2.0
|
||||
$ export OS_USERNAME=user
|
||||
$ export OS_PASSWORD=password
|
||||
$ export OS_TENANT_ID=b363706f891f48019483f8bd6503c54b # or OS_TENANT_NAME
|
||||
$ export OS_TENANT_NAME=project # or OS_TENANT_ID
|
||||
$ export OS_AUTH_URL=http://auth.example.com:5000/v2.0
|
||||
|
||||
The command-line tool will attempt to reauthenticate using the provided
|
||||
credentials for every request. You can override this behavior by manually
|
||||
@ -40,8 +40,8 @@ supplying an auth token using :option:`--ironic-url` and
|
||||
:option:`--os-auth-token`, or by setting the corresponding environment
|
||||
variables::
|
||||
|
||||
export IRONIC_URL=http://ironic.example.org:6385/
|
||||
export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155
|
||||
$ export IRONIC_URL=http://ironic.example.org:6385/
|
||||
$ export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155
|
||||
|
||||
Since Keystone can return multiple regions in the Service Catalog, you can
|
||||
specify the one you want with :option:`--os-region-name` or set the following
|
||||
@ -56,7 +56,7 @@ fill partially typed commands. To use this feature, source the below file
|
||||
https://git.openstack.org/cgit/openstack/python-ironicclient/tree/tools/ironic.bash_completion)
|
||||
to your terminal and then bash completion should work::
|
||||
|
||||
source ironic.bash_completion
|
||||
$ source ironic.bash_completion
|
||||
|
||||
To avoid doing this every time, add this to your ``.bashrc`` or copy the
|
||||
ironic.bash_completion file to the default bash completion scripts directory
|
||||
@ -67,11 +67,11 @@ OPTIONS
|
||||
|
||||
To get a list of available (sub)commands and options, run::
|
||||
|
||||
ironic help
|
||||
$ ironic help
|
||||
|
||||
To get usage and options of a command, run::
|
||||
|
||||
ironic help <command>
|
||||
$ ironic help <command>
|
||||
|
||||
|
||||
EXAMPLES
|
||||
@ -79,16 +79,16 @@ EXAMPLES
|
||||
|
||||
Get information about the node-create command::
|
||||
|
||||
ironic help node-create
|
||||
$ ironic help node-create
|
||||
|
||||
Get a list of available drivers::
|
||||
|
||||
ironic driver-list
|
||||
$ ironic driver-list
|
||||
|
||||
Enroll a node with "fake" deploy driver and "ipmitool" power driver::
|
||||
|
||||
ironic node-create -d fake_ipmitool -i ipmi_address=1.2.3.4
|
||||
$ ironic node-create -d fake_ipmitool -i ipmi_address=1.2.3.4
|
||||
|
||||
Get a list of nodes::
|
||||
|
||||
ironic node-list
|
||||
$ ironic node-list
|
||||
|
@ -10,7 +10,7 @@ Python Guideline Enforcement
|
||||
All code has to pass the pep8 style guideline to merge into OpenStack, to
|
||||
validate the code against these guidelines you can run::
|
||||
|
||||
tox -e pep8
|
||||
$ tox -e pep8
|
||||
|
||||
Unit Testing
|
||||
............
|
||||
@ -19,12 +19,12 @@ It is strongly encouraged to run the unit tests locally under one or more
|
||||
test environments prior to submitting a patch. To run all the recommended
|
||||
environments sequentially and pep8 style guideline run::
|
||||
|
||||
tox
|
||||
$ tox
|
||||
|
||||
You can also selectively pick specific test environments by listing your
|
||||
chosen environments after a -e flag::
|
||||
|
||||
tox -e py27,py33,py34,pep8
|
||||
$ tox -e py27,py33,py34,pep8
|
||||
|
||||
.. note::
|
||||
Tox sets up virtual environment and installs all necessary dependencies.
|
||||
@ -44,7 +44,7 @@ cloud installation along with admin credentials. The test.conf file lives in
|
||||
ironicclient/tests/functional/ directory. To run functional tests in that way
|
||||
create test.conf manually and run::
|
||||
|
||||
tox -e functional
|
||||
$ tox -e functional
|
||||
|
||||
An example test.conf file::
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user