벌써 도커 3번째 시리즈입니다. 지금까지 도커의 기초, 이미지와 컨테이너, 네트워크에 대해 배웠습니다. 이번엔 저번 글에 살짝 언급했던 docker compose에 대해 알아보겠습니다.

공식 docs에서는 python을 활용한 compose v1을 더 이상 지원하지 않을 것이니 Go 기반의 compose v2를 사용하라고 하네요. 그러니 이 글에선 v2를 기준으로 작성하겠습니다.

등장 배경

앞서 설명했듯이 현대 어플리케이션은 단일 컨테이너로 구동하기엔 너무나도 많은 것을 요구합니다. 웹 개발을 예시로 들어봅시다. 웹 어플리케이션, 데이터베이스 (MySQL, PostgreSQL), 캐싱 시스템 (Redis, Memcached), 메시지 브로커 (RabbitMQ, Kafka), 로깅 및 모니터링 시스템 (Prometheus, ELK Stack) 등이 사용될 수 있는데 이 많은 요소의 컨테이너들을 각자 관리하기엔 너무 비효율적입니다. 이 불편함을 docker compose 가 해결해줍니다.

기능

• 다중 컨테이너 관리 : 여러 개의 컨테이너를 한 번에 실행 및 중지
• 서비스 정의 : 컨테이너 간 네트워크 설정, 볼륨 마운트, 환경 변수 설정 등을 파일 (docker-compose.yml)로 관리 가능
• 재사용성 : 동일한 docker-compose.yml 을 사용해 동일한 환경을 쉽게 배포 가능
• 스케일링 지원 : 특정 서비스의 컨테이너 개수 조정 가능

💡 YAML

• 데이터 구조화 문법 중 하나 (CSV, JSON, XML, YAML 등)
• 기본 문법
  • # : 주석
  • ... or --- : 문서의 마지막 명시
  • key: value : key-value 값, 반드시 띄어쓰기가 필요
  • 계층 구조를 들여쓰기(indent)로 나타냄
  • int, string, boolean 지원
    • 작은 따옴표 = 문자 그대로 ('\n' 을 그냥 \n으로 인식)
    • 큰 따옴표 = 이스케이프문 구분 ("\n"을 개행문자로 인식)
  • 배열은 하이픈 (-)으로 표현

예제

version: '3.8'

services:
  postgres:
    image: postgres:17.2
    container_name: postgres
    restart: always
    env_file:
      - .env
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - backend_network

  redis:
    image: redis:latest
    container_name: redis
    restart: always
    ports:
      - "6379:6379"
    networks:
      - backend_network

  spring-app:
    image: my-backend:latest
    container_name: spring-app
    restart: always
    depends_on:
      - postgres
      - redis
    ports:
      - "8080:8080"

    environment:
      REDIS_HOST: ${REDIS_HOST}
      REDIS_PORT: ${REDIS_PORT}

    networks:
      - backend_network

networks:
  backend_network:
    driver: bridge

volumes:
  postgres_data:

version

• Docker Compose 버전 지정 (예제는 3.8 사용)
• Docker Compose의 기능 범위 결정
• 사용 중인 Docker 엔진과 호환성을 판단하는데 사용

services

• 실행할 컨테이너 (서비스) 정의
• 동일한 이미지로 여러 컨테이너 실행 가능
• 서비스의 이름 = 컨테이너 이름 = 도커 네트워크 상 다른 컨테이너들이 해당 컨테이너를 식별하는 DNS
• 필드 종류
  • image : 해당 서비스(컨테이너)에서 실행할 이미지
  • environments : 해당 서비스에서 사용할 환경 변수
    • .env 파일을 생성 후 env_file을 통해 설정할 수도 있음 (권장)
  • ports : 공개할 포트 정보
  • networks : 컨테이너가 접속할 도커 네트워크 정의
  • depends_on : 특정 서비스가 실행된 이후에 시작되도록 설정 (왜? 와이? DB 안열렸는데 spring 실행하면 에러 와바박 나니까.)

networks

• 각 컨테이너들이 사용할 networks 설정
  • 현재 예제는 backend_network 만 사용
  • 여러 network 설정 가능
• driver를 설정해 네트워크 종류 선택 가능 (디폴트 = bridge)
• default는 단일 네트워크 생성 후 컨테이너 간 통신
• external을 설정하면 외부 네트워크도 사용 가능

volumes

• 파일 최상단 섹션에서 volumes 정의 후 서비스에서 참조
  • 컨테이너가 삭제되어도 데이터 유지
  • 여러 컨테이너에서 같은 볼륨 공유 가능
• 서비스 내부에서 직접 volumes 지정

  services:
    postgres:
      image: postgres:17.2
      volumes:
        - /var/lib/postgresql/data

  • 이 방식은 익명 볼륨 생성
  • 컨테이너 삭제 시 볼륨도 함께 삭제됨
  • 같은 볼륨을 다른 서비스에서 재사용할 수 없음

주요 명령어

• 컨테이너 실행 (-d : 백그라운드 실행)

docker compose up -d

• 컨테이너 확인 및 중지

docker compose ps
docker compose down

• 특정 서비스 실행 및 중지

docker compose up -d 서비스이름
docker compose stop 서비스이름

• 컨테이너 로그 확인 (-f : 실시간 로그 확인)

docker compose logs -f

• 컨테이너 재시작

docker compose restart

마무리

네.. 생각보다 내용이 별로 어려울 것 없죠? 중요한 것은 networks 설정과 volumes를 어떻게 다룰지 같습니다. 또한 docker compose는 오케스트레이션이 아니라는 점, 다음 글에 오케스트레이션에 대해 다룰 것이라는 것.
그것이 약속이니까.