Skip to content

Argo Workflows Retry Quick Fix - Step Retry Configuration

DodaTech Updated 2026-06-26 1 min read

Argo Workflows retry Strategy automatically retries failed steps to handle transient errors. Incorrect retry configuration wastes cluster resources or fails to retry at all. This guide covers the fix.

Quick Fix

Wrong

retryStrategy:
  limit: 5

The issue: no backoff or retryPolicy defined. Every failed step retries 5 times with no delay, potentially overwhelming external services and wasting compute resources.

retryStrategy:
  limit: 3
  retryPolicy: "Always"
  backoff:
    duration: "5s"
    factor: 2
    maxDuration: "2m"
# Expected output after applying the fix
# First retry: after 5s
# Second retry: after 10s (5s × 2)
# Third retry: after 20s (10s × 2)
# Max total retry time: 2 minutes
# Step eventually succeeds or fails after 3 retries

Prevention

  • Always set backoff Strategy with duration and factor
  • Use retryPolicy: "Always" for idempotent operations
  • Set retryPolicy: "OnError" to retry only on errors (not failures)
  • Set maxDuration to cap total retry time
  • Use limit: 3 as a reasonable default for most operations

DodaTech Tools

Doda Browser's retry visualizer shows retry timing and backoff progression. DodaZIP archives retry histories for reliability analysis. Durga Antivirus Pro detects retry storms and alerts operators.

FAQ

What is the difference between "Always" and "OnError" retry policies?

"Always" retries on any failure including transient errors. "OnError" retries only when the step returns an error code but not for step failures like resource issues. ||| Can I configure retry per template or globally? Retry is configured per template. Use a shared template with retry logic and call it from multiple workflow templates for consistent retry behavior. ||| How do I know which retry attempt is currently running? Check the pod name suffix — it increments with each retry. Also inspect the step status in argo get <workflow> which shows retry count.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro