Basic Examples

Small copy-paste examples for the common workflow building blocks.

Basic Workflows

Basic Sequential Steps

steps:
  - id: first
    run: echo "Step 1"
  - id: second
    run: echo "Step 2"
    depends: first

Learn more →

Parallel Execution (Iterator)

steps:
  - action: dag.run
    with:
      dag: processor
      params: "item=${ITEM}"
    parallel:
      items: [A, B, C]
      max_concurrent: 2
---
name: processor
params:
  - name: item
    required: true
steps:
  - run: echo "Processing ${params.item}"

Learn more →

Multiple Commands per Step

tools:
  - nodejs/node@v22.21.1

steps:
  - id: build_and_test
    run: |
      npm install
      npm run build
      npm test
    env:
      - NODE_ENV: production
    working_dir: /app

Share step config (env, working_dir, retry_policy, etc.) across commands instead of duplicating across steps.

Learn more →

Reproducible CLI Tools

tools:
  - jqlang/jq@jq-1.7.1

steps:
  - id: transform
    run: jq '.items[] | .name' input.json

Pin portable command-line dependencies in the DAG so workers install the expected binary before running host command steps.

Learn more →

Dependency Modes

# Default graph mode: explicit dependencies define order
steps:
  - id: step_1
    run: echo "step 1"
  - id: step_2
    run: echo "step 2"
    depends: step_1

# Independent steps can run in parallel
---
steps:
  - id: a
    run: echo A
  - id: b
    run: echo B

Learn more →