Skip to main content
EXAMPLE

Parallel Steps

This example demonstrates parallel and matrix workflow control steps with needs, configurable output, and failure behavior.

Automation
cloudposse / atmos

Try it out

Copy the example into a new directory and make it your own:

atmos init examples/parallel-steps
cd parallel-steps

Follow the README for prerequisites and next steps.

See it in action

RECORDED DEMO
parallel-steps
 
Recorded from this example
Real commands. Real output.
README.md1.2 KB
View on GitHub

Example: Parallel Workflow Steps

This example demonstrates parallel and matrix workflow control steps with needs, configurable output, and failure behavior.

Try It

Requires a POSIX shell, or WSL on Windows, because the example workflows run shell commands.

cd examples/parallel-steps

atmos workflow checks -f parallel
atmos workflow prefixed -f parallel
atmos workflow matrix -f parallel

What It Shows

  • parallel runs independent child steps concurrently.
  • needs makes one child wait for sibling steps.
  • output.mode: grouped captures each child and prints labeled blocks.
  • output.mode: prefixed streams child output live with line prefixes.
  • matrix expands literal axes and runs generated shell steps through the same scheduler.