Hogyan debuggolsz és elhárítasz Docker containereket?

Question

Accepted Answer

A containerizált alkalmazások debuggolása magában foglalja a **logok** vizsgálatát, **shell-hozzáférés** szerzését a containerekben, a **konfiguráció és állapot** megtekintését, valamint a gyakori problémák diagnosztizálását (összeomlások, hálózatkezelés, erőforrások). A hibaelhárítás módszereinek ismerete alapvető gyakorlati készség. ## Logok és állapot vizsgálata ```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 ``` A `docker logs` általában az **első lépés** — megjeleníti az alkalmazás kimenetét és hibáit. A `docker ps -a` felfedi, hogy a container kilépett-e (és mi a kilépési kódja). ## Belépés a containerbe ```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 ``` A `docker exec -it ... bash` shell-hozzáférést biztosít egy futó containerben — felbecsülhetetlen értékű a fájlok vizsgálatához, a környezet ellenőrzéséhez és a kapcsolat teszteléséhez a container perspektívájából. ## Gyakori problémák és diagnosztizálás ```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 ``` ## Miért fontos A Docker containerek debuggolásának és hibaelhárításának ismerete alapvető gyakorlati készség, mivel a containerizált alkalmazásoknak elkerülhetetlenül vannak problémáik (összeomlások, kapcsolódási problémák, konfigurációs hibák), amelyeket diagnosztizálni kell, és a containerizált környezet egy olyan réteget ad hozzá, amely speciális debuggolási technikákat igényel. Az alapvető készségek — a **logok** vizsgálata (`docker logs`, általában az első lépés, az alkalmazás kimenetét és hibáit mutatja), az **állapot** ellenőrzése (`docker ps -a`, amely felfedi, hogy a container miért és hogyan lépett ki, beleértve a kilépési kódokat), és a **konfiguráció/állapot** megtekintése (`docker inspect`) — ezek az alapok a legtöbb probléma diagnosztizálásához. A **shell-hozzáférés szerzése a containerben** (`docker exec -it ... bash`) felbecsülhetetlen értékű technika a container perspektívájából történő vizsgálathoz — fájlok megtekintéséhez, a környezet ellenőrzéséhez és a kapcsolat teszteléséhez —, valamint annak ismerete, hogyan lehet shell-t szerezni akkor is, amikor a container nem marad futó (az entrypoint felülírásával) kezelhetővé teszi az összetett eseteket. A **gyakori problémák és diagnosztizálásuk** megértése különösen értékes: containerek azonnali kilépése (a fő folyamat összeomlott vagy befejeződött — logok és CMD/ENTRYPOINT ellenőrzése), containerek közötti kapcsolódási problémák (hálózati tagság, szolgáltatásnevek használata nem localhost), portok nem elérhetősége (port mapping, és az a gyakori hiba, hogy az alkalmazásnak 0.0.0.0-n kell hallgatnia, nem 127.0.0.1-en), memória kifogyása miatti kilépések, és engedély hibák — ezek a valódi, ismétlődő problémák, amelyeknek ismerete és megoldása jelentős időt takarít meg. Mivel a containerizált alkalmazásoknak vannak debuggolásra szoruló problémáik, és mivel az hatékony hibaelhárítás (logok, exec containerbe, inspect, és gyakori hibamintázatok felismerése) szükséges azok diagnosztizálásához és megoldásához, a Docker containerek debuggolásának ismerete alapvető, gyakran alkalmazott gyakorlati készség mindenkinek, aki containerizált alkalmazásokat futtat, egy olyan alapvető operatív kompetencia, amely a bosszantó container-problémákat megoldható kérdésekké alakítja.