Argo CD is a Kubernetes controller that continuously compares the live cluster to manifests in Git and syncs any drift, giving you declarative, auditable, self-healing deployments.
Why teams use it
- Git becomes the single source of truth for what runs in the cluster
- Automatic drift detection and self-healing back to the declared state
- A clear UI and history of every sync, with one-click rollback
Install it
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
kubectl -n argocd get podsA first working config
An Application that tracks a Git path and self-heals.
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata: { name: web, namespace: argocd }
spec:
project: default
source:
repoURL: https://github.com/acme/deploy.git
targetRevision: main
path: apps/web
destination:
server: https://kubernetes.default.svc
namespace: web
syncPolicy:
automated: { prune: true, selfHeal: true }
syncOptions: [CreateNamespace=true]Run and verify
argocd app sync web
argocd app get web
argocd app history web
argocd app rollback web 3Mistakes to avoid early
- Letting people kubectl apply straight to the cluster, causing endless drift
- Auto-sync without prune, leaving orphaned resources behind
- Storing plaintext secrets in the Git repo
Want senior help putting Argo CD to work - or a team bootcamp on it? CodeWizard runs Israel's largest DevOps community and embeds named senior engineers with a transparent hours log. Book a free consult or explore the Academy.