Docker·컨테이너 문제 해결

컨테이너 시작 실패, 이미지와 플랫폼 불일치, 볼륨 권한, 포트와 Compose 설정을 실행 상태와 로그로 구분합니다.

먼저 확인할 범위

이미지 태그, 호스트 아키텍처, 실제 마운트와 네트워크 구성을 변경 전에 저장하세요.

NPM의 /data와 /etc/letsencrypt 마운트를 구분하고, 인증서 소실을 새 볼륨·컨테이너 재생성·권한 문제로 나눠 봅니다.

임시 DB 예제로 SQLite 오류 14·8·1544를 확인하고 파일·부모 디렉터리·연결 설정을 구분합니다. 실제 앱 계정과 Rootless Podman UID 매핑을 읽는 방법도 살펴봅니다.

Compose 폴더를 옮긴 뒤 데이터가 사라져 보인다면 프로젝트 이름과 실제 연결 볼륨을 먼저 확인하세요. 더미 볼륨 A/B 실험으로 다른 저장소 연결과 데이터 삭제를 구분하고, 운영 볼륨을 건드리기 전 확인할 조건을 정리했습니다.

kube-prometheus-stack에서 ruleSelector를 지정한 뒤 기본 PrometheusRule이 로드되지 않는다면 먼저 defaultRules 생성 여부와 metadata.labels 선택 조건을 비교해 복구합니다.

WSL 커스텀 커널을 적용한 뒤 Docker Desktop이 시작되지 않을 때 WSL 버전, 실제 커널, .wslconfig를 기록하고 기본 커널로 되돌려 범위를 좁히는 절차입니다.

Docker 컨테이너에서 IP 통신은 되지만 이름 해석만 실패할 때 서비스 이름, 외부 DNS, host loopback을 분리하고 변경 전후를 검증하는 절차입니다.

Docker Compose 서비스가 시작 직후 사라질 때 전체 상태, 종료 코드, 로그, 실제 entrypoint를 같은 시점에 모아 정상 종료와 충돌을 구분하는 절차입니다.

Docker Compose에서 빈 환경 변수가 예상한 값을 덮을 때 보간 단계와 컨테이너 환경을 분리하고, 실제 적용 모델을 확인한 뒤 안전하게 재생성하는 절차입니다.