Course contentsShow
← Cloud and Infrastructure
Lesson 1884 of 2,98940. ArgoCDFree lesson

Sync Policies and Manual vs Auto Sync

Configure whether applications sync automatically or require manual approval.

Sync Policies and Manual vs Auto Sync

What you'll learn: How to configure ArgoCD applications to sync automatically or require manual approval before deploying changes.

The Core Idea

When you define an ArgoCD Application resource, you control when and how changes from your Git repository get applied to your Kubernetes cluster. Sync policies determine whether ArgoCD automatically deploys changes the moment it detects drift (auto sync), or waits for a human to click "Sync" (manual sync).

Think of it like package delivery: manual sync is like requiring a signature—the package (your deployment) sits at your door until you explicitly approve it. Auto sync is like authorizing "leave at door"—the moment it arrives, it's deployed.

Manual Sync (Default Behavior)

By default, ArgoCD detects when your live cluster state differs from Git, but does nothing until you manually trigger a sync. This gives you:

  • Control: Review changes before they hit production
  • Safety: Prevent accidental deployments during off-hours
  • Auditability: Clear human approval points

Auto Sync

Adding an auto sync policy makes ArgoCD immediately reconcile any detected drift:

apiVersion: argoproj.io/v1alpha1
kind: Application
spec:
  syncPolicy:
    automated: {}

This enables true continuous deployment—commits to Git instantly deploy to your cluster.

You can add safeguards like:

syncPolicy:
  automated:
    prune: true      # Delete resources removed from Git
    selfHeal: true   # Revert manual kubectl changes

Choosing Your Strategy

  • Manual sync: Best for production, high-risk environments, or when you need change windows
  • Auto sync: Ideal for development, staging, or when you trust your Git workflow completely

Key Takeaway: Sync policies let you balance automation with safety—manual sync gives you approval gates, while auto sync enables hands-free GitOps continuous deployment.