Tabela – Kubernetes Errors (Cause / Fix) | Kubernetes
- Tabela – Kubernetes Errors (Cause / Fix) | Kubernetes
Principais erros (Top 1–20)
| Erro | Causa | Correção |
|---|---|---|
| CrashLoopBackOff | App crash / comando errado | Ajustar entrypoint / logs |
| ImagePullBackOff | Nome da imagem ou credencial | Validar imagem / registry |
| ErrImagePull | Imagem inexistente | Corrigir URL |
| CreateContainerConfigError | Config inválida | Revisar ConfigMap/Secret |
| CreateContainerError | Erro ao criar container | Verificar volumes / imagem |
| RunContainerError | Falha ao iniciar | Logs / permissões |
| OOMKilled | Estouro de memória | Ajustar limits |
| Back-off restarting | Falha contínua | Corrigir bug / logs |
| NodeNotReady | Node indisponível | Reiniciar / kubelet |
| PodUnschedulable | Sem recursos | Ajustar nodes |
| NodeAffinity conflict | Afinidade inválida | Ajustar labels |
| PVC Pending | Sem volume | Criar PV |
| VolumeMountError | Problema volume | Revisar mount |
| DeadlineExceeded | Timeout job | Aumentar tempo |
| InvalidImageName | Nome inválido | Corrigir tag |
| Secret not found | Secret inexistente | Criar secret |
| ConfigMap not found | ConfigMap faltando | Criar config |
| NodeSelector mismatch | Node não bate | Ajustar selector |
| Invalid container port | Porta incorreta | Corrigir spec |
| FailedScheduling | Sem node | Ver recursos |
📌 Fonte:
Rede, probes e serviços
| Erro | Causa | Correção |
|---|---|---|
| Service not reachable | Selector errado | Corrigir labels |
| DNS resolution failed | CoreDNS falhando | Reiniciar DNS |
| LoadBalancer pending | Cloud não provisionou | Validar integração |
| Service endpoints empty | Sem pods | Ajustar selector |
| Wrong targetPort | Porta errada | Corrigir service |
| ClusterIP unreachable | IPTables / kube-proxy | Reiniciar |
| Pod IP unreachable | CNI falhando | Ver plugin |
Storage / Volumes
| Erro | Causa | Correção |
|---|---|---|
| Unbound PVC | PV não encontrado | Criar PV compatível |
| Multi-Attach error | Volume em uso | Usar RWX |
| VolumeMount fails | Read-only | Ajustar config |
| PVC zone conflict | Zona errada | Ajustar scheduling |
| Volume stuck terminating | Finalizer | Remover manual |
Segurança / RBAC / Policies
| Erro | Causa | Correção |
|---|---|---|
| RBAC access denied | Permissão insuficiente | Criar RoleBinding |
| Unauthorized | Token expirado | Renovar credenciais |
| PodSecurityPolicy violation | Policy bloqueando | Ajustar PSP |
| Admission webhook denied | Validação falhou | Corrigir config |
| NetworkPolicy bloqueio | Egress bloqueado | Liberar regras |
Performance / Recursos
| Erro | Causa | Correção |
|---|---|---|
| Pod evicted | Falta de recurso | Escalar nodes |
| Node disk full | Disco cheio | Limpar |
| Too many open files | Limite SO | Ajustar ulimit |
| API throttling | Muitas requests | Retry/backoff |
| QoS eviction | Requests/limits ruins | Ajustar QoS |
Deploy / CI/CD / Helm
| Erro | Causa | Correção |
|---|---|---|
| Deployment rollout stuck | Pods indisponíveis | Ver health |
| Helm release failed | Chart inválido | Validar |
| Helm rollback failed | Estado inconsistente | Ajustar recursos |
| Deployment loop | Template errado | Corrigir hash |
| PodDisruptionBudget block | Restrição rollout | Ajustar PDB |
Observabilidade / Logs
| Erro | Causa | Correção |
|---|---|---|
| Logs não aparecem | Storage cheio | Rotação |
| Container can't write logs | Permissão | Ajustar volume |
| Logs perdidos após crash | Ephemeral storage | Centralizar logs |
Cluster / Infra
| Erro | Causa | Correção |
|---|---|---|
| API server not reachable | Rede/cert | Validar control plane |
| Kubelet not registering | Falha node | Reiniciar |
| Node cordoned | Node bloqueado | Uncordon |
| ContainerCreating infinito | Runtime travado | Restart node |
| Kube-proxy fails | IPTables | Reset rules |