What's Actually Happening

ArgoCD application shows OutOfSync but sync is not triggered or fails.

The Error You'll See

```bash $ argocd app get myapp

Status: OutOfSync Sync Status: Unknown Conditions: RepoError: Unable to resolve revision ```

Why This Happens

  1. 1.Repo access failed - Git credentials expired
  2. 2.Auto-sync disabled - Manual sync required
  3. 3.Sync window - Sync blocked by maintenance window
  4. 4.Resource conflict - Apply fails due to conflicts

Step 1: Check App Status

```bash # Get app details: argocd app get myapp

# Check sync status: argocd app get myapp --refresh

# Check conditions: argocd app get myapp -o jsonpath='{.status.conditions}' ```

Step 2: Test Repository Access

```bash # Test repo connection: argocd repo list

# Or manually: git ls-remote https://github.com/org/repo.git ```

Step 3: Fix Auto-Sync

```bash # Enable auto-sync: argocd app set myapp --sync-policy automated

# Or in YAML: spec: syncPolicy: automated: prune: true selfHeal: true ```

Step 4: Force Sync

```bash # Manual sync: argocd app sync myapp

# Force sync: argocd app sync myapp --force

# With prune: argocd app sync myapp --prune ```

ArgoCD Sync Checklist

CheckCommandExpected
Repo accessargocd repo listConnected
Auto-syncapp getEnabled
Sync statusapp getSynced

Verify the Fix

bash
argocd app get myapp
# Output: Status: Healthy, Synced
  • [Fix ArgoCD Sync Timeout](/articles/fix-argocd-sync-timeout)
  • [Fix ArgoCD Sync Conflict](/articles/fix-argocd-sync-conflict)