Docker container를 어떻게 디버깅하고 문제를 해결합니까?

Question

IT Interview Practice · Accepted Answer

컨테이너화된 애플리케이션을 디버깅하는 것은 **로그** 검사, container 내부의 **셸** 얻기, **구성과 상태** 조사, 흔한 문제(크래시, 네트워킹, 리소스) 진단을 수반합니다. 문제 해결 방법을 아는 것은 필수적인 실용 기술입니다. ## 로그와 상태 검사 ```bash docker ps -a # container 상태 확인(실행 중? 종료됨? 종료 코드?) docker logs # container의 출력(stdout/stderr) 보기 — 여기서 시작 docker logs -f --tail 100 # 실시간 follow, 마지막 100줄 docker inspect # 전체 구성/상태를 JSON으로(환경 변수, 마운트, 네트워크 등) docker events # Docker 데몬 이벤트 스트림 ``` `docker logs`는 보통 **첫 단계**입니다 — 애플리케이션의 출력과 오류를 보여줍니다. `docker ps -a`는 container가 종료되었는지(그리고 종료 코드)를 드러냅니다. ## container 내부로 들어가기 ```bash # 조사를 위해 실행 중인 container 내부에서 대화형 셸 실행 docker exec -it bash # 또는 sh(alpine) # → 파일 검사, 명령 실행, 환경 확인, 내부에서 연결성 테스트 # container가 계속 실행되지 않으면, entrypoint를 재정의하여 셸을 얻음 docker run -it --entrypoint sh myimage ``` `docker exec -it ... bash`는 실행 중인 container 내부의 셸을 제공합니다 — 파일 검사, 환경 확인, container 관점에서의 연결성 테스트에 매우 유용합니다. ## 흔한 문제와 진단 ```text container가 즉시 종료됨 → `docker logs` 확인; 메인 프로세스가 크래시했거나 끝남 (container는 메인 프로세스가 종료되면 멈춤) — CMD/ENTRYPOINT, 오류 확인 container 간 연결 불가 → 같은 네트워크에 있는지 확인; 서비스 이름 사용 (localhost 아님); 포트 확인; `docker network inspect` 포트 접근 불가 → -p 매핑 확인; 앱이 0.0.0.0에서 수신 대기해야 함(127.0.0.1 아님) 메모리 부족 / killed → `docker stats`, 리소스 제한 확인(inspect에서 OOMKilled) 권한 오류 → 파일 소유권/사용자(비루트 사용자 대 마운트된 volume 권한) image 문제 → 캐시 없이 재빌드(--no-cache); 빌드 컨텍스트/.dockerignore 확인 ``` ## 왜 중요한가 Docker container를 디버깅하고 문제를 해결하는 방법을 아는 것은 필수적인 실용 기술입니다. 컨테이너화된 애플리케이션은 필연적으로 진단해야 하는 문제(크래시, 연결 문제, 구성 오류)를 가지며, 컨테이너화된 환경은 특정 디버깅 기법을 요구하는 계층을 추가하기 때문입니다. 기초 기술 — **로그** 검사(`docker logs`, 보통 첫 단계, 애플리케이션의 출력과 오류를 보여줌), **상태** 확인(`docker ps -a`가 container가 종료되었는지와 그 이유를 종료 코드를 포함해 드러냄), **구성/상태** 조사(`docker inspect`) — 는 대부분의 문제를 진단하기 시작하는 방법입니다. **container 내부의 셸 얻기**(`docker exec -it ... bash`)는 container 관점에서 조사하는 매우 유용한 기법입니다 — 파일 검사, 환경 확인, 연결성 테스트 — 그리고 container가 계속 실행되지 않을 때도 셸을 얻는 방법(entrypoint 재정의)을 아는 것은 까다로운 경우를 처리합니다. **흔한 문제와 그 진단**을 이해하는 것은 특히 가치가 있습니다. container 즉시 종료(메인 프로세스가 크래시했거나 끝남 — 로그와 CMD/ENTRYPOINT 확인), container 간 연결 문제(네트워크 멤버십, localhost가 아닌 서비스 이름 사용), 포트 접근 불가(매핑, 그리고 앱이 127.0.0.1이 아닌 0.0.0.0에서 수신 대기해야 하는 흔한 함정), 메모리 부족 kill, 권한 오류 — 이것들은 인식하고 고치는 방법을 아는 것이 상당한 시간을 절약하는 실제적이고 반복되는 문제입니다. 컨테이너화된 애플리케이션은 디버깅해야 하는 문제를 가지고, 효과적인 문제 해결(로그, container로 exec, inspect, 흔한 실패 패턴 인식)이 그것들을 진단하고 해결하는 데 필요하므로, Docker container 디버깅 방법을 아는 것은 컨테이너화된 애플리케이션을 실행하는 모든 사람에게 필수적이고 자주 적용되는 실용 기술이며, 좌절스러운 container 문제를 해결 가능한 것으로 바꾸는 핵심 운영 역량입니다.

로그와 상태 검사

container 내부로 들어가기

흔한 문제와 진단

왜 중요한가

관련 질문