Docker 이미지 로딩이 에뮬레이터와 실기기에서 다를 때

Docker 이미지는 로컬 개발 환경과 배포 환경에서 완전히 다르게 동작할 수 있다.

핵심 질문 먼저 정하기

이미지 로딩이 실패했을 때는 먼저 뭐가 문제인지 좁혀야 한다.

• 컨테이너는 떠 있나: 실제로 running 상태인가
• 포트 매핑은 맞나: 호스트와 컨테이너 포트가 제대로 연결됐나
• 로그에는 뭐가 있나: 이미지 로드 에러는 없나

원인 제외하기

일반적인 원인들을 먼저 확인하자.

• 환경변수: 이미지 경로가 제대로 설정됐나
• 권한: 이미지 파일에 읽기 권한이 있나
• 네트워크: 외부 URL에서 이미지를 로드하는 건 아닌가

로그와 상태 확인

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

확인과 검증

1. 증상이 다시 나는지 확인한다
2. 로그에서 뭐가 달라졌는지 본다
3. 실제 배포 후 이미지가 제대로 로드되는지 확인한다

결과 기록하기

한 번에 여러 설정을 바꾸지 말고, 하나씩 바꾼 후 기록해 두자.