ArgoCD › GitOps Principles

What is idempotency and why does it matter in GitOps?

Beginner

Answer

Idempotency means applying the same declared state repeatedly yields the same result. GitOps relies on it: the agent can reconcile continuously and safely re-apply desired state without side effects, so the cluster converges to Git regardless of its current state.
Real-world example Reconciling the same manifest ten times leaves the cluster identical to reconciling it once.

Common follow-ups: Why is idempotency needed for reconciliation? | How does it enable self-healing?