docker create
          ┌─────────────────────────────┐
          ▼                             │
     ┌─────────┐   docker start    ┌───┴─────┐
     │ Created │──────────────────▶│ Running │
     └─────────┘                   └────┬────┘
                                        │
                   ┌────────────────────┼────────────────────┐
                   │                    │                    │
             docker stop          docker pause         (프로세스 종료)
                   │                    │                    │
                   ▼                    ▼                    ▼
             ┌──────────┐         ┌─────────┐          ┌─────────┐
             │  Stopped │         │ Paused  │          │ Exited  │
             │ (Exited) │         └────┬────┘          └────┬────┘
             └────┬─────┘              │                    │
                  │             docker unpause        docker start
             docker start              │                    │
                  │                    ▼                    ▼
                  └──────────────▶ Running ◀───────────────┘
                                        │
                                   docker rm
                                        │
                                        ▼
                                   (Removed)

# 실습 디렉토리 준비
mkdir -p /tmp/docker/part2/exam_5 && cd /tmp/docker/part2/exam_5

# 실행 중인 컨테이너만 표시
docker ps
# CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS         PORTS                  NAMES
# a1b2c3d4e5f6   nginx     "/docker-entrypoint.…"   2 minutes ago   Up 2 minutes   0.0.0.0:8080->80/tcp   my-nginx

# 모든 상태의 컨테이너 표시
docker ps -a
# CONTAINER ID   IMAGE         COMMAND    CREATED       STATUS                   PORTS   NAMES
# a1b2c3d4e5f6   nginx         ...        2 min ago     Up 2 minutes             ...     my-nginx
# b2c3d4e5f6a7   hello-world   "/hello"   10 min ago    Exited (0) 10 min ago            magical_tesla

# 특정 상태만 필터링
docker ps -a --filter "status=exited"
docker ps -a --filter "name=my-nginx"

# 컨테이너의 모든 메타데이터 확인
docker inspect my-nginx

# 특정 필드만 추출 (Go 템플릿 사용)
docker inspect my-nginx --format '{{.State.Status}}'
docker inspect my-nginx --format '{{.NetworkSettings.IPAddress}}'

호스트 네트워크           컨테이너 네트워크
─────────────────────    ─────────────────────
eth0: 192.168.1.10       eth0: 172.17.0.2
                         lo:   127.0.0.1

                         Nginx 리스닝: 0.0.0.0:80

외부 클라이언트 → 호스트:8080 → iptables NAT 규칙 → 컨테이너:80 → Nginx

# 형식: -p [호스트IP:]호스트PORT:컨테이너PORT[/프로토콜]

# 기본: 모든 인터페이스의 8080 → 컨테이너 80
docker run -p 8080:80 nginx

# 특정 IP 바인딩: localhost에서만 접근 가능
docker run -p 127.0.0.1:8080:80 nginx

# 랜덤 호스트 포트 자동 할당
docker run -p 80 nginx

# UDP 프로토콜 지정
docker run -p 53:53/udp bind9

# 여러 포트 동시 바인딩
docker run -p 80:80 -p 443:443 nginx

# 컨테이너의 포트 바인딩 확인
docker port my-nginx
# 80/tcp -> 0.0.0.0:8080

# docker ps에서도 확인 가능
docker ps
# PORTS: 0.0.0.0:8080->80/tcp

# host 네트워크 사용 (포트 바인딩 없이 호스트 포트 직접 사용)
docker run --network host nginx
# 이 경우 호스트의 80번 포트에서 바로 Nginx 접근 가능

# DOCKER 체인의 NAT 규칙 확인
sudo iptables -t nat -L DOCKER --line-numbers

# 특정 포트에 대한 규칙 확인
sudo iptables -t nat -L -n | grep 8080

docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

# -d (--detach): 백그라운드 실행
# 서버 프로세스처럼 계속 돌아야 할 컨테이너에 사용
docker run -d nginx

# -it: 대화형 터미널 (Interactive + TTY)
# 셸에 직접 접속하거나 대화형 프로그램 실행 시
docker run -it ubuntu bash
docker run -it python:3.11 python   # Python REPL 실행

# --rm: 컨테이너 종료 시 자동 삭제
# 일회성 실행, 임시 도구 사용 시 (docker ps -a에 쌓이지 않음)
docker run --rm ubuntu echo "hello"
docker run --rm -it alpine sh   # 종료하면 바로 삭제

# --name: 컨테이너 이름 지정
# 이름이 없으면 Docker가 random_name을 붙임 (예: loving_turing)
docker run -d --name my-nginx nginx
docker logs my-nginx    # 이름으로 참조 가능

# -e / --env: 환경변수 주입
docker run -e DB_HOST=localhost -e DB_PORT=5432 myapp
docker run -e NODE_ENV=production myapp

# --env-file: 파일에서 환경변수 읽기
# .env 파일에 여러 변수를 모아두고 주입
docker run --env-file .env myapp

# .env
DB_HOST=db
DB_PORT=5432
DB_PASSWORD=secret123

# 개발 환경: 소스코드 마운트 + 로그 실시간 확인
docker run -it --rm \
  -v $(pwd):/app \
  -p 3000:3000 \
  -e NODE_ENV=development \
  node:20 node server.js

# 운영 환경: 백그라운드 + 재시작 + 이름 지정
docker run -d \
  --name api-server \
  --restart unless-stopped \
  -p 8080:8080 \
  --env-file /etc/myapp/prod.env \
  myapp:2.1.0

# 일회성 DB 마이그레이션 실행
docker run --rm \
  --env-file .env \
  --network myapp_network \
  myapp:2.1.0 python manage.py migrate

# Alpine으로 빠른 셸 도구 사용
docker run --rm -it alpine sh
docker run --rm busybox wget -qO- http://example.com

docker ps -a
# CONTAINER ID   IMAGE     COMMAND      CREATED       STATUS
# a1b2c3d4e5f6   myapp     "node ..."   5 min ago     Exited (1) 5 min ago
#                                                      ↑ 종료코드 1 = 오류

# 전체 로그 출력
docker logs a1b2c3d4e5f6

# 마지막 50줄만
docker logs --tail 50 a1b2c3d4e5f6

# 실시간 로그 추적 (tail -f 와 동일)
docker logs -f my-container

# 특정 시간 이후 로그만
docker logs --since 10m my-container  # 최근 10분
docker logs --since "2026-04-05T10:00:00" my-container

# 종료 코드 직접 확인
docker inspect a1b2c3d4e5f6 --format '{{.State.ExitCode}}'
# 137 → OOM 또는 강제 종료

# OOMKilled 여부 확인
docker inspect a1b2c3d4e5f6 --format '{{.State.OOMKilled}}'
# true → 메모리 부족으로 강제 종료됨

# 잘못된 예: bash는 대화형 입력이 없으면 바로 종료됨
docker run ubuntu bash   # 바로 Exited!

# 해결: -it 플래그로 대화형 터미널 연결
docker run -it ubuntu bash   # 셸 프롬프트 진입

# 잘못된 예: CMD가 순간에 끝나는 명령이면 컨테이너도 종료
docker run ubuntu echo "hello"   # echo 실행 후 Exited

# 서버 프로세스는 포그라운드로 실행해야 컨테이너가 유지됨
# nginx: 기본 CMD가 'nginx -g "daemon off;"' → 포그라운드 실행 ✓
# node server.js → 서버가 포그라운드에서 실행 중 → 유지 ✓