Kubernetes Troubleshooting

This page covers common issues encountered during a Kubernetes deployment. For issues specific to zero-downtime image updates, see Rolling Updates.

Common Issues

Pods Not Starting

kubectl describe pod <pod-name> -n kmi
kubectl logs <pod-name> -n kmi

Image Pull Errors

# Verify registry authentication
docker login <registry-url>

# Verify the image pull secret exists
kubectl get secret <your-pull-secret> -n kmi

Storage Issues

# Check storage classes
kubectl get storageclass

# Check PVC status
kubectl get pvc -n kmi

Ingress Not Working

# Check the ingress controller
kubectl get pods -n ingress-nginx

# Check the ingress configuration
kubectl describe ingress kafka-mobility-intelligence-frontend -n kmi

Getting Help

1. Check the application logs for error messages.
2. Verify all prerequisites are met.
3. Ensure registry authentication is working.
4. Check that the required storage classes exist.
5. Verify the ingress controller is running.

For additional support, provide the following:

kubectl get pods,svc,ingress -n kmi
kubectl describe pod <failing-pod> -n kmi
kubectl logs <failing-pod> -n kmi

Include your .env file with sensitive values removed.