Change client doc references to sahara
Partial-implements: blueprint savanna-renaming-client Change-Id: I72f943db56a9c9c85bad1cd10ea9cd34fddf471c
This commit is contained in:
parent
7691dcff6e
commit
b313382c0d
|
@ -1,12 +1,12 @@
|
||||||
Savanna Style Commandments
|
Sahara Style Commandments
|
||||||
==========================
|
=========================
|
||||||
|
|
||||||
- Step 1: Read the OpenStack Style Commandments
|
- Step 1: Read the OpenStack Style Commandments
|
||||||
http://docs.openstack.org/developer/hacking/
|
http://docs.openstack.org/developer/hacking/
|
||||||
- Step 2: Read on
|
- Step 2: Read on
|
||||||
|
|
||||||
Savanna Specific Commandments
|
Sahara Specific Commandments
|
||||||
-----------------------------
|
----------------------------
|
||||||
|
|
||||||
None so far
|
None so far
|
||||||
|
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
<h3>Useful Links</h3>
|
<h3>Useful Links</h3>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="https://wiki.openstack.org/wiki/Savanna">Savanna @ OpenStack Wiki</a></li>
|
<li><a href="https://wiki.openstack.org/wiki/Sahara">Sahara @ OpenStack Wiki</a></li>
|
||||||
<li><a href="https://launchpad.net/savanna">Savanna @ Launchpad</a></li>
|
<li><a href="https://launchpad.net/sahara">Sahara @ Launchpad</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
{% if READTHEDOCS %}
|
{% if READTHEDOCS %}
|
||||||
|
|
|
@ -1,24 +1,24 @@
|
||||||
Savanna Client
|
Sahara Client
|
||||||
==============
|
=============
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
--------
|
--------
|
||||||
|
|
||||||
Savanna Client provides a list of Python interfaces to communicate with the Savanna REST API.
|
Sahara Client provides a list of Python interfaces to communicate with the Sahara REST API.
|
||||||
Savanna Client enables users to perform most of the existing operations like retrieving template lists,
|
Sahara Client enables users to perform most of the existing operations like retrieving template lists,
|
||||||
creating Clusters, submitting EDP Jobs, etc.
|
creating Clusters, submitting EDP Jobs, etc.
|
||||||
|
|
||||||
|
|
||||||
Instantiating a Client
|
Instantiating a Client
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
To start using the Savanna Client users have to create an instance of the `Client` class.
|
To start using the Sahara Client users have to create an instance of the `Client` class.
|
||||||
The client constructor has a list of parameters to authenticate and locate Savanna endpoint.
|
The client constructor has a list of parameters to authenticate and locate Sahara endpoint.
|
||||||
|
|
||||||
* auth_url - Keystone URL that will be used for authentication.
|
* auth_url - Keystone URL that will be used for authentication.
|
||||||
* savanna_url - Savanna REST API URL to communicate with.
|
* sahara_url - Sahara REST API URL to communicate with.
|
||||||
* service_type - Savanna service name in Keystone catalog. (Default: data_processing)
|
* service_type - Sahara service name in Keystone catalog. (Default: data_processing)
|
||||||
* endpoint_type - Desired Savanna endpoint type. (Default: publicURL)
|
* endpoint_type - Desired Sahara endpoint type. (Default: publicURL)
|
||||||
* username - Username for Keystone authentication.
|
* username - Username for Keystone authentication.
|
||||||
* api_key - Password for Keystone authentication.
|
* api_key - Password for Keystone authentication.
|
||||||
* project_name - Keystone Tenant name.
|
* project_name - Keystone Tenant name.
|
||||||
|
@ -27,7 +27,7 @@ The client constructor has a list of parameters to authenticate and locate Savan
|
||||||
|
|
||||||
**Important!**
|
**Important!**
|
||||||
It is not a mandatory rule to provide all of the parameters above. The minimum number should be enough
|
It is not a mandatory rule to provide all of the parameters above. The minimum number should be enough
|
||||||
to determine Savanna endpoint, check user authentication and tenant to operate in.
|
to determine Sahara endpoint, check user authentication and tenant to operate in.
|
||||||
|
|
||||||
Authentication check
|
Authentication check
|
||||||
~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
|
@ -36,11 +36,11 @@ If a user already has a Keystone authentication token, it may be used in `input_
|
||||||
|
|
||||||
.. sourcecode:: python
|
.. sourcecode:: python
|
||||||
|
|
||||||
from savannaclient.api.client import Client as savannaclient
|
from saharaclient.api.client import Client as saharaclient
|
||||||
|
|
||||||
savanna = savannaclient(savanna_url="http://savanna:8386/v1.1",
|
sahara = saharaclient(sahara_url="http://sahara:8386/v1.1",
|
||||||
project_id="11111111-2222-3333-4444-555555555555",
|
project_id="11111111-2222-3333-4444-555555555555",
|
||||||
input_auth_token="66666666-7777-8888-9999-000000000000")
|
input_auth_token="66666666-7777-8888-9999-000000000000")
|
||||||
..
|
..
|
||||||
|
|
||||||
In this case no other authentication parameters are required and `input_auth_token` has a higher
|
In this case no other authentication parameters are required and `input_auth_token` has a higher
|
||||||
|
@ -53,47 +53,47 @@ priority than other parameters. Otherwise user has to provide:
|
||||||
|
|
||||||
.. sourcecode:: python
|
.. sourcecode:: python
|
||||||
|
|
||||||
from savannaclient.api.client import Client as savannaclient
|
from saharaclient.api.client import Client as saharaclient
|
||||||
|
|
||||||
savanna = savannaclient(auth_url="http://keystone:5000/v2.0",
|
sahara = saharaclient(auth_url="http://keystone:5000/v2.0",
|
||||||
savanna_url="http://savanna:8386/v1.1",
|
sahara_url="http://sahara:8386/v1.1",
|
||||||
username="user",
|
username="user",
|
||||||
api_key="PaSsWoRd",
|
api_key="PaSsWoRd",
|
||||||
project_name="demo-project")
|
project_name="demo-project")
|
||||||
..
|
..
|
||||||
|
|
||||||
|
|
||||||
Savanna endpoint discovery
|
Sahara endpoint discovery
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
If user has a direct URL pointing to Savanna REST API, it may be specified as `savanna_url`.
|
If user has a direct URL pointing to Sahara REST API, it may be specified as `sahara_url`.
|
||||||
If this parameter is missing, Savanna client will use Keystone Service Catalog to find the endpoint.
|
If this parameter is missing, Sahara client will use Keystone Service Catalog to find the endpoint.
|
||||||
There are two parameters: `service_type` and `endpoint_type` to configure endpoint search. Both parameters have
|
There are two parameters: `service_type` and `endpoint_type` to configure endpoint search. Both parameters have
|
||||||
default values.
|
default values.
|
||||||
|
|
||||||
.. sourcecode:: python
|
.. sourcecode:: python
|
||||||
|
|
||||||
from savannaclient.api.client import Client as savannaclient
|
from saharaclient.api.client import Client as saharaclient
|
||||||
|
|
||||||
savanna = savannaclient(auth_url="http://keystone:5000/v2.0",
|
sahara = saharaclient(auth_url="http://keystone:5000/v2.0",
|
||||||
username="user",
|
username="user",
|
||||||
api_key="PaSsWoRd",
|
api_key="PaSsWoRd",
|
||||||
project_name="demo-project",
|
project_name="demo-project",
|
||||||
service_type="non-default-service-type",
|
service_type="non-default-service-type",
|
||||||
endpoint_type="internalURL")
|
endpoint_type="internalURL")
|
||||||
..
|
..
|
||||||
|
|
||||||
|
|
||||||
Tenant specification
|
Tenant specification
|
||||||
~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
All Savanna operations should be performed in one of OpenStack tenants.
|
All Sahara operations should be performed in one of OpenStack tenants.
|
||||||
There are two parameters: `project_name` and `project_id` which allow to specify a tenant.
|
There are two parameters: `project_name` and `project_id` which allow to specify a tenant.
|
||||||
`project_id` parameter has a higher priority.
|
`project_id` parameter has a higher priority.
|
||||||
|
|
||||||
Object managers
|
Object managers
|
||||||
---------------
|
---------------
|
||||||
Savanna Client has a list of fields to operate with:
|
Sahara Client has a list of fields to operate with:
|
||||||
|
|
||||||
* plugins
|
* plugins
|
||||||
* clusters
|
* clusters
|
||||||
|
@ -127,7 +127,7 @@ Image Registry ops
|
||||||
~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
* update_image(image_id, user_name, descr) - Create or update an Image in Image Registry.
|
* update_image(image_id, user_name, descr) - Create or update an Image in Image Registry.
|
||||||
* unregister_image(image_id) - Remove an Image from Savanna Image Registry.
|
* unregister_image(image_id) - Remove an Image from Sahara Image Registry.
|
||||||
* update_tags(image_id, new_tags) - Updates Image tags. `new_tags` list will replace currently assigned tags.
|
* update_tags(image_id, new_tags) - Updates Image tags. `new_tags` list will replace currently assigned tags.
|
||||||
|
|
||||||
Node Group Template ops
|
Node Group Template ops
|
||||||
|
|
|
@ -1,19 +1,19 @@
|
||||||
Python bindings to the OpenStack Savanna API
|
Python bindings to the OpenStack Sahara API
|
||||||
============================================
|
===========================================
|
||||||
|
|
||||||
This is a client for OpenStack Savanna API. There's :doc:`a Python API
|
This is a client for OpenStack Sahara API. There's :doc:`a Python API
|
||||||
<api>` (the :mod:`savannaclient` module), and a :doc:`command-line script
|
<api>` (the :mod:`saharaclient` module), and a :doc:`command-line script
|
||||||
<shell>` (installed as :program:`savanna`). Each implements the entire
|
<shell>` (installed as :program:`sahara`). Each implements the entire
|
||||||
OpenStack Savanna API.
|
OpenStack Sahara API.
|
||||||
|
|
||||||
You'll need credentials for an OpenStack cloud that implements the
|
You'll need credentials for an OpenStack cloud that implements the
|
||||||
Data Processing API, in order to use the savanna client.
|
Data Processing API, in order to use the sahara client.
|
||||||
|
|
||||||
You may want to read the `OpenStack Savanna Docs`__ -- the overview, at
|
You may want to read the `OpenStack Sahara Docs`__ -- the overview, at
|
||||||
least -- to get an idea of the concepts. By understanding the concepts
|
least -- to get an idea of the concepts. By understanding the concepts
|
||||||
this library should make more sense.
|
this library should make more sense.
|
||||||
|
|
||||||
__ http://docs.openstack.org/developer/savanna/api/index.html
|
__ http://docs.openstack.org/developer/sahara/api/index.html
|
||||||
|
|
||||||
Contents:
|
Contents:
|
||||||
|
|
||||||
|
@ -26,14 +26,14 @@ Contributing
|
||||||
============
|
============
|
||||||
|
|
||||||
Code is hosted in `review.o.o`_ and mirrored to `github`_ and `git.o.o`_ .
|
Code is hosted in `review.o.o`_ and mirrored to `github`_ and `git.o.o`_ .
|
||||||
Submit bugs to the Savanna project on `launchpad`_ and to the Savanna client on
|
Submit bugs to the Sahara project on `launchpad`_ and to the Sahara client on
|
||||||
`launchpad_client`_. Submit code to the openstack/python-savannaclient project
|
`launchpad_client`_. Submit code to the openstack/python-saharaclient project
|
||||||
using `gerrit`_.
|
using `gerrit`_.
|
||||||
|
|
||||||
.. _review.o.o: https://review.openstack.org
|
.. _review.o.o: https://review.openstack.org
|
||||||
.. _github: https://github.com/openstack/python-savannaclient
|
.. _github: https://github.com/openstack/python-saharaclient
|
||||||
.. _git.o.o: http://git.openstack.org/cgit/openstack/python-savannaclient
|
.. _git.o.o: http://git.openstack.org/cgit/openstack/python-saharaclient
|
||||||
.. _launchpad: https://launchpad.net/savanna
|
.. _launchpad: https://launchpad.net/sahara
|
||||||
.. _launchpad_client: https://launchpad.net/python-savannaclient
|
.. _launchpad_client: https://launchpad.net/python-saharaclient
|
||||||
.. _gerrit: http://wiki.openstack.org/GerritWorkflow
|
.. _gerrit: http://wiki.openstack.org/GerritWorkflow
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue