Docker Container

컨테이너 생성, 실행, 로그, 자원 제어, 정리까지 묶어 다루는 docker container 관리 그룹.

• 최상위 명령 docker run, docker exec, docker rm 등은 대부분 docker container 하위 동작의 축약 진입점이다.
• 생성 계열은 create 와 run 이 구분된다. create 는 컨테이너만 만들고, run 은 생성 후 즉시 시작한다.
• 정리 계열은 rm 과 prune 의 범위가 다르다. prune 은 중지된 컨테이너 전체를 정리하므로 주의한다.

docker container COMMAND

• docker container run [OPTIONS] IMAGE [COMMAND] [ARG…]
• docker container create [OPTIONS] IMAGE [COMMAND] [ARG…]
• docker container exec [OPTIONS] CONTAINER COMMAND [ARG…]
• docker container ls [OPTIONS]
• docker container rm [OPTIONS] CONTAINER [CONTAINER…]

• run: 컨테이너 생성 후 즉시 시작
  • 주요 옵션: -d, -it, –rm, –name, -p, -v, –mount, –env, –restart, –network, –pull, -w, -u
• create: 시작하지 않고 컨테이너만 생성
  • 주요 옵션: –name, -p, -v, –env, –entrypoint, –restart
• start: 이미 존재하는 정지 컨테이너 시작
  • 주요 옵션: -a, -i
• restart: 컨테이너 재시작
  • 주요 옵션: -t, –signal

• exec: 실행 중 컨테이너 안에서 명령 실행
  • 주요 옵션: -i, -t, -u, -w, -e, –privileged
• attach: PID 1 의 표준 입출력에 직접 연결
  • 주요 옵션: –detach-keys, –sig-proxy
• logs: stdout/stderr 로그 확인
  • 주요 옵션: -f, –tail, –since, –until, -t, –details
• inspect: JSON 기반 상세 정보 조회
  • 주요 옵션: -f, –size
• top: 컨테이너 내부 프로세스 목록
• stats: CPU, memory, I/O 사용량 스트림
  • 주요 옵션: –no-stream, –format
• port: publish 포트 매핑 확인
• diff: writable layer 변경 파일 확인

• cp: 로컬과 CONTAINER:PATH 사이 복사
  • 주요 옵션: -a, -L
• export: 파일시스템을 tar로 내보냄
• commit: 현재 컨테이너 상태를 이미지로 저장
  • 주요 옵션: -a, -m, -p, -c

• stop: 정상 종료 신호를 보내고 대기 후 중지
  • 주요 옵션: -t, –signal
• kill: 지정 signal로 즉시 종료
  • 주요 옵션: -s
• pause / unpause: cgroup freezer 기반 일시정지/해제
• wait: 종료까지 블록 후 exit code 출력
• rm: 중지된 컨테이너 제거
  • 주요 옵션: -f, -v, -l
• prune: 중지된 컨테이너 전체 정리
  • 주요 옵션: -f, –filter until=…
• rename: 컨테이너 이름 변경
• update: 실행 중 제한 갱신
  • 주요 옵션: –cpus, –memory, –restart

# 대화형 컨테이너 실행 후 종료 시 자동 삭제
docker container run --rm -it ubuntu:24.04 bash
 
# 설정만 만들고 나중에 시작
docker container create --name worker --restart unless-stopped myapp:latest
docker container start worker
 
# 실행 중 컨테이너 내부 명령 실행
docker container exec -it worker sh
 
# 최근 100줄 로그 follow
docker container logs -f --tail 100 worker
 
# 중지된 컨테이너 일괄 정리
docker container prune

• exec 는 컨테이너가 실행 중이어야 한다. 정지 상태에서는 start 후 다시 실행한다.
• rm 에서 volume까지 지우려면 -v 가 필요하다. 없으면 named volume이 남을 수 있다.
• attach 는 PID 1 과 직접 연결되므로 셸 이외 프로세스에는 예상과 다르게 동작할 수 있다. 일반 점검은 exec 가 더 안전하다.
• prune 는 범위가 넓다. CI나 운영 호스트에서는 docker container ls -a 로 먼저 확인하는 편이 낫다.

• docker run, docker exec, docker ps, docker rm 등은 독립 top-level 명령으로도 계속 사용된다.
• 스크립트에서는 축약형과 관리형 중 하나로 통일하는 편이 가독성이 좋다.

+ docker container --help

Usage:  docker container COMMAND
 
Manage containers
 
Commands:
  attach      Attach local standard input, output, and error streams to a running container
  commit      Create a new image from a container's changes
  cp          Copy files/folders between a container and the local filesystem
  create      Create a new container
  diff        Inspect changes to files or directories on a container's filesystem
  exec        Execute a command in a running container
  export      Export a container's filesystem as a tar archive
  inspect     Display detailed information on one or more containers
  kill        Kill one or more running containers
  logs        Fetch the logs of a container
  ls          List containers
  pause       Pause all processes within one or more containers
  port        List port mappings or a specific mapping for the container
  prune       Remove all stopped containers
  rename      Rename a container
  restart     Restart one or more containers
  rm          Remove one or more containers
  run         Create and run a new container from an image
  start       Start one or more stopped containers
  stats       Display a live stream of container(s) resource usage statistics
  stop        Stop one or more running containers
  top         Display the running processes of a container
  unpause     Unpause all processes within one or more containers
  update      Update configuration of one or more containers
  wait        Block until one or more containers stop, then print their exit codes
 
Run 'docker container COMMAND --help' for more information on a command.

+

• docker
• compose
• image
• network

• codex:: 2026-07-06 Added docker container subpage with lifecycle, exec, cleanup, and option notes.