Docker 실무 가이드 · Part 2

컨테이너 실행과 확인 루틴

컨테이너를 안전하게 띄우고, 상태를 확인하고, 문제를 조사하는 기본 루틴

작성 기준2026년 7월

이 파트에서 다루는 내용

컨테이너 실행포트와 환경변수로그 확인컨테이너 접속과 종료
01

처음 실행할 때는 이름, 포트, 환경변수부터 명확히 합니다

컨테이너는 실행 옵션에 따라 외부에서 접속 가능한 포트, 내부 설정, 파일 보존 방식이 달라집니다.

실무에서는 아무 이름 없이 띄우기보다 컨테이너 이름, 포트 매핑, 환경변수를 명시해야 나중에 조사와 정리가 쉽습니다.

이름
--name

컨테이너를 사람이 알아볼 수 있는 이름으로 관리합니다.

포트
-p 8080:80

호스트의 8080 포트를 컨테이너의 80 포트에 연결합니다.

환경변수
-e NODE_ENV=development

이미지를 바꾸지 않고 실행 시점 설정을 전달합니다.

docker run --name web-demo -p 8080:80 nginxnginx 컨테이너를 web-demo 이름으로 실행하고 localhost:8080에 연결
docker run --rm node:24 node -v일회성 컨테이너로 Node 버전만 확인하고 자동 삭제
docker ps실행 중인 컨테이너 목록 확인
docker ps -a종료된 컨테이너까지 포함해 확인
02

실행 중인 컨테이너는 로그와 셸로 확인합니다

컨테이너 안에서 무슨 일이 일어나는지 먼저 보는 방법은 로그입니다. 그 다음 설정 파일, 환경변수, 네트워크 상태를 직접 확인해야 할 때 exec로 들어갑니다.

docker logs web-demo컨테이너 로그 확인
docker logs -f --tail 100 web-demo최근 100줄부터 실시간 로그 추적
docker exec -it web-demo sh실행 중인 컨테이너 안에 셸로 접속
docker inspect web-demo포트, 네트워크, 마운트, 상태 정보를 JSON으로 확인
조사 순서

컨테이너 문제는 ps로 상태를 보고, logs로 원인을 찾고, 필요할 때 exec와 inspect로 내부 설정을 확인하는 순서가 가장 안전합니다.

03

멈추기와 삭제는 대상을 확인한 뒤 실행합니다

  • stop은 컨테이너를 종료하지만 컨테이너 기록은 남습니다.
  • rm은 종료된 컨테이너를 삭제합니다. 컨테이너 안에만 있던 임시 파일도 함께 사라집니다.
  • 이미지는 컨테이너와 별개입니다. 컨테이너를 삭제해도 이미지는 남아 다시 실행할 수 있습니다.
  • 이름이 비슷한 컨테이너가 많으면 docker ps -a로 ID와 이름을 먼저 확인합니다.
docker stop web-demo컨테이너 정상 종료 요청
docker rm web-demo종료된 컨테이너 삭제
docker rm -f web-demo실행 중인 컨테이너 강제 종료 후 삭제
체크

이 파트 완료 기준