The documentation you're currently reading is for version 3.1.0. Click here to view documentation for the latest stable version.
Pausing and Resuming Workflow Execution¶
Orquesta workflow execution can be paused by running
st2 execution pause <execution-id>. An
execution must be in a running state in order for pause to be successful. The execution will
initially go into a
pausing state, and will go into a
paused state when no more tasks are
in an active state such as
canceling. When a workflow execution
is paused, it can be resumed by running
st2 execution resume <execution-id>.
resume operation will cascade down to subworkflows. Orquesta allows for
finer control to workflow with multiple branches. If the
pause operation is requested from
a subworkflow, the
pause will not cascade up to the parent workflow and down to other peers.
This supports use case where the user wants to pause only a specific branch but let the rest of
the workflow continues. This behavior is the same for resuming from a subworkflow.
Canceling Workflow Execution¶
A workflow execution can be cancelled by running
st2 execution cancel <execution-id>. Workflow
tasks that are still running will be allowed to run to completion. During cancelation, no new tasks
for the workflow will be scheduled. The execution will remain in
canceling status until there
are no more active tasks.
Re-running Workflow Execution¶
A workflow execution can be re-run on error. In the current version, the workflow execution can only
be re-run from the beginning. Re-running the workflow execution from the beginning is exactly like
re-running any StackStorm execution with the command
st2 execution re-run <execution-id>. The re-run
is a completely separate execution with a new execution ID in StackStorm.