📌 Docker Compose 완전 정복

📅 날짜

2025-06-04

📝 학습 내용

1️⃣ Docker Compose란?

✅ 정의

Docker Compose는 다중 컨테이너 애플리케이션을 정의하고 실행할 수 있도록 지원하는 Docker의 공식 도구입니다.

docker-compose.yml 파일 하나로 모든 서비스 정의, 네트워크, 볼륨 등을 관리할 수 있습니다.

---

2️⃣ Docker Compose가 필요한 이유

기존 방식 문제점	Compose의 해결 방식
여러 컨테이너를 일일이 docker run으로 실행해야 함	모든 설정을 yml 파일로 선언하고 한 번에 실행
각 컨테이너 간 네트워크 수동 연결 필요	기본적으로 하나의 사용자 정의 네트워크에서 자동 연결
서비스별 환경변수, 포트, 볼륨 등 설정 반복	선언적 구성으로 재사용성 확보
복잡한 시스템의 상태 관리 어려움	up, down 명령으로 전체 제어 가능

---

3️⃣ Docker Compose 구조

Docker Compose는 다음 세 가지 구성 요소로 이루어집니다:

구성 요소	설명
services	실행할 컨테이너 목록 및 설정 (예: web, db 등)
networks	서비스 간 통신을 위한 네트워크 구성
volumes	데이터 영속성을 위한 저장소 구성

모든 설정은 docker-compose.yml 파일에 작성합니다.

---

4️⃣ 주요 설정 항목

항목	설명
image	사용할 도커 이미지
build	Dockerfile 위치
container_name	컨테이너 이름 지정
ports	호스트 ↔ 컨테이너 포트 매핑
volumes	호스트 ↔ 컨테이너 디렉토리 매핑
depends_on	의존 관계 지정 (ex: web → db)
environment	환경 변수 설정
networks	사용할 네트워크 지정
restart	자동 재시작 정책 설정 (ex: always, on-failure)

---

5️⃣ Compose 실행 흐름 요약

✅ 작성

• docker-compose.yml 파일 작성
• 하나 이상의 서비스 정의 (예: 웹 + DB 등)

✅ 빌드 / 실행

docker images       # 로컬 이미지 확인
docker ps -a        # 컨테이너 상태 확인
docker-compose up --build -d

--build: 필요 시 이미지 재빌드
-d: 백그라운드 모드 실행

✅ 상태 확인

docker ps           # 실행 중 컨테이너 확인
docker-compose logs

✅ 종료 및 정리

Ctrl + C            # 실행 중인 포그라운드 중지
docker-compose down # 모든 컨테이너 및 네트워크 정리

⚠️ down -v 사용 시 볼륨까지 삭제되므로 DB 데이터 주의

---

6️⃣ Healthcheck 설정

✅ 왜 필요한가?

• 단순한 depends_on은 컨테이너 실행만 확인, 실제 서비스가 준비되었는지 확인 불가
• healthcheck로 서비스 준비 상태를 확인하고 의존 컨테이너의 안정성 보장 가능

✅ 예시

MySQL

healthcheck:
  test: [ "CMD", "mysqladmin", "ping", "-h", "127.0.0.1" ]
  interval: 30s
  timeout: 10s
  retries: 5

Redis

healthcheck:
  test: [ "CMD", "redis-cli", "ping" ]
  interval: 30s
  timeout: 10s
  retries: 5

---

7️⃣ 볼륨 설정의 중요성

✅ 이유

• 컨테이너 내부에만 데이터 저장 시 docker-compose down으로 컨테이너가 삭제되면 DB 데이터도 함께 삭제됨
• volumes를 설정해주면 데이터는 호스트에 보존되므로 안전하게 유지 가능

✅ 예시

volumes:
  db-data:

services:
  db:
    volumes:
      - db-data:/var/lib/mysql

⚠️ docker-compose down -v는 볼륨도 함께 삭제되므로 주의!

---

8️⃣ 예시 docker-compose.yml 파일

version: '3.8'

networks:
  custom-network:
    driver: bridge

services:
  fn:
    image: fn
    build:
      context: ./FN
    container_name: fn-container
    ports:
      - "3000:80"
    depends_on:
      - bn
    networks:
      - custom-network

  bn:
    image: bn
    build:
      context: ./BN
    container_name: bn-container
    ports:
      - "8090:8090"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://db-container:3306/bookdb
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: Zhfldk11!
      SPRING_REDIS_HOST: redis
      SERVER_PORT: 8090
    depends_on:
      db:
        condition: service_healthy
    networks:
      - custom-network

  db:
    image: db
    build:
      context: ./DB
      dockerfile: Dockerfile
    container_name: db-container
    networks:
      custom-network:
    ports:
      - "3330:3306"
    healthcheck:
      test: [ "CMD", "mysqladmin", "ping", "-h", "127.0.0.1" ]
      interval: 30s
      timeout: 10s
      retries: 5
    volumes:
      - db-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: Zhfldk11!
      MYSQL_DATABASE: bookdb
      MYSQL_USER: dbconn
      MYSQL_PASSWORD: Zhfldk11!
      MYSQL_ROOT_HOST: '%'
    deploy:
      resources:
        limits:
          memory: 1024M

  redis:
    image: redis
    build:
      context: ./REDIS
    container_name: redis-container
    ports:
      - "6379:6379"
    networks:
      - custom-network

volumes:
  db-data:

---

🔥 정리

• Docker Compose는 복잡한 멀티 컨테이너 구성을 하나의 설정 파일로 선언하고 통합 실행할 수 있는 강력한 도구
• healthcheck, volumes, depends_on 등을 적절히 활용하면 신뢰성 있는 환경 구축 가능
• 개발, 테스트, 배포까지 일관된 구성으로 재현성 확보

---

🔗 참고 자료

• Docker 공식 문서 - Compose
• Docker Compose Examples

---