What's Actually Happening

ArgoCD application does not sync with Git repository. Changes are not applied to the cluster.

The Error You'll See

```bash $ argocd app get myapp

Status: OutOfSync Health: Degraded ```

Why This Happens

  1. 1.Repository access denied
  2. 2.Sync policy disabled
  3. 3.Helm/Kustomize error
  4. 4.Cluster resource conflict
  5. 5.Webhook not configured

Step 1: Check Application Status

bash
argocd app get myapp
argocd app list
kubectl get applications -n argocd

Step 2: Check Repository

bash
argocd repo list
argocd repo get https://github.com/org/repo

Step 3: Check Sync Policy

bash
argocd app get myapp --show-params
# Ensure automated sync is enabled

Step 4: Manual Sync

bash
argocd app sync myapp
argocd app sync myapp --prune

Step 5: Check Logs

bash
kubectl logs -n argocd deployment/argocd-application-controller
kubectl logs -n argocd deployment/argocd-repo-server

Step 6: Check Events

bash
kubectl describe application myapp -n argocd
kubectl get events -n argocd --sort-by='.lastTimestamp'

Step 7: Refresh Application

bash
argocd app get myapp --refresh
argocd app refresh myapp

Step 8: Check Credentials

bash
argocd repo get https://github.com/org/repo
# Verify SSH key or token

Step 9: Check Resource Health

bash
argocd app resources myapp
kubectl get all -n myapp

Step 10: Hard Refresh

bash
argocd app get myapp --hard-refresh
kubectl rollout restart deployment/argocd-repo-server -n argocd
  • [Fix ArgoCD Sync Timeout](/articles/fix-argocd-sync-timeout)
  • [Fix Kubernetes Deployment Not Rolling Out](/articles/fix-kubernetes-deployment-not-rolling-out)