2013-10-11 15:18:44 +04:00
Mistral
2013-10-11 03:26:15 -07:00
=======
2013-11-29 12:04:12 +07:00
Task Orchestration and Scheduling service for OpenStack cloud
2014-04-30 10:24:27 +04:00
Installation
------------
2013-11-29 12:04:12 +07:00
First of all, in a shell run:
2014-04-30 10:24:27 +04:00
tox
2013-11-29 12:04:12 +07:00
This will install necessary virtual environments and run all the project tests. Installing virtual environments may take significant time (~10-15 mins).
2014-04-30 10:24:27 +04:00
Running Mistral API server
--------------------------
2013-12-20 18:38:13 +07:00
To run Mistral API server perform the following command in a shell:
2013-11-29 12:04:12 +07:00
2014-04-30 10:24:27 +04:00
tox -evenv -- python mistral/cmd/launch.py --server api --config-file path_to_config*
2013-12-20 18:38:13 +07:00
Note that an example configuration file can be found in etc/mistral.conf.example.
2014-04-30 10:24:27 +04:00
Running Mistral Engines
-----------------------
2014-04-19 17:31:04 -07:00
To run Mistral Engine perform the following command in a shell:
2014-04-30 10:24:27 +04:00
tox -evenv -- python mistral/cmd/launch.py --server engine --config-file path_to_config*
2014-04-19 17:31:04 -07:00
2014-04-30 10:24:27 +04:00
Running Mistral Task Executors
------------------------------
2014-03-20 16:26:56 -07:00
To run Mistral Task Executor instance perform the following command in a shell:
2013-12-20 18:38:13 +07:00
2014-04-30 10:24:27 +04:00
tox -evenv -- python mistral/cmd/launch.py --server executor --config-file path_to_config
2013-12-20 18:38:13 +07:00
2014-04-19 17:31:04 -07:00
Note that at least one Engine instance and one Executor instance should be running so that workflow tasks are processed by Mistral.
2013-11-29 12:04:12 +07:00
2014-04-30 10:24:27 +04:00
Debugging
---------
2014-03-20 16:26:56 -07:00
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
2014-02-25 20:11:48 -08:00
[pecan]
auth_enable = False
2013-12-19 21:08:45 +07:00
2014-02-25 20:11:48 -08:00
and run in pdb, PyDev or PyCharm::
2014-03-20 16:26:56 -07:00
mistral/cmd/launch.py --server all --config-file etc/mistral.conf --use-debugger
2014-04-24 18:29:14 +04:00
2014-04-30 10:24:27 +04:00
Running examples
----------------
2014-04-24 18:29:14 +04:00
To run the examples find them in mistral-extra repository (https://github.com/stackforge/mistral-extra) and follow the instructions on each example.