aks-deployment-troubleshooter

ImagePullBackOff occurs when a pod cannot pull its container image from a registry. Check pod status with kubectl, verify registry credentials and secrets are configured, confirm the image URI is correct, and ensure the node can reach the registry endpoint. The diagnostic flow identifies authentication failures, invalid image references, or network connectivity issues.

CrashLoopBackOff with exec format errors typically means the container image architecture doesn't match the node's processor architecture—for example, running an ARM image on an x86 node. Verify node architecture, check the image manifest for platform support, and redeploy with a compatible image build or add multi-architecture image layers to your Helm chart.

Platform mismatch errors occur when a container image lacks support for your node's architecture. Inspect the image manifest using registry tools, confirm your AKS node pool's processor type, and either rebuild the image for that platform or use a multi-architecture image. The workflow guides kubectl and helm commands to verify and resolve the mismatch.

Yes. The diagnostic workflow uses kubectl to inspect pod status, events, and logs, and helm to check deployment timeouts and configuration. Combined with registry secret checks, these tools form a structured process to identify root causes across image pull, crash loop, and architecture failure modes without requiring external monitoring tools.

Start by checking pod status and recent events with kubectl describe pod, then review container logs for startup errors. This reveals whether the failure is in image pull, container execution, or application startup. The diagnostic flow prioritizes these steps to quickly narrow the root cause—image access, compatibility, or configuration.

Helm deployment timeouts often stem from unresolved image pulls or unhealthy pods. The troubleshooter guides you to verify image availability, registry authentication, and node readiness before adjusting Helm timeout settings. Configuration adjustments and remediation steps address the underlying failure, not just the symptom.