Docker
컨테이너는 실행 중인데 접속이 안 될 때
Docker 볼륨이나 포트 설정은 작은 실수 하나로 전체 시스템이 막힌다. 문제를 크게 잡지 말고 작은 단위로 확인하자.
컨테이너가 떠있는데 접속이 안 되는 상황은 정말 답답하다. 로그를 봐도 에러가 없는데 외부에서 접속만 안 된다. 대부분 포트 매핑이나 환경 변수 문제인데 찾기가 어렵다.
재현 가능한 단서를 먼저 남기면 다음 확인이 훨씬 쉬워진다.
상황 정리하기
문제를 크게 잡으면 모든 파일이 의심스러워진다. 정확히 무엇이 실패했는지 좁혀야 한다.
- 컨테이너 상태 확인
- 정상일 때의 컨테이너 상태
- 기록할 사항: 명령어 출력, 상태 코드, 설정 변경사항
기본 디버깅 명령어
환경 변수와 포트 매핑을 확인해보자. 컨테이너 안에 올바른 설정이 있는지 직접 본다.
docker ps
docker logs --tail=100 service-name
docker inspect service-name
작은 실험부터
- 같은 조건에서 접속 실패가 반복되는지 확인
- 로그와 응답에서 변화 정리
- 실제 환경에서 최종 테스트
결과가 바뀐 이유를 로그와 응답으로 설명할 수 있으면 충분히 정리된 것이다.