🐳 Docker 명령어 체계 및 컨테이너 사용법 정리

Docker는 컨테이너 기반 가상화 기술로, 애플리케이션을 격리된 환경에서 실행할 수 있게 해줍니다. 이번 포스트에서는 Docker의 기본 명령어 체계와 컨테이너 동작 방식에 대해 알아보겠습니다.

🔍 Docker의 명령어 체계

Docker의 명령어 체계는 사용자가 컨테이너, 이미지, 네트워크, 볼륨 등 다양한 Docker 리소스를 쉽고 일관성 있게 관리할 수 있도록 설계된 구조화된 CLI(Command Line Interface) 명령어 집합입니다.

명령어 그룹화 구조

Docker는 명령어를 기능별로 그룹화하여 관리합니다. 주요 그룹은 다음과 같습니다:

• docker container: 컨테이너 관리 명령어 그룹
• docker image: 이미지 관리 명령어 그룹
• docker network: 네트워크 관리 명령어 그룹
• docker volume: 볼륨 관리 명령어 그룹

기본 명령어 예시

# 이미지 다운로드
docker image pull python:3.11.6

# 이미지 목록 확인
docker image ls

# 모든 컨테이너 목록 확인(실행 중 + 중지)
docker ps -a

# 우분투 컨테이너 실행
docker container run ubuntu

# 이미지 목록 확인
docker image ls

# 모든 컨테이너 목록 확인
docker container ls -a

# 실행 중인 컨테이너만 확인
docker container ls

# 파이썬 컨테이너 실행
docker container run python:3.11.6

# 대화형 모드로 우분투 컨테이너 실행
docker container run -it ubuntu

# 실행 중인 컨테이너 확인
docker container ls

🏃 Docker 컨테이너 동작 방식

docker container run ubuntu 실행 시 컨테이너 동작 방식

docker container run ubuntu 명령을 실행하면 실제로 컨테이너가 생성되고 실행됩니다. 하지만 활성화된(실행 중인) 컨테이너가 보이지 않는 이유는, 컨테이너 내부에서 실행할 명령이 지정되지 않아 컨테이너가 즉시 종료되기 때문입니다.

왜 바로 꺼지는가? 🤔

• docker container run ubuntu는 Ubuntu 이미지를 기반으로 컨테이너를 실행하지만, 별도의 명령을 주지 않으면 기본적으로 컨테이너는 아무 작업도 하지 않습니다.
• Docker 컨테이너는 내부에서 실행되는 "메인 프로세스"가 종료되면 컨테이너도 즉시 종료됩니다.
• Ubuntu 이미지는 별도의 명령이 없으면 종료(exit)하기 때문에, 컨테이너가 생성되고 바로 꺼집니다.

-it 옵션을 주면 달라지는 이유

• -it 옵션을 주면, 컨테이너 내부에서 터미널을 할당하고 bash 셸을 실행하게 됩니다.
  즉, docker container run -it ubuntu는 bash를 실행하며, 사용자가 직접 명령을 입력할 수 있도록 대기합니다.
• 이 상태에서는 bash 프로세스가 살아있는 동안 컨테이너도 살아있게 됩니다. 사용자가 직접 exit 명령을 내리거나 터미널을 닫을 때까지 컨테이너가 종료되지 않습니다.

정리

• docker container run ubuntu → 컨테이너가 생성되고, 내부에서 실행할 프로세스가 없으므로 바로 종료됨.
• docker container run -it ubuntu → bash 셸이 실행되어 사용자가 직접 명령을 입력할 수 있고, 셸이 종료될 때까지 컨테이너가 유지됨.

컨테이너 라이프사이클 ⏱️

컨테이너의 상태는 다음과 같이 변화합니다:

• Created: 컨테이너가 생성됨(아직 실행 전)
• Running: 컨테이너가 실행 중(메인 프로세스가 살아있음)
• Stopped: 메인 프로세스가 종료되어 컨테이너가 멈춤

컨테이너는 내부에서 실행한 메인 프로세스가 끝나면 자동으로 Stopped 상태가 됩니다.

"Docker 컨테이너는 기본적으로 영원히 실행되지 않습니다. 컨테이너 내부의 메인 프로세스가 완료되거나 명시적으로 중지될 때까지만 실행됩니다."

