All 29 Sync Waves & Hooks questions
More in Sync Waves & Hooks
How do sync waves and hooks interact? What are hook deletion policies? How do you run a database migration safely before deploying a new version? What is a Skip hook and when is it used? How long does ArgoCD wait between sync waves? What is a PreSync hook typically used for? 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?
Advertisement
ArgoCD › Sync Waves & Hooks

How are hook resources named and prevented from clashing across syncs?

Intermediate

Answer

Hooks are typically generated with unique names (e.g., using generateName) or cleaned up via BeforeHookCreation so a new sync doesn't collide with a leftover from a prior run. Because Jobs are immutable in key fields, reusing a fixed name without deletion causes apply errors, so deletion policies or unique names are important.
metadata:
  generateName: migrate-
  annotations:
    argocd.argoproj.io/hook: PreSync
    argocd.argoproj.io/hook-delete-policy: BeforeHookCreation
Real-world example Each sync's migration Job gets a unique generated name, avoiding conflicts with the previous run's Job.

Common follow-ups: Why do fixed-name Jobs cause conflicts? | What does BeforeHookCreation prevent?

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