Troubleshooting
Quick links to solve common problems.
Quick Checks
Before diving deep, verify the basics:
1. Did you push to main?
Only the main branch triggers deployments. Feature branches won't deploy.
git branch # Should show * main
git push origin main
2. Did GitHub Actions succeed?
Go to GitHub → your repo → Actions tab. Look for a green checkmark ✓.
If red ✗, click to see the build error.
3. Did you wait long enough?
Full pipeline takes 4-7 minutes. Be patient before troubleshooting.
4. Check your dashboards
Check the dashboards and logs (Grafana) and look for errors.
502 Bad Gateway
Your app isn't responding.
Fix: 2. Verify health check endpoint exists 3. Check logs for startup errors
Still Stuck?
Contact your lecturer or student assistant with:
- Your team name (e.g.,
2026-group01) - What you're trying to do
- Screenshots of error messages
- Links to GitHub Actions run and ArgoCD app
Most issues are simple
Check for typos, uncommitted changes, and wrong branch first. These cause 90% of problems.