[Docker] Spring boot + MariaDB | docker-compose로 실행하기

기존에 개발하던 프로젝트에 docker-compose를 적용시켜보았다. 추가로 Nginx를 띄워 3개의 spring server에 로드밸런싱도 해보았다. 

 

그 전에 docker compose 실행 종료 명령어에 대해 정리해보았다.

도커는 기본적으로 캐싱을 수행하기 때문에 docker compose를 실행했을 때 수정 사항이 적용되지않는 경우가 종종 있었다. 따라서 아래와 같은 명령어로 실행, 종료를 권장한다.

• 실행: docker compose up --force-recreate
• 종료: docker compose down --rmi all

 

Spring boot + MariaDb

application.yml

spring:
  datasource:
    driver-class-name: org.mariadb.jdbc.Driver
    url: jdbc:mariadb://database:3306/colony
    username: root
    password: 1234
  servlet:
    multipart:
      max-file-size: 30MB
      max-request-size: 30MB
  jpa:
    hibernate:
      ddl-auto: update
    properties:
      hibernate:
        default_batch_fetch_size: 1000
        dialect: org.hibernate.dialect.MySQL8Dialect
  mvc:
    async:
      request-timeout: -1

 

docker-compose.yml

version: "3.8"                                          # 파일 규격 버전
services:                                               # 이 항목 밑에 실행하려는 컨테이너들을 정의
  database:
    container_name: database
    build:
      dockerfile: Dockerfile
      context: ./database
    image: dgjisnu/database
    environment:
      - MARIADB_DATABASE=colony
      - MARIADB_ROOT_PASSWORD=1234
    volumes:
      - ./database/config:/etc/mysql/conf.d
      - ./database/data:/var/lib/mysql
    ports:
      - "13306:3306"      # 접근 포트 설정 (컨테이너 외부:컨테이너 내부)

  colony-app:
    container_name: colony-app
    build: .
    depends_on: # DB, REDIS 컨테이너가 실행된 다음 WEB을 실행시킨다.
      - database
    image: dgjinsu/colony-app
    environment:
      - MAIL_PASSWORD=${MAIL_PASSWORD}
      - MAIL_USERNAME=${MAIL_USERNAME}
      - S3_ACCESS_KEY=${S3_ACCESS_KEY}
      - S3_SECRET_KEY=${S3_SECRET_KEY}
    ports:
      - "80:8080"
    restart: always # depends on은 실행 순서만 컨트롤 할뿐,

여기서 삽질을 꽤나 했다.

초반에 DB만 도커로 띄워두고 서버는 로컬로 실행하는 형태로 개발을 진행했다. 이때 DB ports 부분에 "3306:3306" 으로 하게 되면 local에 깔린 mysql 때문에 포트 충돌이 난다. 따라서 외부 포트를 13306으로 바꿔주었고 application.yml 파일 안에 DB연결 로직에 url: jdbc:mariadb://localhost:13306/ 으로 수정해주었다. 

개발이 끝나고 스프링도 컨테이너로 띄우기 위해 수정하였고 db연결 부분 코드를 url: jdbc:mariadb://database:13306/ 으로 바꿔주었다. 하지만 docker compose up 을 했을 때 자꾸 db연결에 실패했다. 

원인은 포트였다. 기존에는 도커 외부에서 도커 내부 컨테이너로 접근했기 때문에 13306 포트를 사용하는게 맞았지만 컨테이너로 띄워진 스프링에선 db 컨테이너로 접근하기 위해선 3306 포트로 접근해야했다. 

조금만 생각하면 해결될 문제였지만 도커에 대한 개념이 부족했었다.  

 

environment 같은 경우는 docker-compose.yml 파일과 동일 경로에 .env 파일을 만들어 환경변수를 설정해주었다. 

컨테이너를 지웠다 다시 띄워도 DB 데이터를 유지하기 위해선 볼륨 설정이 필요하다. ./database/data:/var/lib/mysql 코드를 통해 데이터를 마운트 시켜주었다. 

 

