retry

The step-level retry field automatically re-runs a failed step using a configurable backoff strategy, making workflows resilient to transient failures.

steps:
  - command: terraform apply vpc -auto-approve
    retry:
      max_attempts: 3
      backoff_strategy: exponential
      initial_delay: 5s
      max_delay: 60s

Fields

max_attempts

Maximum number of attempts. Omit for unlimited attempts.

max_elapsed_time

Total time budget for all attempts and backoff delays combined.

backoff_strategy

Delay strategy: constant, linear, or exponential. Defaults to constant.

initial_delay

Delay before the first retry.

max_delay

Maximum delay between retries.

multiplier

Multiplier for linear or exponential backoff.

random_jitter

Jitter factor from 0.0 to 1.0 added to delays.

Omitting a parameter disables that limit or uses the default behavior. Explicit zero values are invalid where a positive duration or count is required.