Problemas Comuns: Debugando na Matrix 🐛

╔═══════════════════════════════════════════════════════════════════════╗
║  DOCKER TROUBLE MATRIX                                                ║
║                                                                       ║
║  [ERROR] - Permission denied                                          ║
║  [ERROR] - Port already in use                                        ║
║  [ERROR] - No space left on device                                    ║
║  [ERROR] - Cannot connect to the Docker daemon                        ║
║                                                                       ║
╚═══════════════════════════════════════════════════════════════════════╝

Problemas de Permissão 🔒

Sintoma

Got permission denied while trying to connect to the Docker daemon socket

Solução

# Adicione seu usuário ao grupo docker
sudo usermod -aG docker $USER

# Recarregue os grupos (ou faça logout/login)
newgrp docker

Conflito de Portas 🔌

Sintoma

Error: Ports are not available: listen tcp 0.0.0.0:3000: bind: address already in use

Solução

# Encontre o processo usando a porta
sudo lsof -i :3000

# Mate o processo (substitua PID)
sudo kill -9 PID

# OU use uma porta diferente
docker run -p 3001:3000 minha-app

Sem Espaço em Disco 💾

Sintoma

no space left on device

Solução

# Limpe recursos não utilizados
docker system prune -a --volumes

# Verifique o uso de espaço
docker system df

Daemon Offline 👻

Sintoma

Cannot connect to the Docker daemon at unix:///var/run/docker.sock

Solução

# Verifique o status do serviço
sudo systemctl status docker

# Reinicie o daemon
sudo systemctl restart docker

Waifu Tips 💡

Problemas de Rede 🌐

Sintoma

ERROR: Network gateway has conflicts with existing routes

Solução

# Recrie a rede default
docker network prune
docker network create bridge

Problemas de Build 🏗️

Sintoma

Step 3/8 : RUN npm install
npm ERR! code ECONNREFUSED

Solução

# Verifique sua conexão
ping 8.8.8.8

# Use mirror alternativo
npm config set registry https://registry.npmmirror.com

Checklist de Debug ✅

Verifique logs
docker logs <container-id>
Inspecione o container
docker inspect <container-id>
Entre no container
docker exec -it <container-id> sh
Monitore recursos
docker stats

Prevenção é o Melhor Remédio 💊

Boas Práticas

Use .dockerignore apropriadamente
Mantenha imagens base atualizadas
Implemente health checks
Monitore uso de recursos
Faça backup de volumes importantes

Ferramentas Úteis

Portainer (GUI para gestão)
ctop (top para containers)
lazydocker (TUI amigável)
docker-compose (orquestração local)

Modo Hardcore: Debugging Avançado 🔍

Análise de Sistema

# Verifique limites do sistema
ulimit -a

# Monitore eventos do Docker
docker events

# Debug de rede
docker network inspect bridge

Logs Avançados

# Logs em tempo real com timestamp
docker logs -f --timestamps <container-id>

# Últimas 100 linhas
docker logs --tail 100 <container-id>

Recursos de Emergência 🚨

15 abril 2025