컨테이너 실행 장애를 조사시키는 디버깅 프롬프트

언제 사용하나

컨테이너가 곧바로 종료되거나 재시작을 반복해 애플리케이션이 안 뜰 때.

요청 전 확인

• 컨테이너 로그와 종료 코드, 이벤트를 확보한다.
• 변경된 이미지/환경변수/리소스 제한을 파악한다.

복사해서 쓰는 프롬프트

아래 컨테이너 실행 장애를 조사해줘. 파괴적 명령을 기본 해법으로 제시하지 말고 원인부터 좁혀줘.

증상: {{SYMPTOM}}
컨테이너 로그: {{LOGS}}
종료 코드/이벤트: {{EXIT_INFO}}
설정(이미지/env/리소스): {{CONFIG}}

원하는 출력:
1. 가장 가능성 높은 원인(설정 오류, 헬스체크 실패, OOM, 포트 충돌 등)
2. 확인 순서와 각 단계에서 볼 로그/명령
3. 안전한 수정안(비파괴적 우선)
4. 재발 방지를 위한 헬스체크/리소스 설정 제안

placeholder 설명

• {{SYMPTOM}} : 증상(즉시 종료/재시작 반복 등)
• {{LOGS}} : 컨테이너 로그
• {{EXIT_INFO}} : 종료 코드와 이벤트
• {{CONFIG}} : 이미지/환경/리소스 설정

입력 예시

{{SYMPTOM}} = "컨테이너가 시작 직후 Exited (137)"

기대 결과

원인 후보, 확인 순서, 비파괴적 수정안.

검증 방법

docker logs와 docker inspect로 가설을 확인한 뒤 수정한다.

주의사항

• 종료 코드 137은 OOM일 수 있으니 리소스 제한부터 본다.

관련 문서

• Docker 로그: https://docs.docker.com/reference/cli/docker/container/logs/