Files
mistral/doc/source/user/cli/index.rst
Renat Akhmerov 9fb213c315 The first iteration of restructuring Mistral doc
* Grouped documentation articles into several main parts: user docs,
  admin docs, developer docs.
* Changed the index page so that it contains links to the index pages
  of the main documentation parts like user docs, admin docs etc.
* Fixed all the broken links
* Removed index generation since it's not informative at all in its
  current form and it exposes code internals (REST controller class
  names)
* Removed obsolete properties that are no longer used by the
  "openstackdocstheme" project
* Removed obsolete static html files
* Moved part of the images to the folders where they are used

Further work:

* Refactor main chapters (user, admin, developer) one by one and
  make them look consistent. For example, there are several pages
  that provide similar kind of information: overview, quick start,
  main features etc. It is a mess that's been accumulated throughout
  the last 4-5 years.
* Fill the gaps. Add all missing pages like: event notifications,
  workflow environment, etc.
* Move cookbooks from Wiki to this doc.

Partially implements: blueprint mistral-restructure-docs
Change-Id: Ia722a6885ad2fb97d63a34285b0a5b1a23da79e8
2020-01-22 14:06:51 +07:00

3.4 KiB

Mistral Client Commands Guide

The Mistral CLI can be used with mistral command or via OpenStackClient.

Mistral Client

The best way to learn about all the commands and arguments that are expected is to use the mistral help command.

$ mistral help
usage: mistral [--version] [-v] [--log-file LOG_FILE] [-q] [-h] [--debug]
               [--os-mistral-url MISTRAL_URL]
               [--os-mistral-version MISTRAL_VERSION]
               [--os-mistral-service-type SERVICE_TYPE]
...

It can also be used with the name of a sub-command.

$ mistral help execution-create
usage: mistral execution-create [-h] [-f {json,shell,table,value,yaml}]
                                [-c COLUMN] [--max-width <integer>]
                                [--print-empty] [--noindent] [--prefix PREFIX]
                                [-d DESCRIPTION]
                                workflow_identifier [workflow_input] [params]

Create new execution.

positional arguments:
  workflow_identifier   Workflow ID or name. Workflow name will be deprecated
                        since Mitaka.
...

OpenStack Client

OpenStack client works in a similar way, the command openstack help shows all the available commands and then openstack help <sub-command> will show the detailed usage.

The full list of Mistral commands that are registered with OpenStack client can be listed with openstack command list. By default it will list all commands grouped together, but we can specify only the Mistral command group.

$ openstack command list --group openstack.workflow_engine.v2
+------------------------------+-----------------------------------+
| Command Group                | Commands                          |
+------------------------------+-----------------------------------+
| openstack.workflow_engine.v2 | action definition create          |
|                              | action definition show |
|                              | action definition delete          |
|                              | action definition list            |
|                              | action definition show            |
|                              | action definition update          |
|                              | action execution delete           |
...

Then detailed help output can be requested for an individual command.

$ openstack help workflow execution create
usage: openstack workflow execution create [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--max-width <integer>]
                                           [--print-empty] [--noindent]
                                           [--prefix PREFIX] [-d DESCRIPTION]
                                           workflow_identifier
                                           [workflow_input] [params]

Create new execution.

positional arguments:
  workflow_identifier   Workflow ID or name. Workflow name will be deprecated
                        since Mitaka.
  workflow_input        Workflow input
  params                Workflow additional parameters