리눅스 커널
└── cgroups
    ├── /sys/fs/cgroup/cpu/
    │   └── docker/[container_id]/
    │       └── cpu.shares, cpu.cfs_quota_us
    ├── /sys/fs/cgroup/memory/
    │   └── docker/[container_id]/
    │       └── memory.limit_in_bytes
    └── /sys/fs/cgroup/blkio/     # 디스크 I/O

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

# 종합 자원 제한 예시
docker run \
  --cpus 0.5 \          # CPU: 0.5코어 분량
  -m 256m \             # 메모리: 최대 256MB
  --memory-swap 512m \  # 스왑 포함 최대 512MB
  --blkio-weight 300 \  # I/O 가중치 (기본 500)
  nginx

[자원 제한 없는 서버 — 재앙 시나리오]

서버 스펙: 4 CPU, 8GB RAM
├── web-service   (정상, 예상 사용: 0.2 CPU, 200MB)
├── api-service   (정상, 예상 사용: 0.3 CPU, 300MB)
└── batch-job     (메모리 누수 버그 존재)
    → 처음: 100MB
    → 1시간 후: 2GB
    → 3시간 후: 7GB ← 서버 전체 RAM 잠식!
    → web-service 응답 불가, api-service OOM Kill
    → 서비스 전체 다운!

# 자원 제한 없는 컨테이너가 메모리를 계속 점유하는 상황
docker stats --no-stream
# CONTAINER   CPU %   MEM USAGE / LIMIT   MEM %
# batch-job   5.2%    6.8GiB / 7.5GiB     90%  ← 위험!
# web-srv     45.3%   OOM Kill             --   ← 피해자
# api-srv     0.0%    EXIT                 --   ← 피해자

# 자원 제한 적용 후
docker run -m 512m --cpus 0.5 batch-job

# 결과: batch-job이 512MB를 초과하면 OOMKilled로 자기 자신만 종료
# web-service와 api-service는 영향 없음

1. 측정 먼저: docker stats로 정상 부하 시 사용량 파악
2. 여유 있게: 평균 사용량의 1.5~2배로 제한 설정
3. 단계적 적용: 개발 → 스테이징 → 운영 순서로 적용
4. 알림 연동: 자원 사용률 80% 도달 시 경보 발송

# OOMKilled 발생 확인
docker inspect my-container --format '{{.State.OOMKilled}}'
# true ← 메모리 부족으로 강제 종료됨

docker inspect my-container --format '{{.State.ExitCode}}'
# 137 ← SIGKILL

# 실시간 메모리 사용량 모니터링
docker stats my-container --no-stream
# CONTAINER      MEM USAGE / LIMIT     MEM %
# my-container   498MiB / 512MiB       97.3%  ← 한계치 근접!

# 모든 컨테이너 실시간 통계
docker stats

# -m / --memory: 메모리 제한
docker run -m 512m myapp

# --memory-swap: 메모리 + swap 합산 제한
# 주의: --memory-swap은 메모리+swap 합산값이지, swap 크기가 아님!

docker run -m 512m --memory-swap 512m myapp  # swap 비활성화 (메모리만 512MB)
docker run -m 512m --memory-swap 1g myapp    # 메모리 512MB + swap 512MB
docker run -m 512m --memory-swap -1 myapp    # swap 무제한
# --memory-swap 미지정                        # swap = 메모리 × 2 (기본)

--memory-swap 값 계산:
  메모리 512m + swap 512m = --memory-swap 1g
  (swap 크기 = --memory-swap - --memory)

# 1. 메모리 제한 증가 (실행 중에도 적용 가능)
docker update --memory 1g my-container

# 2. 메모리 + swap 모두 증가
docker update --memory 1g --memory-swap 2g my-container

# 3. JVM 기반 앱: JVM 힙 크기 제한
docker run -m 1g \
  -e JAVA_OPTS="-Xmx800m -Xms400m" \
  java-app

# 4. Node.js: max-old-space-size 설정
docker run -m 512m \
  -e NODE_OPTIONS="--max-old-space-size=400" \
  node-app

# 간단한 셸 스크립트로 모니터링
watch -n 5 'docker stats --no-stream --format "table {{.Name}}\t{{.MemPerc}}"'

# 최대 1.5개 코어 분량 사용
docker run --cpus 1.5 myapp

# 4코어 서버에서:
# --cpus 1.0 → 전체 CPU의 25% 사용 가능
# --cpus 2.0 → 전체 CPU의 50% 사용 가능
# --cpus 4.0 → 제한 없음 (전체 사용)

# 기본값: 1024
# high-priority: 2048 (기본의 2배)
# low-priority: 512 (기본의 절반)

docker run --cpu-shares 2048 --name critical-service myapp   # 고우선순위
docker run --cpu-shares 512  --name batch-worker myapp       # 저우선순위

# 경합 없을 때: 두 컨테이너 모두 필요한 만큼 CPU 사용
# 경합 있을 때: critical-service가 batch-worker의 4배 CPU 받음

# CPU 0번, 1번만 사용 (나머지 코어는 다른 컨테이너용)
docker run --cpuset-cpus "0,1" nginx

# CPU 2번부터 3번 (범위 표기)
docker run --cpuset-cpus "2-3" worker

# CPU 0번 하나만 (단일 코어 격리)
docker run --cpuset-cpus "0" realtime-app

version: '3.8'

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    deploy:
      resources:
        limits:
          cpus: '0.5'           # 컨테이너가 사용할 수 있는 최대 CPU 코어 수 (0.5개)
          memory: 512M          # 컨테이너가 쓸 수 있는 최대 메모리 임계치 (mem_limit)
        reservations:
          memory: 256M          # 컨테이너가 보장받을 수 있는 최소 물리 메모리

version: '3.8'

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    deploy:
      resources:
        limits:
          cpus: '0.5'           # 컨테이너가 사용할 수 있는 최대 CPU 코어 수 (0.5개)
          memory: 512M          # 컨테이너가 쓸 수 있는 최대 메모리 임계치 (mem_limit)
        reservations:
          memory: 256M          # 컨테이너가 보장받을 수 있는 최소 물리 메모리

# 중요한 API 서버: 최소 2코어 보장 + CPU 0,1에 고정
docker run -d \
  --name api-server \
  --cpus 2.0 \
  --cpuset-cpus "0,1" \
  api:latest

# 배치 작업: CPU 2,3 사용 + 낮은 우선순위
docker run -d \
  --name batch-job \
  --cpus 2.0 \
  --cpuset-cpus "2,3" \
  --cpu-shares 512 \
  batch:latest