DEV WIKI
인프라 · 기술

Docker

Docker는 애플리케이션과 실행 환경을 이미지와 컨테이너로 패키징하고 실행하는 도구입니다.

정상 동작 조건

요약

Docker 문제를 확인할 때는 이미지 빌드 결과와 컨테이너 실행 결과를 분리하고, 종료 코드·로그·환경 변수·볼륨 경로를 같은 실행 단위에서 확인해야 합니다.

확인 절차

Docker 이미지는 실행에 필요한 파일과 설정을 묶은 결과이고, 컨테이너는 그 이미지를 사용해 실행한 단위입니다. 이미지 빌드가 성공해도 컨테이너의 시작 명령, 환경 변수, 권한과 볼륨 경로가 잘못되면 실행이 중단될 수 있습니다.

컨테이너가 실행되지 않을 때

  1. 이미지 이름과 태그, 실제 실행한 명령을 기록합니다.
  2. docker ps -a의 종료 상태와 docker logs의 첫 오류를 확인합니다.
  3. 컨테이너 안에서 필요한 환경 변수와 파일 경로가 존재하는지 확인합니다.
  4. 호스트 경로를 마운트했다면 읽기·쓰기 권한과 컨테이너 내부 경로를 비교합니다.

컨테이너가 시작 직후 종료되는 경우 Docker 컨테이너 시작 실패 가이드 (새 창에서 열림)를 확인합니다.

참고 자료

Get started with Docker (새 창에서 열림)

Docker · 공식 자료 · 확인 범위: images, containers, container-lifecycle · 확인일: 2026-07-27