Docker 사용 핵심 명령 가이드

# 이미지 빌드
# `-t`: 이미지 이름과 태그를 지정한다 (예: `my-app:1.0`).
# `.`: Dockerfile이 있는 디렉토리.(현재 디렉토리)
docker build -t <Name:Tag> .
 
# 환경 변수를 지정해서 이미지를 빌드한다.
docker build . --build-arg ARG1=0000 --build-arg ARG2=0000 -t <Name:Tag>
 
# 이미지 목록 확인
docker images
 
# 이미지 상세 정보 확인 (Inspection)
# - Base Image(OS 등), 레이어 내용, 생성 날짜 등을 확인할 때 사용한다.
docker image inspect <Image ID or Name>
 
# 이미지 삭제
# - 해당 이미지를 사용하는 컨테이너(종료 상태 포함)가 있으면 삭제되지 않는다.
docker rmi <Image ID or Name>
 
# 이미지 태그 설정
# - 기존 이미지에 새로운 이름이나 태그를 부여한다. Docker Hub 전송 시 유용하다.
docker tag <Source Image> <Target Image:Tag>
 
# 사용중이지 않은 모든 이미지 삭제(정지 상태 컨테이너 없는 것)
docker prune -a

# Attached 모드 (기본): 실시간 로그를 터미널에서 확인
docker run nginx
 
# Detached 모드 (-d): 백그라운드에서 실행
docker run -d nginx
 
# 포트 포워딩, 컨테이너 이름, Detached mode, Interactive mode 등을 사용할 수 있다.
docker run -p <Host Port>:<Container Port> --name <Container Name> <Image ID or Name>
 
# 예시: nginx 이미지를 'web-server'라는 컨테이너명으로 8080 포트에 실행. 컨테이너 종료 시 자동 삭제.
# `-d`: Detached mode (백그라운드 실행). 터미널을 차지하지 않는다.
# `-it`: Interactive + TTY (사용자 입력을 기다리는 유틸리티 프로그램 등에 사용).
# `-p`: 포트 포워딩 설정 (예: `3000:80`).
# `--name`: 컨테이너 이름을 지정한다.
# `--rm`: 컨테이너 종료 시 자동 삭제 (개발 단계에서 소스 변경 시 유용).
docker run -d --rm -p 8080:80 --name web-server nginx
 
# .env 파일을 별도로 생성한 경우 컨테이너 실행 시 포함하도록 설정
docker run --rm -d --env-file .env <Image ID or Name>

# 컨테이너 목록 확인
docker ps      # 실행 중인 컨테이너만
docker ps -a   # 중지된 컨테이너 포함 모든 목록
 
# 컨테이너 시작/중지/삭제
docker start <ID or Name>      # 중지된 (기존의) 컨테이너를 백그라운드에서 다시 시작
 
# 컨테이너를 Attached + Interactive 모드로 다시 시작
#  `-a` (attach): 컨테이너의 출력에 연결한다.
#  `-i` (interactive): 컨테이너의 입력에 연결한다.
docker start -ai <ID or Name>
 
# 실행 중인 컨테이너 종료
docker stop <ID or Name>
 
# 종료된 컨테이너 목록 보기
docker container ls -a
 
# 또는 상태가 종료인 컨테이너 한꺼번에 삭제
docker container prune
 
# 컨테이너 삭제
docker rm <ID or Name>

# node 이미지에서 컨테이너 시작 시 이미지 기본 명령 대신 npm init 명령어 실행
# 주의: -it 옵션이 있어야 사용자 질문에 답변할 수 있다.있
docker run -it node npm init
 
# 호스트의 현재 폴더($(pwd))를 컨테이너의 /app에 연결하여 프로젝트 초기화
# (생성된 package.json 파일이 호스트의 현재 폴더에 저장된다)
# 주의: -v (볼륨) 옵션 없이 실행하면 컨테이너 내부에서 생성된 파일은 컨테이너 종료(삭제)와 함께 모두 사라진다.
docker run -it --rm -v $(pwd):/app -w /app node npm init

# 컨테이너 로그 확인 (Logs)
docker logs <ID or Name>
docker logs -f <ID or Name>  # 실시간 로그 스트리밍
 
# 실행중인 컨테이너 내부에서 명령 실행 (Exec)
docker exec -it <ID or Name> <Command>
 
# 예: 컨테이너 내부의 쉘 접속
docker exec -it <ID or Name> /bin/sh (또는 bash)
 
# 실행 중인 'web-server' 컨테이너 내부에서 파일 목록 확인
# - 메인 프로세스를 중단하지 않고 내부 파일을 읽거나 설정을 바꿀 때 유용하다.
docker exec -it web-server ls
 
# 실행 중인 컨테이너에 연결 (Attach)
# - Detached 컨테이너에 다시 연결하여 출력 메시지를 확인한다.
docker attach <ID or Name>
 
# 로컬과 컨테이너 간 파일 복사 (CP)
# - 로컬 -> 컨테이너
docker cp <Local Path> <Container Name>:<Container Path>
 
# - 컨테이너 -> 로컬
docker cp <Container Name>:<Container Path> <Local Path>

# 빌드와 동시에 태그 지정
docker build -t my-account/test-hello-node:1.0 .
 
# 기존 이미지(test-hello-node:latest)에 새로운 태그 부여
docker tag test-hello-node:latest my-account/test-hello-node:latest
 
# Docker Hub 로그인
docker login
 
# 이미지 업로드
docker push my-account/test-hello-node:latest
 
# 이미지 다운로드
docker pull my-account/test-hello-node:latest

# 새로운 2.0 버전을 출시하는 과정
docker tag my-app:src my-account/my-app:v2.0   # 버전 태그 부여
docker tag my-app:src my-account/my-app:latest # latest 태그 갱신
docker push my-account/my-app:v2.0
docker push my-account/my-app:latest

# 새로운 네트워크 생성
docker network create <Network Name>
 
# 컨테이너 실행 시 네트워크 연결
docker run --network <Network Name> --name <Container Name> <Image Name>

# Docker 자원 사용량 확인 (이미지, 컨테이너, 볼륨 등)
docker system df
 
# 사용하지 않는 모든 개체 정리 (Prune)
# 중지된 컨테이너, 미사용 네트워크, 댕글링(Dangling) 이미지 등을 일괄 삭제한다.
docker system prune
 
# 태그가 없는 이미지뿐만 아니라, 사용 중이지 않은 모든 이미지를 삭제하려면 -a 추가
docker system prune -a
 
# 볼륨까지 함께 삭제하려면 --volumes 추가
docker system prune --volumes

# 모든 컨테이너 일괄 중지
docker stop $(docker ps -q)
 
# 모든 컨테이너 일괄 삭제 (실행 중인 컨테이너 포함 시 -f 추가)
docker rm -f $(docker ps -aq)