Spring Dockerfile

FROM openjdk:17-jdk
ARG JAR_FILE=build/libs/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

 

database Dockerfile

FROM mariadb:10

ENV TZ=Asia/Seoul

database conf

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
skip-character-set-client-handshake

[mysqldump]
default-character-set=utf8mb4

 

 

 

Nginx + 3 * Spring boot + mariaDB

위 그림처럼 Nginx에서 80포트로 들어오는 클라이언트 요청을 스프링 컨테이너 3개로 분산시켜준다고 생각하면 된다.

 

application.yml은 위 와 같다.

 

docker-compose.yml

version: "3.8"                                          # 파일 규격 버전
services:                                               # 이 항목 밑에 실행하려는 컨테이너들을 정의
  database:
    container_name: database
    build:
      dockerfile: Dockerfile
      context: ./database
    image: dgjisnu/database
    environment:
      - MARIADB_DATABASE=colony
      - MARIADB_ROOT_PASSWORD=1234
    volumes:
      - ./database/config:/etc/mysql/conf.d
      - ./database/data:/var/lib/mysql
    ports:
      - "13306:3306"      # 접근 포트 설정 (컨테이너 외부:컨테이너 내부)

  colony-app1:
    container_name: colony-app1
    build: .
    depends_on: # DB, REDIS 컨테이너가 실행된 다음 WEB을 실행시킨다.
      - database
    image: dgjinsu/colony-app1
    environment:
      - MAIL_PASSWORD=${MAIL_PASSWORD}
      - MAIL_USERNAME=${MAIL_USERNAME}
      - S3_ACCESS_KEY=${S3_ACCESS_KEY}
      - S3_SECRET_KEY=${S3_SECRET_KEY}
    restart: always # depends on은 실행 순서만 컨트롤 할뿐,
    ports:
      - '8080:8080'
  colony-app2:
    container_name: colony-app2
    build: .
    depends_on: # DB, REDIS 컨테이너가 실행된 다음 WEB을 실행시킨다.
      - database
    image: dgjinsu/colony-app2
    environment:
      - MAIL_PASSWORD=${MAIL_PASSWORD}
      - MAIL_USERNAME=${MAIL_USERNAME}
      - S3_ACCESS_KEY=${S3_ACCESS_KEY}
      - S3_SECRET_KEY=${S3_SECRET_KEY}
    restart: always # depends on은 실행 순서만 컨트롤 할뿐,
    ports:
      - '8081:8080'
  colony-app3:
    container_name: colony-app3
    build: .
    depends_on: # DB, REDIS 컨테이너가 실행된 다음 WEB을 실행시킨다.
      - database
    image: dgjinsu/colony-app3
    environment:
      - MAIL_PASSWORD=${MAIL_PASSWORD}
      - MAIL_USERNAME=${MAIL_USERNAME}
      - S3_ACCESS_KEY=${S3_ACCESS_KEY}
      - S3_SECRET_KEY=${S3_SECRET_KEY}
    restart: always # depends on은 실행 순서만 컨트롤 할뿐,
    ports:
      - '8082:8080'


  proxy-be:
    image: nginx:1.21.5-alpine
    container_name: colony-nginx
    restart: always
    depends_on:
      - colony-app1
      - colony-app2
      - colony-app3
    ports:
      - "80:80"
    volumes:
      - ./proxy/nginx-be.conf:/etc/nginx/nginx.conf

 

nginx-be.conf

events { worker_connections 1024; }
http{
    upstream colony-app {
    server colony-app1:8080;
    server colony-app2:8080;
    server colony-app3:8080;
    }
    server {
            listen 80;
    location / {
            proxy_pass http://colony-app;
            }
    }
}

위에서 삽질한 덕분에 여기선 바로 성공할 수 있었다. app1, 2, 3은 8080, 8081, 8082 포트를 8080포트로 포워딩 시켜주지만 nginx에서 접근할 땐 전부 8080포트로 접근해야 한다.