version: "3.9"          # Compose 파일 스펙 버전

services:               # 실행할 컨테이너들 정의
  web:                  # 서비스 이름 (컨테이너 이름 기반)
    image: nginx:alpine # 사용할 이미지
    ports:
      - "80:80"         # 호스트포트:컨테이너포트
    volumes:
      - ./html:/usr/share/nginx/html  # 마운트
    networks:
      - frontend        # 연결할 네트워크
    depends_on:
      - db              # 시작 순서 의존성
    environment:
      - APP_ENV=production
    restart: always     # 재시작 정책

  db:
    image: mariadb:10.6
    volumes:
      - db_data:/var/lib/mysql  # 이름 있는 볼륨
    env_file:
      - .env            # 환경변수 파일 참조
    networks:
      - backend

networks:               # 네트워크 정의
  frontend:
  backend:

volumes:                # 볼륨 정의
  db_data:

# 들여쓰기: 스페이스 2개 또는 4개 (탭 불가!)
services:
  web:          # 2칸 들여쓰기
    image: nginx  # 4칸 들여쓰기

# 목록(리스트): 하이픈(-)으로 표현
ports:
  - "80:80"
  - "443:443"

# 키-값 쌍: 콜론(:) + 스페이스
image: nginx:alpine   # 콜론 뒤 반드시 스페이스!

docker compose up -d
   │
   ① compose 파일 파싱·검증          (services·networks·volumes 병합, 변수 치환)
   │
   ② 네트워크 생성                   (프로젝트명_default 브리지 — 없으면 새로 만듦)
   │
   ③ 볼륨 생성                       (db_data 등 named volume — 이미 있으면 재사용)
   │
   ④ depends_on 순서로 컨테이너 생성  (의존 대상부터: db → web)
   │
   ⑤ 시작 + healthcheck 대기         (condition: service_healthy면 healthy까지 대기)
   │
   ⑥ 서비스명 DNS로 상호 통신 준비    (web이 db:3306 이름으로 접속)
   ▼
모든 서비스 Up — docker compose ps로 확인

services:
  web:
    image: wordpress
    depends_on:
      - db          # db 컨테이너가 시작되면 web을 시작
                    # ⚠️ db가 실제로 연결 받을 준비가 됐는지는 미확인!
  db:
    image: mariadb

services:
  web:
    image: wordpress
    depends_on:
      db:
        condition: service_healthy  # DB가 healthy 상태일 때만 시작
    restart: always

  db:
    image: mariadb:10.6
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s     # 10초마다 체크
      timeout: 5s       # 5초 내 응답 없으면 실패
      retries: 5        # 5회 실패 시 unhealthy 판정
      start_period: 30s # 시작 후 30초간은 실패해도 무시

services:
  db:
    image: mariadb
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword  # ⚠️ 파일에 노출 위험
      MYSQL_DATABASE: mydb
      MYSQL_USER: user

services:
  db:
    image: mariadb
    env_file:
      - .env  # .gitignore에 추가하여 민감 정보 보호

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

MYSQL_ROOT_PASSWORD=supersecret
MYSQL_DATABASE=myapp_db
MYSQL_USER=appuser
MYSQL_PASSWORD=apppassword

environment:
  - DB_PASSWORD=${DB_PASSWORD}  # 호스트의 환경변수에서 주입

services:
  app:
    # 포트: "호스트:컨테이너" 형식
    ports:
      - "8080:80"         # 호스트 8080 → 컨테이너 80
      - "127.0.0.1:3000:3000"  # 루프백만 바인딩 (보안 강화)

    # 볼륨: 바인드 마운트와 이름 있는 볼륨
    volumes:
      - ./config:/app/config   # 바인드 마운트 (상대경로)
      - app_data:/app/data     # 이름 있는 볼륨

    # 네트워크: 여러 네트워크에 동시 연결 가능
    networks:
      - frontend
      - backend

# 백그라운드로 전체 서비스 실행
docker compose up -d

# 이미지 재빌드 후 실행 (소스코드 변경 시)
docker compose up -d --build

# 특정 서비스만 실행
docker compose up -d db redis

# 서비스 중지 + 컨테이너/네트워크 삭제
docker compose down

# 볼륨까지 삭제 (DB 데이터 포함 — 주의!)

# 컨테이너만 중지 (삭제 안 함)
docker compose stop

# 중지된 컨테이너 재시작
docker compose start

# 서비스 상태 목록
docker compose ps
# NAME            IMAGE     COMMAND     STATUS     PORTS
# myapp-web-1     myapp     "node ..."  Up 5 min   0.0.0.0:3000->3000/tcp
# myapp-db-1      postgres  "docker-…"  Up 5 min   5432/tcp

