All 29 Sync & Health questions
More in Sync & Health
How does ArgoCD assess Deployment health specifically? What is the Suspended health status? How do you skip health assessment or diff for specific fields? How does ServerSideApply help with large or conflicting resources? How can you customize health checks for third-party or custom resources? How do you implement progressive delivery (canary/blue-green) with ArgoCD? How do you prevent auto-sync from applying an unwanted change during an incident? How do you monitor ArgoCD itself (metrics and observability)? How do you debug why an app never reaches Healthy after a successful sync? How do sync windows control when syncs are allowed?
Advertisement
ArgoCD › Sync & Health

How do you handle CRDs and their custom resources syncing in the right order?

Advanced

Answer

CRDs must exist before their custom resources apply. Use sync waves to install CRDs first (lower wave), or the SkipDryRunOnMissingResource sync option so ArgoCD doesn't fail validation when the CRD isn't yet present. For operators, install the operator/CRDs in an earlier wave or a separate app before workloads that use them.
metadata:
  annotations:
    argocd.argoproj.io/sync-options: SkipDryRunOnMissingResource=true
    argocd.argoproj.io/sync-wave: "-1"   # CRDs first
Real-world example CRDs are placed in wave -1 so custom resources in wave 0 don't fail with 'no matches for kind' during sync.

Common follow-ups: Why can a CR fail to apply before its CRD? | What does SkipDryRunOnMissingResource do?

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