deb-mistral/tools/docker/DOCKER_README.rst
Andras Kovi 7b6d76659a Fixes the Mistral Docker image
Refactored to make the docker stuff self contained and removed the
unnecessary files from the root directory. Also created a readme file to
concretize how this feature works.

Also added an example script to set up Mistral with MySQL.

Closes-Bug: #1585911

Change-Id: I7fbcccb9d7ad168c5391e71326b205d074ab01ab
Signed-off-by: Andras Kovi <akovi@nokia.com>
2016-05-27 13:26:05 +02:00

61 lines
1.5 KiB
ReStructuredText

Using Mistral with docker
=========================
In order to minimize the work needed to the current Mistral code, or be able
to spin up independent or networked Mistral instances in seconds, docker
containers are a very good option. This guide describes the process to
launch an all-in-one Mistral container.
Docker installation
-------------------
In order to install the latest docker engine, run::
curl -fsSL https://get.docker.com/ | sh
If you are behind a proxy, additional configuration may be needed to be
able to execute further steps in the setup process. For detailed information
on this process, check out `the official guide at
<http://www.sqlite.org/omitted.html>`_.
Build the Mistral image
-----------------------
The `build.sh` script takes care of creating the `mistral-all` image locally.
Running Mistral
---------------
Start a RabbitMQ container::
docker run -d --name rabbitmq rabbitmq
Start Mistral::
docker run -d -p 8989:8989 --name mistral mistral-all
To execute commands inside the container::
docker exec -it mistral bash
E.g. to list workflows, issue::
mistral workflow-list
Running Mistral with MySQL
--------------------------
Other than the simplest use cases will very probably fail with various errors
due to the default Sqlight database. It is highly recommended that, for
example, MySQL is used as database backend.
The `start_mistral_rabbit_mysql.sh` script sets up a rabbitmq container, a
mysql container and a mistral container to work together.
Check out the script for more detail.