Hoe debug en troubleshoot je Docker containers?

Question

Accepted Answer

Het debuggen van gecontaineriseerde applicaties omvat het inspectie van **logs**, het krijgen van een **shell in containers**, het onderzoeken van **configuratie en state**, en het diagnosticeren van veelvoorkomende problemen (crashes, netwerking, resources). Het weten hoe je moet troubleshooten is een essentiële praktische vaardigheid. ## Logs en status inspectie ```bash docker ps -a # see container status (running? exited? exit code?) docker logs # view the container's output (stdout/stderr) — start here docker logs -f --tail 100 # follow live, last 100 lines docker inspect # full config/state as JSON (env, mounts, network, etc.) docker events # stream Docker daemon events ``` `docker logs` is meestal de **eerste stap** — het toont de output en fouten van de applicatie. `docker ps -a` laat zien of een container is afgesloten (en de exit code). ## Naar binnen in een container ```bash # run an interactive shell inside a RUNNING container to investigate docker exec -it 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` geeft je een shell in een actieve container — onmisbaar voor het inspectie van bestanden, het controleren van de omgeving, en het testen van connectiviteit vanuit het perspectief van de container. ## Veelvoorkomende problemen en diagnose ```text 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 ``` ## Waarom het belangrijk is Weten hoe je Docker containers moet debuggen en troubleshooten is een essentiële praktische vaardigheid, omdat gecontaineriseerde applicaties onvermijdelijk problemen hebben (crashes, connectiviteitsproblemen, configuratiefouten) die gediagnosticeerd moeten worden, en de gecontaineriseerde omgeving voegt een laag toe die specifieke debuggingtechnieken vereist. De basisvaardigheden — het inspectie van **logs** (`docker logs`, meestal de eerste stap, toont de output en fouten van de applicatie), het controleren van **status** (`docker ps -a` laat zien of en waarom een container is afgesloten, inclusief exit codes), en het onderzoeken van **configuratie/state** (`docker inspect`) — zijn hoe je begint met het diagnosticeren van de meeste problemen. Een **shell in een container krijgen** (`docker exec -it ... bash`) is een onmisbare techniek voor het onderzoeken vanuit het perspectief van de container — inspectie van bestanden, het controleren van de omgeving, en het testen van connectiviteit — en weten hoe je een shell krijgt zelfs wanneer een container niet blijft draaien (het overridden van het entrypoint) handelt lastige gevallen af. Het begrijpen van **veelvoorkomende problemen en hun diagnose** is bijzonder waardevol: containers die onmiddellijk afsluiten (het hoofdproces is gecrasht of klaar — logs en CMD/ENTRYPOINT controleren), connectiviteitsproblemen tussen containers (netwerk-lidmaatschap, het gebruik van servicenamen niet localhost), poorten die niet toegankelijk zijn (mapping, en de veel voorkomende valkuil dat de app op 0.0.0.0 moet luisteren niet op 127.0.0.1), memory kills, en permissievouten — dit zijn de echte, terugkerende problemen die weten hoe je ze herkent en oplost aanzienlijke tijd bespaart. Omdat gecontaineriseerde applicaties problemen hebben die gediagnosticeerd moeten worden, en omdat effectieve troubleshooting (logs, exec in containers, inspect, en het herkennen van veelvoorkomende foutpatronen) nodig is om ze op te lossen, is het weten hoe je Docker containers debugt een essentiële, regelmatig toegepaste praktische vaardigheid voor iedereen die gecontaineriseerde applicaties uitvoert, een kernoperationele competentie die frustrerende containerprobllemen in oplosbare omzet.