# 전체 서비스 로그 (최신 순)
docker compose logs

# 특정 서비스 실시간 로그
docker compose logs -f web

# 마지막 100줄
docker compose logs --tail 100 db

# 여러 서비스 동시에
docker compose logs -f web db

# 실행 중인 서비스 컨테이너에 셸 접속
docker compose exec web sh
docker compose exec db psql -U postgres

# 명령어 실행
docker compose exec web ls /app

# 특정 서비스 재시작
docker compose restart web

# 서비스 스케일 조정 (임시)
docker compose up -d --scale web=3

# 모든 서비스 이미지 빌드
docker compose build

# 특정 서비스만 캐시 없이 재빌드
docker compose build --no-cache web

# 최신 이미지 pull
docker compose pull

# 실행 중인 서비스와 같은 환경에서 임시 컨테이너 실행
# 종료 후 자동 삭제 (--rm)
docker compose run --rm web python manage.py migrate
docker compose run --rm web python manage.py createsuperuser
docker compose run --rm web npm run build

디렉토리 구조:
  compose.yml              ← 공통 기반 (모든 환경 공유)
  compose.override.yml     ← 개발용 (docker compose up 시 자동 적용)
  compose.prod.yml         ← 프로덕션용 (명시적으로 지정)
  compose.staging.yml      ← 스테이징용

services:
  app:
    image: myapp:${APP_VERSION:-latest}
    environment:
      - DB_HOST=db
      - DB_PORT=5432

  db:
    image: postgres:16-alpine
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=myapp
      - POSTGRES_USER=appuser

volumes:
  db-data:

# docker compose up 시 compose.yml + 이 파일이 자동 병합됨
services:
  app:
    build: .                    # 로컬 소스로 빌드
    volumes:
      - .:/app                  # 소스코드 핫 리로드
      - /app/node_modules       # node_modules는 컨테이너 것 유지
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development
      - DEBUG=true

  db:
    ports:
      - "5432:5432"             # 개발 시 DB 직접 접근
    environment:
      - POSTGRES_PASSWORD=devpassword

services:
  app:
    restart: always
    ports:
      - "80:3000"
    environment:
      - NODE_ENV=production
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 512M

  db:
    restart: always
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db_password

# 개발: compose.yml + compose.override.yml 자동 병합
docker compose up -d

# 프로덕션: 명시적으로 파일 지정 (override.yml 적용 안 됨)
docker compose -f compose.yml -f compose.prod.yml up -d

# 스테이징
docker compose -f compose.yml -f compose.staging.yml up -d

# 현재 어떻게 병합되는지 확인
docker compose config          # 개발 (자동 병합 결과)
docker compose -f compose.yml -f compose.prod.yml config  # 프로덕션

services:
  # profiles 없음 → 항상 실행
  app:
    image: myapp

  db:
    image: postgres:16-alpine

  # profiles: ["debug"] → --profile debug 시만 실행
  adminer:
    image: adminer
    profiles: ["debug"]
    ports:
      - "8080:8080"

  # profiles: ["monitoring"] → --profile monitoring 시만 실행
  prometheus:
    image: prom/prometheus
    profiles: ["monitoring"]
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml

  grafana:
    image: grafana/grafana
    profiles: ["monitoring"]
    ports:
      - "3001:3000"

# 기본 실행: profiles 없는 서비스만 (app + db)
docker compose up -d

# debug profile 활성화: + adminer
docker compose --profile debug up -d

# monitoring profile 활성화: + prometheus + grafana
docker compose --profile monitoring up -d

# 여러 profile 동시 활성화
docker compose --profile debug --profile monitoring up -d

# 환경변수로 활성화
COMPOSE_PROFILES=debug,monitoring docker compose up -d

services:
  app:
    image: myapp

  db:
    image: postgres:16-alpine

  # 개발 중에만 필요한 서비스들
  mailhog:
    image: mailhog/mailhog     # 이메일 캡처 도구
    profiles: ["dev"]
    ports:
      - "8025:8025"

  redis-commander:
    image: rediscommander/redis-commander  # Redis GUI
    profiles: ["dev"]
    ports:
      - "8081:8081"

  # 성능 테스트 시에만 필요
  k6:
    image: grafana/k6
    profiles: ["perf"]
    volumes:
      - ./tests:/tests
    command: run /tests/load-test.js

# 개발 환경: 이메일 캡처 + Redis GUI 포함
docker compose --profile dev up -d

# 성능 테스트: k6 실행
docker compose --profile perf run --rm k6