All 29 Sync Waves & Hooks questions
More in Sync Waves & Hooks
How do hooks differ from plain resources with sync waves, and when do you choose each? How do you order a multi-tier application deployment with waves? How do you run post-deployment smoke tests and fail the sync if they fail? How do you coordinate hooks across multiple Applications (e.g., App of Apps)? How do you retry a failed hook Job? How do sync waves handle deletion order during pruning? How do you ensure a hook runs on every sync versus only on change? What are pitfalls of overusing hooks and waves?
Advertisement
ArgoCD › Sync Waves & Hooks

What is a SyncFail hook and how is it used?

Advanced

Answer

A SyncFail hook runs only when a sync operation fails, used for cleanup, rollback of partial changes, or alerting. It lets you react to failed deployments within the sync lifecycle rather than relying solely on external monitoring.
metadata:
  annotations:
    argocd.argoproj.io/hook: SyncFail
Real-world example On a failed sync, a SyncFail hook cleans up temporary resources and posts an alert to the incident channel.

Common follow-ups: When does SyncFail run? | What tasks suit SyncFail?

Applications Sync & Health Sync Waves & Hooks
All 29 Sync Waves & Hooks questions