로그와 종료 코드로 실패 조사하기 · Docker
실패하는 컨테이너를 직접 만들고 재시작 전에 근거부터 확인합니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
표준 출력과 오류
docker logs는 로깅 드라이버가 제공하는 주 프로세스의 표준 출력·오류를 확인합니다. 파일에만 쓰는 로그가 자동으로 전부 보이는 것은 아닙니다.
종료 코드
0이 아닌 종료 코드는 실패의 단서입니다. 숫자만 보고 원인을 단정하지 말고 애플리케이션 메시지와 실행 설정을 함께 읽습니다.
최소 수정
일부러 exit 7을 실행한 컨테이너를 재시작해도 같은 명령이 다시 실패합니다. 원인을 수정한 새 실행과 비교하는 편이 유용합니다.
왜 필요한가요?
종료 코드는 프로세스가 남긴 단서이며 로그와 함께 읽어야 합니다. 같은 숫자라도 프로세스 종료, 런타임 오류, 강제 종료의 원인이 같다고 단정할 수 없습니다.
차례대로 이해하기
관찰 자료를 먼저 확보
ps -a에서 상태를 보고 logs에서 마지막 메시지를 확인합니다. inspect의 ExitCode, OOMKilled, Error, 시작·종료 시각을 함께 적으면 단순 재시작으로 증거를 잃는 일을 줄일 수 있습니다.
작은 변경으로 가설 확인
실습의 exit 7은 의도한 실패입니다. 이미지 교체·메모리 변경·네트워크 변경을 한꺼번에 하기보다 실행 명령 한 가지를 수정하고 새 결과를 비교하면 원인과 결과를 연결할 수 있습니다.
직접 실행하며 익혀보세요.
Docker Engine 또는 Docker Desktop(Linux 컨테이너), Compose v2, POSIX 셸과 curl이 필요합니다. 개인 실습 호스트에서 실행하고 study- 접두사의 리소스만 정리하세요. 이미지 다운로드에 네트워크가 필요합니다.
의도적으로 실패하는 명령을 실행한 뒤 로그와 상태를 수집하세요. 첫 docker run의 실패는 예상한 결과이며 뒤 명령은 계속 실행합니다.
docker run --name study-failure busybox:1.36 sh -c 'echo missing-demo-setting >&2; exit 7' || test "$?" -eq 7
docker logs study-failure
docker inspect --format 'exit={{.State.ExitCode}} oom={{.State.OOMKilled}}' study-failure
docker run --rm busybox:1.36 sh -c 'echo setting-ok; exit 0'이렇게 확인하세요
로그의 missing-demo-setting과 종료 코드 7을 함께 확인하세요. OOMKilled가 false인 경우 이 예시를 메모리 부족으로 단정하면 안 됩니다. 마지막 수정 실행은 setting-ok와 종료 코드 0을 남깁니다.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
docker rm study-failure응용해보기
종료 코드가 137이지만 OOMKilled=false입니다. 메모리 제한을 높이는 결론을 바로 낼 수 있을까요?
생각해본 뒤 풀이 보기
불충분합니다. SIGKILL을 받은 다른 경로가 있는지 종료 시각, 호스트 이벤트, stop 과정 등을 확인합니다. 코드 한 개로 자원 부족을 단정하지 않고 로그와 상태를 맞춰야 합니다.
잠깐, 이해했는지 확인해볼까요?
exit 7을 실행하도록 설정된 컨테이너를 반복 재시작하면?
- 이미지가 자동 수정됨
- 같은 명령이 다시 실패할 수 있음
- 볼륨이 자동 백업됨
- 반드시 성공함
생각해본 뒤 풀이 보기
같은 명령이 다시 실패할 수 있음
재시작은 잘못된 명령 자체를 수정하지 않습니다. 로그와 설정을 근거로 원인을 고친 뒤 재실행해야 합니다.