openstack/mistral
Code Issues Proposed changes
Workflow Service for OpenStack.
374 Commits 5 Branches 56 Tags 50 MiB
Python 98.9%
Shell 1%
79a78b96c4
Go to file
Anastasia Kuznetsova 79a78b96c4 Move gate tests under mistral/tests 
- Move all gate tests from functionaltests folder to the mistral/tests/functional
- Edit run directory for gate tests in the functionaltests/run_tests.sh
- Leave 'resources' folder in the 'mistral/tests' to use examples from it in the tempest tests

Change-Id: I4d6d6a653aab5af00c5cae7c21495f4a86ebfe42
2014-08-15 11:14:59 +04:00
contrib/devstack Add installation of mistralclient in devstack script 2014-07-08 15:24:53 +04:00
doc/source Cleaning up index.rst file 2014-07-21 08:29:54 +02:00
etc Replace oslo-incubator's db with standalone oslo.db 2014-07-28 18:01:57 +07:00
functionaltests Move gate tests under mistral/tests 2014-08-15 11:14:59 +04:00
mistral Move gate tests under mistral/tests 2014-08-15 11:14:59 +04:00
tools Replace oslo-incubator's db with standalone oslo.db 2014-07-28 18:01:57 +07:00
.coveragerc Move tests to testr 2014-06-04 14:58:29 +04:00
.gitignore Move tests to testr 2014-06-04 14:58:29 +04:00
.gitreview Add .gitreview, setup.py and other infrastructure. 2013-11-01 02:57:27 +07:00
.pylintrc Add .gitreview, setup.py and other infrastructure. 2013-11-01 02:57:27 +07:00
.testr.conf Move gate tests under mistral/tests 2014-08-15 11:14:59 +04:00
AUTHORS Fixing Mistral HTTP action to take care of empty headers 2014-07-01 11:40:11 +07:00
LICENSE Adding license and authors file 2013-12-30 13:11:49 +07:00
openstack-common.conf Replace oslo-incubator's db with standalone oslo.db 2014-07-28 18:01:57 +07:00
README.rst Merge "Fixing obsolete file name in README.rst" 2014-06-18 02:22:51 +00:00
requirements.txt Implementing DSL specification v2 (partially) 2014-08-13 11:14:29 +07:00
run_tests.sh Move gate tests under mistral/tests 2014-08-15 11:14:59 +04:00
setup.cfg Make plugins easier to use 2014-07-03 18:24:57 -10:00
setup.py Fixed issue with tarballs 2014-04-30 18:12:55 +04:00
test-requirements.txt Move oslotest into test-requirements.txt 2014-07-24 14:38:28 +02:00
tox.ini Remove redundant DB API arguments 2014-06-20 12:54:39 +07:00

README.rst

Mistral

Task Orchestration and Scheduling service for OpenStack cloud

Installation

First of all, in a shell run:

tox

This will install necessary virtual environments and run all the project tests. Installing virtual environments may take significant time (~10-15 mins).

Running Mistral API server

To run Mistral API server perform the following command in a shell:

tox -evenv -- python mistral/cmd/launch.py --server api --config-file path_to_config*

Note that an example configuration file can be found in etc/mistral.conf.sample.

Running Mistral Engines

To run Mistral Engine perform the following command in a shell:

tox -evenv -- python mistral/cmd/launch.py --server engine --config-file path_to_config*

Running Mistral Task Executors

To run Mistral Task Executor instance perform the following command in a shell:

tox -evenv -- python mistral/cmd/launch.py --server executor --config-file path_to_config

Note that at least one Engine instance and one Executor instance should be running so that workflow tasks are processed by Mistral.

Running Multiple Mistral Servers Under the Same Process

To run more than one server (API, Engine, or Task Executor) on the same process, perform the following command in a shell:

tox -evenv -- python mistral/cmd/launch.py --server api,engine --config-file path_to_config

The --server command line option can be a comma delimited list. The valid options are "all" (by default if not specified) or any combination of "api", "engine", and "executor". It's important to note that the "fake" transport for the rpc_backend defined in the config file should only be used if "all" the Mistral servers are launched on the same process. Otherwise, messages do not get delivered if the Mistral servers are launched on different processes because the "fake" transport is using an in process queue.

Debugging

To debug using a local engine and executor without dependencies such as RabbitMQ, create etc/mistral.conf with the following settings:

[DEFAULT]
rpc_backend = fake

[pecan]
auth_enable = False

and run in pdb, PyDev or PyCharm:

mistral/cmd/launch.py --server all --config-file etc/mistral.conf --use-debugger

Running examples

To run the examples find them in mistral-extra repository (https://github.com/stackforge/mistral-extra) and follow the instructions on each example.

Tests

Information about automated tests for Mistral can be found here: https://wiki.openstack.org/wiki/Mistral/Testing