Skip to main content

Tool to convert OpenStack Mistral workflows to StackStorm Orquesta workflows

Project description

Build Status codecov License


Converts Mistral workflows into Orquesta workflows


Getting Started

The script automatically sets up a virtualenv (if it doesn't exist) that contains all of the necessary depedencies to run.

Simply run the command for the first time and everything will get setup for you:

git clone
cd orquestaconvert
./bin/ --help - convert a single workflow and print to stdout

You must specify one or more workflow YAML files to convert as the last arguments to the script.

There are also some options you can use:

  • -e <type> - Type of expressions (YAQL or Jinja) to use when inserting new expressions (such as task transitions in the when clause)
  • --force - Forces the script to convert and print the workflow even if it does not successfully validate against the Orquesta YAML schema.
  • --validate - Runs just the validation portion of the script, very useful to validate workflows you partially converted with --force then finished conversion by hand.


Convert a single workflow

Convert the nasa_apod_twitter_post.yaml workflow from Mistral to Orquesta, using Jinja expressions (the default) in task transition conditions.

./bin/ ./tests/fixtures/mistral/nasa_apod_twitter_post.yaml

Convert a workflow, output YAQL expressions

Convert the workflow, using YAQL expressions for new task transition conditions, and skips Orquesta workflow validation. Note that this may generate a workflow that is neither a valid Mistral nor a valid Orquesta workflow.

./bin/ -e yaql --force ./tests/fixtures/mistral/nasa_apod_twitter_post.yaml

Validate an Orquesta workflow

Run Orquesta YAML schema validation on the file. Returns 0 on successful validation, nonzero on unsuccessful validation. Also use the --verbose option to explitly print the validation results for the file.

./bin/ --validate ./tests/fixtures/orquesta/nasa_apod_twitter_post.yaml - convert all Mistral workflows in a pack

This script scans a pack for all action metadata files and attempts to convert all Mistral workflows to Orquesta and/or validates all Orquesta workflows in a pack using the script. This script passes all unrecognized arguments to, so all actions you can do on one workflow with that script, you can do to the entire pack by using this script.

You must either run this command from the base directory of a pack or you must specify the directory that contains action metadata files with the --actions-dir option.

Recognized options are:

  • --list-workflows <type> - List all workflows of the specified type (must either be action-chain for ActionChain, mistral-v2 for Mistral, or orquesta or orchestra for Orquesta workflows)
  • --actions-dir <dir> - Specifies the directory to scan and convert


Convert all workflows in a pack

Attempts to convert all workflows from Mistral to Orquesta, using Jinja expressions in new task transitions (Jinja is the default).


List Mistral workflows in a pack

Lists remaining Mistral workflows.

./bin/ --list-workflows mistral-v2

Convert all workflows in a pack, outputting YAQL expressions

Converts all Mistral workflows (using YAQL expressions when generating task transition conditions) in mypack/actions to Orquesta and skips validation. Note that using this option may create workflows that are neither valid as Mistral nor Orquesta workflows.

./bin/ --expressions yaql --force --action-dir mypack/actions

Validate all Orquesta workflows in a pack

Explicitly rints the validation results for all Orquesta workflows.

./bin/ --validate --verbose


  • Converts direct Mistral Workflows into Orquesta Workflows (general structure)
  • Handles input, output, tasks
  • For each task, action, input, publish, on-success, on-error, and on-complete are all converted
  • Converts simple Jinja and YAQL expressions
  • Converts task(), st2kv, / $.xxx, etc in Jinja and YAQL expressions
  • Converts with-items and concurrency attributes
  • Converts most retry attributes, including continue-on and simple break-on expressions


  • Does not convert {% %} Jinja expressions
  • Does not convert complex Jinja / YAQL expressions
  • Does not convert reverse type workflows
  • Does not convert workbooks (multiple workflows in the same file
  • Does not convert task('xxx') references to non-local tasks, the current task is always assumed.
  • Does not convert workflows with an output-on-error stanza
  • Does not convert workflows if the tasks contain one or more of the following attributes
    • keep-result
    • pause-before
    • safe-rerun
    • target
    • timeout
    • wait-after
    • wait-before
    • workflow

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

orquestaconvert-0.1.tar.gz (27.6 kB view hashes)

Uploaded source

Built Distribution

orquestaconvert-0.1-py3-none-any.whl (40.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page