Docker 컨테이너 개념부터 Compose까지 한 번에 정리

┌─────────────┐  ┌─────────────┐
│    App A    │  │    App B    │
│   Libs/Bins │  │   Libs/Bins │
│  Guest OS   │  │  Guest OS   │
├─────────────┴──┴─────────────┤
│         Hypervisor           │
├──────────────────────────────┤
│          Host OS             │
└──────────────────────────────┘

┌─────────────┐  ┌─────────────┐
│    App A    │  │    App B    │
│   Libs/Bins │  │   Libs/Bins │
├─────────────┴──┴─────────────┤
│       Docker Engine          │
├──────────────────────────────┤
│          Host OS             │
└──────────────────────────────┘

Dockerfile → (빌드) → Image → (실행) → Container
                        ↓
                    Registry에 push
                        ↓
                    서버에서 pull → Container

# 이미지 빌드 (-t: 태그 지정, .: 현재 디렉터리의 Dockerfile 사용)
docker build -t myapp:1.0 .

# 이미지 목록
docker images

# 이미지 다운로드
docker pull nginx:latest

# 이미지 삭제
docker rmi myapp:1.0

# 사용하지 않는 이미지 정리
docker image prune

# 컨테이너 실행
# -d: 백그라운드, -p: 포트 매핑 (호스트:컨테이너), --name: 이름 지정
docker run -d -p 8080:80 --name web nginx

# 실행 중인 컨테이너 목록
docker ps

# 모든 컨테이너 (중지 포함)
docker ps -a

# 컨테이너 중지 / 시작 / 재시작
docker stop web
docker start web
docker restart web

# 컨테이너 삭제
docker rm web

# 실행 중인 컨테이너에 접속
docker exec -it web /bin/bash
# -i: interactive, -t: tty (터미널)

# 컨테이너 로그
docker logs web
docker logs -f web  # -f: 실시간 (follow)

# 중지된 컨테이너, 사용 안 하는 이미지/네트워크 전부 정리 (볼륨 제외)
docker system prune -a

# 현재 디스크 사용량 확인
docker system df

# 베이스 이미지 지정
FROM node:20-alpine

# 작업 디렉터리 설정
WORKDIR /app

# 의존성 파일 복사 (캐시 활용을 위해 먼저 복사)
COPY package.json package-lock.json ./

# 의존성 설치
RUN npm ci

# 소스 코드 복사
COPY . .

# 빌드
RUN npm run build

# 포트 선언 (문서화 용도)
EXPOSE 3000

# 실행 명령어
CMD ["node", "dist/server.js"]

# CMD: 기본 명령어 (docker run에 명령을 주면 대체됨)
CMD ["npm", "start"]

# ENTRYPOINT: 기본 실행 파일
ENTRYPOINT ["node", "server.js"]

# 조합: ENTRYPOINT가 실행, CMD가 기본 인자
ENTRYPOINT ["node"]
CMD ["server.js"]

# 의존성 파일을 먼저 복사한 경우
COPY package.json package-lock.json ./  ← 자주 안 바뀜 (캐시 활용)
RUN npm ci
COPY . .                                ← 자주 바뀜 (여기부터 다시 빌드)

# 소스를 먼저 복사한 경우: 소스가 바뀌면 npm ci 레이어도 다시 실행됨
COPY . .
RUN npm ci

# 1단계: 빌드
FROM node:20-alpine AS builder
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build

# 2단계: 실행 (빌드 도구 없이 결과물만)
FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/server.js"]

# Named Volume (Docker가 생성·관리하는 저장 위치 사용)
docker run -d -v mydata:/var/lib/mysql mysql

# Bind Mount (호스트 경로 직접 지정)
docker run -d -v /host/path:/container/path nginx

# 읽기 전용 (:ro)
docker run -d -v "$(pwd)"/config:/app/config:ro nginx

# 볼륨 목록
docker volume ls

# 볼륨 생성
docker volume create mydata

# 볼륨 삭제
docker volume rm mydata

# 컨테이너가 참조하지 않는 볼륨 정리 (기본값: 익명 볼륨만)
docker volume prune

# 이름 붙인 볼륨까지 정리
docker volume prune -a

# 네트워크 생성
docker network create app-net

# 네트워크에 연결하면서 실행
docker run -d --name api --network app-net myapi
docker run -d --name db --network app-net mysql

# 같은 네트워크 안에서는 컨테이너 이름으로 통신 가능
# api 컨테이너에서: mysql -h db -u root

api 컨테이너 안에서:
  mysql -h db -u root
           ↑
    "db"라는 컨테이너 이름이 자동으로 해당 컨테이너의 IP로 해석됨

# 네트워크 목록
docker network ls

# 네트워크 상세 정보
docker network inspect app-net

# 실행 중인 컨테이너를 네트워크에 연결
docker network connect app-net web

# 네트워크 삭제
docker network rm app-net

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DB_HOST=db
      - REDIS_HOST=redis
    depends_on:
      - db
      - redis

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: secret
    volumes:
      - db-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  db-data:

# 전체 실행 (-d: 백그라운드)
docker compose up -d

# 전체 중지 + 삭제
docker compose down

# 로그 확인
docker compose logs -f app

# 특정 서비스만 재빌드
docker compose up -d --build app

# 상태 확인
docker compose ps

# .dockerignore
node_modules
dist
.git
.env
*.log
.DS_Store
docker-compose.yml
README.md

# 컨테이너 표준 출력·표준 에러 확인
docker logs <container-name>

# 종료 코드 확인
docker inspect <container-name> --format='{{.State.ExitCode}}'
# 0: 정상 종료

# OOM Kill로 죽었는지 확인
docker inspect <container-name> --format='{{.State.OOMKilled}}'

# 이미지로 셸 띄우기 (ENTRYPOINT를 셸로 바꿔서 디버깅)
docker run -it --entrypoint /bin/sh myapp:1.0

# 빌드 로그 자세히 보기
docker build --no-cache --progress=plain -t myapp .

# 특정 스테이지까지만 빌드
docker build --target builder -t myapp-debug .

# 컨테이너 내부에서 네트워크 확인
docker exec -it web sh -c "curl http://api:3000/health"

# 컨테이너의 IP 확인
docker inspect web --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'

# DNS 확인
docker exec -it web nslookup db

# Docker 디스크 사용량
docker system df

# 정리 (중지된 컨테이너, 사용 안 하는 이미지/네트워크 + 익명 볼륨)
docker system prune -a --volumes