Skip to content

Troubleshooting

Common Issues

My app won't deploy

  1. Check ArgoCD - Look for sync errors at argocd.145.220.72.21.nip.io
  2. Check the image exists - Browse Harbor for your image
  3. Verify the tag - Does values.yaml match the pushed image tag?
  4. Check pod logs - Click on your app in ArgoCD → Pods → Logs

Image push fails

# Make sure you're logged in
docker login harbor.145.220.72.21.nip.io

# Check your image tag format
# Correct: harbor.145.220.72.21.nip.io/your-team/app:v1.0.0
# Wrong:   your-team/app:v1.0.0

"ImagePullBackOff" error

This means Kubernetes can't pull your image. Check:

  • Image exists in Harbor
  • Image tag is correct in values.yaml
  • No typos in repository name

App shows old version

  1. Verify ArgoCD shows "Synced" status
  2. Check the running pod's image tag in ArgoCD
  3. Hard refresh your browser: Ctrl+Shift+R
  4. Check if GitHub Actions completed successfully

Container crashes on startup

Check your Dockerfile:

# Test locally first
docker build -t test .
docker run -p 8080:80 test
# Visit http://localhost:8080

Common issues:

  • Missing dependencies
  • Wrong port exposed
  • File permission errors

"CrashLoopBackOff" error

Your container keeps crashing. Check:

  1. Pod logs in ArgoCD
  2. Does your app need environment variables?
  3. Is the health check path correct?

Getting Help

If you're still stuck, contact your TA with:

  • Your team name
  • What you're trying to do
  • Screenshots of error messages
  • Link to your ArgoCD application

Useful Commands

If you have kubectl access:

# View pod status
kubectl get pods -n your-team

# View pod logs
kubectl logs -n your-team deployment/your-app

# Describe pod (shows events)
kubectl describe pod -n your-team <pod-name>