Go to file
Lingxian Kong ccef0817d5 Introduce openstackclient plugin
Adds the code necessary for mistralclient to work as a plugin for
openstackclient.

Steps to test:
- Make sure Keystone service is installed and Mistral service is
  registered in Keystone, please refer to Mistral documentation here[1].
  The reason we need Keystone is because OpenStackClient always needs it
  for commands authentication.
- Install python-mistralclient.
- Install python-openstackclient, it will load Mistral commands via
  plugin mechanism.
- Config environment variables (something like OS_AUTH_URL, etc.).
- Run Mistral commands as you want, e.g. `openstack workflow list`.

TODO:
- update python-openstackclient documentation to let other projects know
  what objects our mistral project is using, to avoid potential
  conflicts in future.

[1]: http://docs.openstack.org/developer/mistral/guides/configuration_guide.html

Implements: blueprint mistral-osc-plugin
Change-Id: Ic099aaec88377a76a17700c33fed944e52ec5633
2015-11-23 21:15:35 +08:00
2015-10-05 14:38:06 +06:00
2015-11-23 21:15:35 +08:00
2015-09-17 12:16:50 +00:00
2015-07-11 14:11:10 +03:00

Mistral client

Python client for Mistral REST API. Includes python library for Mistral API and Command Line Interface (CLI) library.

Installation

First of all, clone the repo and go to the repo directory:

git clone git://git.openstack.org/openstack/python-mistralclient.git
cd python-mistralclient

Then just run:

pip install -e .

or

python setup.py install

Running Mistral client

If Mistral authentication is enabled, provide the information about OpenStack auth to environment variables. Type:

export OS_AUTH_URL=http://<Keystone_host>:5000/v2.0
export OS_USERNAME=admin
export OS_TENANT_NAME=tenant
export OS_PASSWORD=secret
export OS_MISTRAL_URL=http://<Mistral host>:8989/v2  (optional, by default URL=http://localhost:8989/v2)

and in the case that you are authenticating against keystone over https:

export OS_CACERT=<path_to_ca_cert>

Note: In client, we can use both Keystone auth versions - v2.0 and v3. But server supports only v3.

To make sure Mistral client works, type:

mistral workbook-list

You can see the list of available commands typing:

mistral --help
Description
Python client for Mistral REST API.
Readme 8.4 MiB
Languages
Python 99.2%
Shell 0.8%