← 전체 글로 돌아가기

Docker

컨테이너가 자꾸 재시작될 때 확인하는 방법

Docker 문제는 화면 하나만 보면 안 된다. 로그와 응답을 함께 봐야 원인이 보인다.

컨테이너가 이유 없이 재시작되면 보통 어디서부터 확인해야 할지 불명확하다. 중요한 건 컨테이너 전체 흐름을 따라가면서 재현 가능한 신호를 찾는 것이다.

사용자가 보는 증상 기록하기

Docker 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

개발자가 보는 신호 찾기

중요한 건 컨테이너 문제 자체보다 재현 가능한 단서를 남기는 것이다. 환경변수를 확인하면 다음으로 봐야 할 범위가 줄어난다.

  • 먼저 볼 값: 환경변수
  • 비교할 값: 정상 상태의 컨테이너
  • 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

환경변수와 로컬 차이 확인하기

컨테이너 주변 문제가 반복되면 확인 순서를 고정해두는 게 좋다. 감으로 접근하면 같은 실수를 반복한다.

docker ps
docker logs --tail=100 service-name
docker inspect service-name

수정 전에 고정할 값 정하기

컨테이너 주변 문제가 반복되면 확인 순서를 고정해두는 게 좋다. 감으로 접근하면 같은 실수를 반복한다.

포트 매핑과 검증 루틴

바로 수정하기 전에 로그부터 확인하면 불필요한 변경을 줄일 수 있다. 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어난다.

최종 확인 체크리스트

  1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
  2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해본다.
  3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

운영 메모

정상 상태를 먼저 정해두는 게 좋다. 그래야 컨테이너 상태가 맞는지 빠르게 판단할 수 있다. 해결 자체보다 어떤 값이 달라졌는지 설명할 수 있는 상태가 더 중요하다.