📌 [Docker CI/CD 시리즈 2편] docker-compose로 풀스택 서비스 통합 배포하기

📅 2025-06-05

📝 학습 내용

1️⃣ docker-compose란?

docker-compose는 여러 개의 Docker 컨테이너를 하나의 YAML 파일로 정의하고, 한 번의 명령으로 일괄 실행할 수 있도록 해주는 Docker 공식 도구입니다.

• 복잡한 서비스 구조를 정의하고 통합 관리 가능
• 컨테이너 간 네트워크 설정 자동 처리
• build, depends_on, volumes, environment 등 다양한 설정 가능

2️⃣ docker-compose.yml 기본 구조 예시 및 설명

docker-compose.yml 파일은 여러 서비스(FE, BE, DB, Redis, Jenkins)를 하나의 통합된 구조로 배포하기 위한 설정입니다. 각 서비스는 다음과 같은 역할을 합니다:

• fn: 프론트엔드 (React 기반)
• bn: 백엔드 (Spring Boot)
• db: MySQL 데이터베이스
• redis: 캐시 서버
• jenkins: CI/CD 자동화를 위한 Jenkins 서버

version: '3.8'

networks:
  custom-network:
    driver: bridge

services:
  fn:
    image: boogiewoong2/docker_hub_test:fn
    container_name: fn-container
    ports:
      - "3000:80"
    depends_on:
      - bn
    networks:
      - custom-network

  bn:
    image: boogiewoong2/docker_hub_test: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: 1234
      SPRING_REDIS_HOST: redis
      SERVER_PORT: 8090
    depends_on:
      db:
        condition: service_healthy
    networks:
      - custom-network

  db:
    image: boogiewoong2/docker_hub_test:db
    container_name: db-container
    ports:
      - "3330:3306"
    networks:
      custom-network:
    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: 1234
      MYSQL_DATABASE: bookdb
      MYSQL_USER: dbconn
      MYSQL_PASSWORD: 1234
      MYSQL_ROOT_HOST: '%'
    deploy:
      resources:
        limits:
          memory: 1024M

  redis:
    image: boogiewoong2/docker_hub_test:redis
    container_name: redis-container
    ports:
      - "6379:6379"
    networks:
      - custom-network

  jenkins:
    image: jenkins
    build:
      context: ./JENKINS
    container_name: jenkins-container
    ports:
      - "9090:8080"
      - "50000:50000"
    volumes:
      - jenkins-data:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      - custom-network

volumes:
  db-data:
  jenkins-data:

3️⃣ EC2에 Docker & Compose 설치

1. EC2 인스턴스 접속 (PuTTY)
   • .ppk 키와 퍼블릭 DNS 입력 → Open
   • 로그인: ec2-user → sudo su
2. Docker 설치

sudo yum update -y
sudo yum install docker -y
systemctl restart docker
systemctl enable docker
docker -v
usermod -aG docker ec2-user

1. docker-compose 설치

DOCKER_COMPOSE_VERSION="v2.27.1"
sudo curl -L "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" \
  -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
docker-compose version

4️⃣ docker-compose 실행 방법

1. .yml 파일이 있는 디렉토리로 이동

cd ~/DOCKER/05_DOCKER_COMPOSE_DEPLOY

1. 실행

docker compose up -d

1. 상태 확인

docker ps -a

1. 재배포 필요 시

docker compose down
docker system prune -a
docker compose build --no-cache
docker compose up -d

---

🔥 정리

• docker-compose를 이용하면 복잡한 서비스를 선언형으로 관리하고 일괄 실행 가능
• EC2에 Docker와 Compose를 직접 설치하여 클라우드 기반 배포 가능
• depends_on, healthcheck, volumes, build, environment 등 설정을 적극 활용할 것
• Jenkins까지 포함한 구성으로 CI/CD 통합 기반 마련

🔗 참고 자료

• Compose 공식 문서
• AWS EC2 사용자 가이드

---