인프라 · 기술

Docker

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

적용 범위: Docker의 개념·동작을 확인해야 하는 공개 웹 환경문맥: 바이브 코딩
출처: Docker
출처 확인일: 2026-07-27
최종 검토: 2026-07-27
정정 이력: 2026-07-29 이후 기록 없음

오류·수정 제보

정상 동작 조건

요약

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

확인 절차

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

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

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

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

관련 오류·증상

listen tcp 0.0.0.0:8080: bind: address already in use

listen tcp 0.0.0.0:8080: bind: address already in use 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Cannot connect to the Docker daemon at unix:///var/run/docker.sock

Cannot connect to the Docker daemon at unix:///var/run/docker.sock 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Conflict. The container name "/app" is already in use by container

Conflict. The container name "/app" is already in use by container 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

permission denied while trying to connect to the Docker daemon socket

permission denied while trying to connect to the Docker daemon socket 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

container_linux.go: exec user process caused: no such file or directory

container_linux.go: exec user process caused: no such file or directory 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

failed to create shim task

failed to create shim task 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

failed to solve: failed to read dockerfile

failed to solve: failed to read dockerfile 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

OCI runtime create failed

OCI runtime create failed 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Bind for 0.0.0.0:8080 failed: port is already allocated

Bind for 0.0.0.0:8080 failed: port is already allocated 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

pull access denied for image

pull access denied for image 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Back-off restarting failed container

Back-off restarting failed container 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ContainerCannotRun

ContainerCannotRun 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ContainerStatusUnknown

ContainerStatusUnknown 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

CrashLoopBackOff

CrashLoopBackOff 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

CreateContainerConfigError

CreateContainerConfigError 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

CreateContainerError

CreateContainerError 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ErrImagePull

ErrImagePull 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Evicted

Evicted 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ImagePullBackOff

ImagePullBackOff 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Init:CrashLoopBackOff

Init:CrashLoopBackOff 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Init:ImagePullBackOff

Init:ImagePullBackOff 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

OOMKilled

OOMKilled 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Pending

Pending 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

PodInitializing

PodInitializing 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

RunContainerError

RunContainerError 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

참고 자료

Get started with Docker

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