mistral/doc/source/index.rst
Andrea Visnyei a683984001 Removing duplicated descriptions
Removed dupliocated Mistral overviews and merged content into description on
 index page.

Change-Id: Ia7c260494a8a659988db2329bf3504be9b4b67fa
Signed-off-by: Andrea Visnyei <andrea.visnyei@nokia.com>
2020-03-02 07:17:48 +00:00

92 lines
3.2 KiB
ReStructuredText

========================
Mistral Workflow Service
========================
What is Mistral?
================
Mistral is a workflow service. Lots of computations in computer systems
nowadays can be represented as processes that consist of multiple
interconnected steps that need to run in a particular order. Those steps
are often interactions with components distributed across different machines:
real hardware machines, cloud virtual machines or containers. Mistral provides
capabilities to automate such processes.
Particularly, Mistral can be used, for example, for solving administrator
tasks related to managing clusters of software, or for any other tasks
that span multiple components and take long to complete. It can also be used
as a central component for deploying distributed software in a truly large
scale. In any case where the ability to track the progress of the activity
becomes crucial, Mistral is a good fit.
A Mistral user can describe such a process as a set of tasks and transitions
between them, and upload such a definition to Mistral, which will take care of
state management, correct execution order, parallelism, synchronization and
high availability. In Mistral terminology such a set of tasks and
relations between them is called a **workflow**.
Just to Get Started
===================
* :doc:`user/overview`: If you've just started with Mistral, this short
article will help you understand the main Mistral ideas and concepts.
* :doc:`user/faq`: Some of the typical questions you have may have already
been answered here.
For End Users
=============
* :doc:`user/index`: If you're going to use Mistral functionality as an
end user, i.e. writing and running workflows, then you need to read
the full user documentation that tells about all Mistral features,
including the full description of the Mistral Workflow Language and
Mistral ReST API.
* :doc:`user/wf_lang_v2`: If you just want a direct link to the full
specification of the Mistral Workflow Language, this is it.
* :doc:`user/rest_api_v2`: This is where you can find the full specification
of the Mistral REST API.
For Administrators and Operators
================================
* :doc:`admin/index`: If you need to install, configure and maintain a
Mistral cluster, this is a place to start.
For Developers
==============
* :doc:`developer/contributor/coding_guidelines`: No matter what you're
going to develop regarding Mistral, please read the coding guidelines
we accept in our project.
* :doc:`developer/index`: If you want to contribute to the project or
write Mistral extensions, please start here.
* :doc:`developer/extensions/index`: Read this section if you want to write
custom Mistral actions and other extensions.
Workflow Visualization (CloudFlow)
==================================
* `CloudFlow <https://github.com/nokia/CloudFlow>`_: If you're looking for
a nice workflow visualization tool then visit this web page. CloudFlow
provides a nice UI for debugging and analysing workflow executions.
Main Chapters
=============
.. toctree::
:maxdepth: 1
:includehidden:
user/index
admin/index
developer/index
.. only:: html
Search
======
* :ref:`Document search <search>`: Search the contents of this document.