Union Filesystem — Docker 이미지 레이어가 실제로 저장되는 방식

┌─────────────────────────────┐
│        merged (통합 뷰)      │ ← 컨테이너가 보는 파일 시스템
├─────────────────────────────┤
│        upper (쓰기 레이어)    │ ← 컨테이너의 변경사항
├─────────────────────────────┤
│        lower 3 (읽기 전용)   │ ← RUN npm run build
├─────────────────────────────┤
│        lower 2 (읽기 전용)   │ ← RUN npm ci
├─────────────────────────────┤
│        lower 1 (읽기 전용)   │ ← FROM node:20-alpine
└─────────────────────────────┘

# 컨테이너의 OverlayFS 정보 확인
docker inspect mycontainer --format '{{.GraphDriver.Data.MergedDir}}'
docker inspect mycontainer --format '{{.GraphDriver.Data.UpperDir}}'
docker inspect mycontainer --format '{{.GraphDriver.Data.LowerDir}}'

# 실제 디렉토리 확인 (root 권한 필요)
sudo ls /var/lib/docker/overlay2/

요청: /app/config.json 읽기

merged (통합 뷰)
  │
  ├── upper: config.json 없음 → 다음 레이어 확인
  │
  └── lower: config.json 발견! → 이 파일을 반환

요청: /app/config.json 수정

1단계: lower에서 upper로 파일 복사 (copy-up)
upper: config.json (복사본 생성됨)
lower: config.json (원본 그대로)

2단계: upper의 복사본 수정
upper: config.json (수정됨) ← 이 파일이 보임
lower: config.json (원본)   ← 가려져서 안 보임

요청: /app/old-file.txt 삭제

upper: .wh.old-file.txt (whiteout 파일 생성)
lower: old-file.txt (원본 그대로, 하지만 가려짐)

merged에서 old-file.txt가 보이지 않음

요청: /app/cache/ 디렉토리 삭제

upper: cache/.wh..wh..opq (opaque whiteout 생성)

lower의 cache/ 내용물이 전부 가려짐

┌── 컨테이너 A ──┐  ┌── 컨테이너 B ──┐  ┌── 컨테이너 C ──┐
│   upper A      │  │   upper B      │  │   upper C      │
│   (각자의     │  │   (각자의     │  │   (각자의     │
│    변경사항)   │  │    변경사항)   │  │    변경사항)   │
├────────────────┤  ├────────────────┤  ├────────────────┤
│                                                        │
│              공유되는 lower layers                       │
│              (이미지 레이어 — 읽기 전용)                  │
│                                                        │
└────────────────────────────────────────────────────────┘

# 이미지 레이어 확인
docker image inspect nginx:1.25-alpine --format '{{.RootFS.Layers}}'
# [sha256:abc... sha256:def... sha256:ghi...]

# 디스크 사용량 확인
docker system df
# TYPE          TOTAL   ACTIVE   SIZE      RECLAIMABLE
# Images        5       3        1.2GB     400MB (33%)
# Containers    3       3        25MB      0B (0%)
# Local Volumes 4       2        500MB     200MB (40%)

# 상세 디스크 사용량
docker system df -v

# 현재 사용 중인 스토리지 드라이버 확인
docker info | grep "Storage Driver"
# Storage Driver: overlay2

// /etc/docker/daemon.json
{
  "storage-driver": "btrfs"
}

{
  "storage-driver": "zfs"
}

# 나쁜 예: 큰 파일을 복사한 후 수정하면
# CoW로 인해 전체 파일이 upper layer에 복사됨
COPY large-data.db /data/
# 나중에 컨테이너에서 이 파일을 수정하면 →
# 수 GB 파일이 upper layer에 전체 복사

# 나쁜 예: 파일이 삭제되어도 이전 레이어에 남아있음
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y build-essential  # +500MB
RUN make && make install
RUN apt-get remove -y build-essential && apt-get autoremove -y  # -500MB?
# 실제 이미지 크기: ~500MB가 여전히 포함됨!

# 좋은 예: 같은 레이어에서 설치와 삭제
FROM ubuntu:22.04
RUN apt-get update \
    && apt-get install -y --no-install-recommends build-essential \
    && make && make install \
    && apt-get remove -y build-essential \
    && apt-get autoremove -y \
    && rm -rf /var/lib/apt/lists/*

docker history myapp:latest
# IMAGE          CREATED       CREATED BY                           SIZE
# abc123         5 min ago     CMD ["node" "server.js"]             0B
# def456         5 min ago     COPY dist/ ./dist/                   5MB
# ghi789         5 min ago     RUN npm ci --omit=dev                50MB
# jkl012         5 min ago     COPY package*.json ./                500KB
# mno345         2 weeks ago   /bin/sh -c #(nop) WORKDIR /app       0B
# pqr678         2 weeks ago   ...node:20-alpine layers...          180MB