← 전체 글로 돌아가기

Docker

Docker 이미지 로딩이 느릴 때 디버깅

Docker 컨테이너 배포 후 이미지가 느리게 로드될 때, 체계적으로 원인을 찾는 방법.

배포 후 이미지 로딩이 이상하다면, 검색해서 온 상황이므로 바로 재현 조건부터 잡는 게 빠르다. 하지만 그 전에 정상 상태를 먼저 정의해야 한다.

현재 상황 파악하기

Docker 쪽 문제는 화면만 봐서는 알 수 없다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

  • 먼저 볼 값: 환경변수와 컨테이너 상태
  • 비교할 값: 정상일 때의 상태
  • 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정
docker ps
docker logs --tail=100 service-name
docker inspect service-name

이미지 태그 확인의 중요성

환경변수와 이미지 태그가 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않는다. 따라서 이들을 가장 먼저 확인해야 한다.

  1. 증상이 같은 조건에서 다시 나는지 확인한다.
  2. 로그에서 바뀐 부분을 한 줄로 설명해본다.
  3. 포트 매핑과 컨테이너 상태를 최종 확인한다.

해결 자체보다 어떤 값이 달라졌는지 설명할 수 있는 상태가 더 중요하다. 기록을 남겨두면 다음 확인이 훨씬 빨라진다.