All 29 Sync Waves & Hooks questions
More in Sync Waves & Hooks
What is a PostSync hook typically used for? Can hooks use sync waves to order among themselves? How do you notify an external system after a successful deployment using hooks? How do you seed initial data on first deployment only? 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)? What is a SyncFail hook and how is it used? How do you retry a failed hook Job? How do sync waves handle deletion order during pruning?
Advertisement
ArgoCD › Sync Waves & Hooks

How do hooks differ from plain resources with sync waves, and when do you choose each?

Advanced

Answer

Sync waves order the ongoing desired-state resources that ArgoCD keeps reconciled. Hooks are transient, run per-sync (often deleted afterward), and tie to phases/failure—ideal for imperative one-off tasks like migrations or tests. Use waves for ordering persistent resources; use hooks for actions that should run around a sync but not be permanently managed.
Real-world example Persistent components use waves for ordering, while a one-time cache warm-up runs as a PostSync hook that's deleted after success.

Common follow-ups: Why are hooks better for one-off tasks? | Are hooks part of the desired state?

Applications GitOps Principles Sync Waves & Hooks
All 29 Sync Waves & Hooks questions