1aaea83b02
New Sahara CLI as OpenStackClient plugin usage overview added and few warnings during docs generation fixed Partially implements: blueprint cli-as-openstackclient-plugin Change-Id: If5b4608429d994c642237d6a73ebd9e1bd985fc5 Closes-bug: #1512690
62 lines
1.5 KiB
ReStructuredText
62 lines
1.5 KiB
ReStructuredText
Sahara CLI
|
|
==========
|
|
|
|
The Sahara shell utility now is part of the OpenStackClient, so all
|
|
shell commands take the following form:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ openstack dataprocessing <command> [arguments...]
|
|
|
|
To get a list of all possible commands you can run:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ openstack help dataprocessing
|
|
|
|
To get detailed help for the command you can run:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ openstack help dataprocessing <command>
|
|
|
|
For more information about abilities and features of OpenStackClient CLI you
|
|
can refer to `OpenStackClient documentation <http://docs.openstack.org/developer/python-openstackclient/>`_
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The CLI is configured via environment variables and command-line options which
|
|
are described in http://docs.openstack.org/developer/python-openstackclient/authentication.html.
|
|
|
|
Authentication using username/password is most commonly used and can be
|
|
provided with environment variables:
|
|
|
|
.. code-block:: bash
|
|
|
|
export OS_AUTH_URL=<url-to-openstack-identity>
|
|
export OS_PROJECT_NAME=<project-name>
|
|
export OS_USERNAME=<username>
|
|
export OS_PASSWORD=<password> # (optional)
|
|
|
|
or command-line options:
|
|
|
|
.. code-block:: bash
|
|
|
|
--os-auth-url <url>
|
|
--os-project-name <project-name>
|
|
--os-username <username>
|
|
[--os-password <password>]
|
|
|
|
Additionally :program:`sahara` API url can be configured with parameter:
|
|
|
|
.. code-block:: bash
|
|
|
|
--os-data-processing-url
|
|
|
|
or with environment variable:
|
|
|
|
.. code-block:: bash
|
|
|
|
export OS_DATA_PROCESSING_URL=<url-to-sahara-API>
|