Depurar aplicações containerizadas envolve inspecionar logs, obter um shell dentro de contêineres, examinar configuração e estado, e diagnosticar problemas comuns (travamentos, conectividade, recursos). Saber como solucionar problemas é uma habilidade prática essencial.
docker ps -a
docker logs <container>
docker logs -f -- 100 <container>
docker inspect <container>
docker events
docker logs é geralmente o primeiro passo — mostra a saída e erros da aplicação. docker ps -a revela se um contêiner foi encerrado (e seu código de saída).
# run an interactive shell inside a RUNNING container to investigate
docker exec -it <container> bash # or sh (alpine)
# → inspect files, run commands, check the environment, test connectivity from inside
# if the container won't STAY running, override the entrypoint to get a shell
docker run -it --entrypoint sh myimage
docker exec -it ... bash fornece um shell dentro de um contêiner em execução — inestimável para inspecionar arquivos, verificar o ambiente e testar conectividade da perspectiva do contêiner.
Container EXITS immediately → check `docker logs`; the main process crashed or finished
(a container stops when its main process exits) — check CMD/ENTRYPOINT, errors
CAN'T CONNECT between containers → check they're on the same network; use service NAMES
(not localhost); verify ports; `docker network inspect`
PORT not accessible → check -p mapping; the app must listen on 0.0.0.0 (not 127.0.0.1)
OUT OF MEMORY / killed → check `docker stats`, resource limits (OOMKilled in inspect)
PERMISSION errors → file ownership/user (non-root user vs mounted volume permissions)
IMAGE issues → rebuild without cache (--no-cache); check the build context/.dockerignore
Saber como depurar e solucionar problemas em contêineres Docker é uma habilidade prática essencial, porque aplicações containerizadas inevitavelmente têm problemas (travamentos, problemas de conectividade, erros de configuração) que devem ser diagnosticados, e o ambiente containerizado adiciona uma camada que requer técnicas de depuração específicas.
As habilidades fundamentais — inspecionar logs (docker logs, geralmente o primeiro passo, mostrando a saída e erros da aplicação), verificar status (docker ps -a revelando se e por que um contêiner foi encerrado, incluindo códigos de saída), e examinar configuração/estado (docker inspect) — são como você começa a diagnosticar a maioria dos problemas.
Obter um shell dentro de um contêiner (docker exec -it ... bash) é uma técnica inestimável para investigar da perspectiva do contêiner — inspecionar arquivos, verificar o ambiente e testar conectividade — e saber como obter um shell mesmo quando um contêiner não permanece em execução (sobrescrevendo o entrypoint) lida com casos complicados.
Entender problemas comuns e seu diagnóstico é particularmente valioso: contêineres encerrando imediatamente (o processo principal travou ou finalizou — verificar logs e CMD/ENTRYPOINT), problemas de conectividade entre contêineres (associação à rede, usando nomes de serviço, não localhost), portas não acessíveis (mapeamento, e a pegadilha comum de que a aplicação deve ouvir em 0.0.0.0, não 127.0.0.1), kills por falta de memória e erros de permissão — esses são os problemas reais e recorrentes que saber como reconhecer e corrigir economiza tempo significativo.
Como aplicações containerizadas têm problemas que devem ser depurados, e como a solução de problemas eficaz (logs, exec em contêineres, inspect e reconhecimento de padrões de falha comuns) é necessária para diagnosticar e resolvê-los, saber como depurar contêineres Docker é uma habilidade prática essencial, frequentemente aplicada, para qualquer pessoa executando aplicações containerizadas, uma competência operacional central que transforma frustrantes problemas de contêiner em solucionáveis.