Deployment Troubleshooting
Start with Kubernetes readiness, service logs, ingress routing, identity provider configuration, database connectivity, and storage access.
Pods Are Not Ready
Section titled “Pods Are Not Ready”Inspect pod events and logs. Common causes include missing secrets, database connection failures, image pull failures, failed migrations, and invalid chart values.
Image Pull Fails
Section titled “Image Pull Fails”Confirm image pull secrets, registry mirror configuration, repository prefix overrides, and image tags from the release manifest.
Login Fails
Section titled “Login Fails”Confirm identity provider issuer, client IDs, redirect URIs, allowed origins, and Auth Service public URL configuration.
API Routes Fail
Section titled “API Routes Fail”Confirm ingress paths for Governance Service, Auth Service, and Integrity Service. Then verify service health and token validation behavior.