x
/
python-rsdclient
Code Issues Proposed changes
Python client for Rack Scale Design
56 Commits 7 Branches 8 Tags 2 MiB
Python 99.6%
reStructuredText 0.4%
Go to file
qingszhao a3c84733a3 fix tox python3 overrides 
We want to default to running all tox environments under python 3, so
set the basepython value in each environment.

We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.

We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.

Change-Id: I7946101188fd8b6afd6cc556698aa05b5f17832c
 		2018-09-29 20:11:41 +08:00
doc/source Add User Guide to documentation. 2017-11-27 20:35:51 -08:00
releasenotes Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
rsdclient Update remote drive requiement of node composition for RSD 2.3 2018-09-07 10:02:55 -07:00
.coveragerc Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
.gitignore Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
.gitreview Added .gitreview 2017-08-02 08:33:58 +00:00
.mailmap Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
.testr.conf Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
CONTRIBUTING.rst Update CLI usage doc 2017-09-29 16:44:53 -07:00
HACKING.rst Update the URL in HACKING.rst 2018-09-25 00:36:27 +08:00
LICENSE Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
README.rst Update CLI usage doc 2017-09-29 16:44:53 -07:00
babel.cfg Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
requirements.txt Filter out the path variable of field 2018-06-07 11:29:35 -07:00
setup.cfg Removed older version of python added 3.5 2018-09-29 20:10:59 +08:00
setup.py Initial Cookiecutter Commit. 2017-08-02 14:44:01 -07:00
test-requirements.txt Cleanup test-requirements 2017-09-21 23:25:36 +08:00
tox.ini fix tox python3 overrides 2018-09-29 20:11:41 +08:00

README.rst

python-rsdclient

OpenStack client plugin for Rack Scale Design

This is a client for the RSD Pod Manager API, which is based on OpenStack client framework. It provides a Python API (rsdclient/v1 module) and a RSD specific plugin for OpenStack client (rsdclient/osc).

Development takes place via the usual OpenStack processes as outlined in the developer guide. The master repository is on git.openstack.org.

Contents:

Installation

To use openstack rsd CLI, the python-openstackclient and python-rsdclient should be installed:

# pip install python-openstackclient
# pip install python-rsdclient

To use the CLI, it requires two parts of configuration, OpenStack and RSD login info.

At first, you have to provide your OpenStack username, password, project, and auth endpoint. You can use configuration options --os-username, --os-password, --os-project-id (or --os-project-name), and --os-auth-url, or set the corresponding environment variables:

$ export OS_USERNAME=user
$ export OS_PASSWORD=password
$ export OS_PROJECT_NAME=project                         # or OS_PROJECT_ID
$ export OS_PROJECT_DOMAIN_ID=default
$ export OS_USER_DOMAIN_ID=default
$ export OS_IDENTITY_API_VERSION=3
$ export OS_AUTH_URL=http://auth.example.com:5000/identity

Then, you have to provide your RSD username, password, SSL certificate with admin privilege, and pod manager URL. You can use configuration options --rsd-username, --rsd-password, --rsd-verify, and --rsd-url, or set the corresponding environment variables:

$ export RSD_USERNAME=admin
$ export RSD_PASSWORD=password
$ export RSD_VERIFY=False     # or RSD_VERIFY=<path to SSL certificate>
$ export RSD_URL=https://localhost:8443/

OpenStackClient RSD Plugin

To get a list of available (sub)commands and options, run:

$ openstack help rsd

To get usage and options of a command, run:

$ openstack help rsd <sub-command>

An example of composing a node only with name:

$ openstack rsd node compose --name "testing node"