결론:
docker container run 명령은 실제로 컨테이너를 생성하고 실행하지만, 내부에서 실행되는 프로세스가 없거나 바로 종료되면 컨테이너도 즉시 꺼집니다. -it 옵션을 사용하면 bash 셸이 실행되어 컨테이너가 살아있는 상태가 됩니다.

🎮 컨테이너 관리 명령어

# 컨테이너 중지
docker container stop {CONTAINER ID}

# 컨테이너 시작
docker container start {CONTAINER ID}

# 실행 중인 컨테이너 목록 확인
docker container ls

# 컨테이너에 접속
docker container attach {CONTAINER ID}

docker container start 명령어를 사용하면 컨테이너가 "죽지 않고" 유지되는 이유는, 컨테이너가 생성될 때 지정된 메인 프로세스(예: /bin/bash 등)가 실행되고, 그 프로세스가 계속 동작하는 한 컨테이너도 계속 실행 상태를 유지하기 때문입니다.(앞선 명령어에서 -it 옵션으로 시작함)
즉, 컨테이너가 살아있는지 여부는 "내부에서 실행 중인 메인 프로세스가 계속 동작 중인가"에 달려 있습니다. start 명령은 해당 프로세스를 다시 실행시키기 때문에, 그 프로세스가 종료되지 않는 한 컨테이너도 종료되지 않습니다.

📸 Docker Commit: 컨테이너 변경사항으로 이미지 만들기

Docker commit은 실행 중인 컨테이너의 현재 상태를 새로운 이미지로 저장하는 명령어입니다. 기존 이미지에 레이어를 추가하는 방식으로 동작합니다.

Docker Commit의 작동 방식 🔄

docker container commit [옵션] <컨테이너ID/이름> [저장소[:태그]]

컨테이너에서 변경된 파일 시스템 상태를 캡처하여 새로운 레이어로 추가한 이미지를 생성합니다.

주요 특징

• 레이어 기반 저장: 오직 변경된 파일들만 새 레이어에 저장됩니다
• 볼륨 제외: 마운트된 볼륨의 데이터는 이미지에 포함되지 않습니다
• 실행 중인 프로세스 제외: 메모리 상태, 실행 중인 프로세스는 포함되지 않습니다
• 이미지 히스토리: 기존 이미지의 레이어 스택 위에 변경사항이 새 레이어로 추가됩니다

예시 시나리오

1. Ubuntu 기본 이미지로 컨테이너 실행
2. 컨테이너 내에서 net-tools 패키지 설치
3. docker commit으로 변경사항 포함된 새 이미지 생성

이 경우:

• 기본 Ubuntu 이미지 레이어는 그대로 유지
• net-tools 설치로 변경된 파일들만 새로운 레이어에 포함
• 새 이미지는 Ubuntu + net-tools가 설치된 상태

주의사항 ⚠️

• 도커 파일로 빌드하는 것보다 재현성이 낮음
• 이미지 생성 과정이 문서화되지 않음
• 디버깅이나 임시 이미지 생성 외에는 Dockerfile 사용 권장

🛠 컨테이너 커스터마이징 및 이미지 생성 실습

1. 컨테이너 실행 및 패키지 설치

# 우분투 컨테이너 실행
docker container run -it ubuntu

# 중지된 컨테이너 시작
docker container start {CONTAINER ID}

# 실행 중인 컨테이너에 접속
docker container attach {CONTAINER ID}

컨테이너 내부에서:

$ apt update && apt install net-tools
$ ifconfig

2. 변경사항으로 새 이미지 생성

# 변경사항으로 새 이미지 생성
docker container commit {CONTAINER ID} my-ubuntu:0.1

# 이미지 목록 확인
docker image ls

# 컨테이너에서 나가기
$ exit

3. 기존 컨테이너 삭제 및 새 이미지로 컨테이너 실행

# 기존 컨테이너 삭제
docker container rm {CONTAINER ID}

# 필요없는 이미지 삭제
docker image rm {IMAGE ID}

# 새 이미지로 컨테이너 실행
docker container run -it my-ubuntu:0.1

# net-tools가 설치된 것 확인
$ ifconfig