1. infra 폴더 생성 및 파일 구성
backend
└── mafia
│		└── Project
│		   └── DockerFile
frontend
└── mafia
│		└── Project
│		   └── DockerFile
infra
├── mysql
│   └── schema.sql
├── nginx
│   └── nginx.conf
├── .env
└── docker-compose.yml

  1. Backend DockerFile 작성
# 1. Gradle 빌드 단계
FROM gradle:latest as build

# 2. 작업 디렉토리 설정
WORKDIR /app

# 3. 프로젝트 파일 복사
COPY build.gradle settings.gradle ./
COPY src ./src

# 4. 프로젝트 빌드
RUN gradle clean build -x test

# 5. 실행을 위한 JDK 17 이미지
FROM openjdk:17

# 6. 실행 디렉토리 설정
WORKDIR /app

# 7. 빌드된 JAR 파일 복사
COPY --from=build /app/build/libs/*.jar /app/app.jar

# 8. JAR 파일 실행
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

# 9. 포트 설정
EXPOSE 8080
  1. Frontend DockerFile 작성
# Node.js 18 버전과 Alpine 기반의 경량 이미지를 사용
FROM node:18-alpine

# 컨테이너 내부의 작업 디렉토리를 /app으로 설정
WORKDIR /app

# package.json과 package-lock.json 파일만 복사 (캐시 최적화용)
COPY package*.json ./

# 의존성 설치
RUN npm install

# 전체 프로젝트 파일을 컨테이너로 복사
COPY . .

# Vite 개발 서버의 기본 포트(5173)를 컨테이너 외부에 노출
EXPOSE 5173

# Vite 개발 서버 실행 (0.0.0.0으로 호스트 설정해 외부 접속 허용)
CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]
  1. Docker-compose.yml 작성
services:
  # MySQL 데이터베이스 서비스
  mysql:
    # MySQL 8 버전의 이미지를 사용
    image: mysql:8
    # 컨테이너 이름을 mysql로 설정
    container_name: mysql
    # 컨테이너가 항상 재시작되도록 설정
    restart: always
    # 환경 변수 설정 (데이터베이스 초기 설정 값)
    environment:
      MYSQL_ROOT_PASSWORD: [ROOT_PW]       # MySQL 루트 사용자 비밀번호
      MYSQL_DATABASE: [DB_NAME]           # 생성할 기본 데이터베이스 이름
      MYSQL_USER: [USER_NAME]             # 생성할 사용자 이름
      MYSQL_PASSWORD: [USER_PW]           # 생성할 사용자 비밀번호
    # 컨테이너 내부의 MySQL 포트를 호스트의 3307 포트로 매핑
    ports:
      - "3307:3306"
    # 데이터와 초기화 스크립트를 저장하기 위한 볼륨 설정
    volumes:
      - ./mysql:/docker-entrypoint-initdb.d # 초기화 스크립트 경로
      - db_data:/var/lib/mysql              # MySQL 데이터 디렉토리
    # MySQL 서비스의 상태를 확인하는 healthcheck 설정
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] # 상태 확인 명령어
      interval: 10s                                         # 상태 확인 주기
      timeout: 5s                                           # 상태 확인 시간 초과
      retries: 5                                            # 최대 재시도 횟수
    # 네트워크 설정 (같은 네트워크에서 다른 서비스와 통신 가능)
    networks:
      - app-network

  # Spring Boot 애플리케이션 서비스
  springboot:
    # Spring Boot 애플리케이션을 빌드하기 위한 설정
    build:
      context: ../backend/[Project]       # Spring Boot 프로젝트의 경로
      dockerfile: Dockerfile              # 사용할 Dockerfile
    # 컨테이너 이름을 springboot로 설정
    container_name: springboot
    # MySQL 서비스가 준비된 상태가 되었을 때 시작
    depends_on:
      mysql:
        condition: service_healthy        # MySQL 서비스가 정상일 때만 실행
    # 컨테이너 내부의 8080 포트를 호스트의 8080 포트로 매핑
    ports:
      - "8080:8080"
    # Spring Boot 환경 변수 설정 (데이터베이스 연결 정보)
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/[DB_NAME] # MySQL 컨테이너의 주소
      SPRING_DATASOURCE_USERNAME: [USER_NAME]                 # MySQL 사용자 이름
      SPRING_DATASOURCE_PASSWORD: [USER_PW]                  # MySQL 사용자 비밀번호
    # 데이터 저장소 관련 볼륨 설정
    volumes:
      - ./db_save/[DB_SAVE]:[DB_SAVE]      # 데이터 저장 디렉토리 매핑
    # 네트워크 설정
    networks:
      - app-network

  # Vue.js 프론트엔드 서비스
  vue:
    # Vue.js 애플리케이션을 빌드하기 위한 설정
    build:
      context: ../frontend/[Project]      # Vue 프로젝트의 경로
      dockerfile: Dockerfile              # 사용할 Dockerfile
    # 컨테이너 이름을 vite-app으로 설정
    container_name: vite-app
    # 컨테이너 내부의 5173 포트를 호스트의 5173 포트로 매핑
    ports:
      - "5173:5173"
    # Vue.js 환경 변수 설정 (API 서버 URL)
    environment:
      - VITE_VUE_API_URL=http://localhost:8080/api # API 호출 경로
    # 네트워크 설정
    networks:
      - app-network

# Docker 볼륨 설정 (데이터를 컨테이너 외부에 영구 저장)
volumes:
  db_data: # MySQL 데이터 저장소 볼륨

# Docker 네트워크 설정 (서비스 간 통신을 위한 네트워크)
networks:
  app-network:
    driver: bridge # 브리지 네트워크를 사용 (기본 설정)

  1. bash 이용(윈도우는 git bash)

docker-compose up

docker-compose down

etc) 도커 간단 체크