spring-boot-hexagonal-architecture-application

개발환경 구성

Build

./gradlew clean build

Docker Install

MariaDB Install

• docker-compose 실행

docker-compose up -d

MariaDB Create Database

docker exec -it mariadb10.6 bash
mysql --protocol=tcp -hlocalhost -P3306 -uroot -proot
mysql> CREATE DATABASE board DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
mysql> CREATE DATABASE file DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Local MariaDB 접속 정보

• host / port: localhost:3306
• username: root
• password: root

Data Migration (flyway)

최초로 마이그레이션을 실행할 때는 전체 데이터베이스를 초기화 할 수 있습니다.

./flyway-migration.sh

이후부터는 flywayMigrate 만 실행하여 테스트 데이터는 남겨두고 계속 DB 스키마만 변경할 수 있습니다.

./gradlew flywayMigrate

특정 도메인에 대해 스키마 변경을 진행하기 위해서는 모메인 모듈 명을 표기하여 실행합니다.

./gradlew board-jpa:flywayMigrate
./gradlew file-jpa:flywayMigrate

IntegrationTest

사용하는 IDE가 IntelliJ일 경우 테스트를 수행하기 전, 아래의 설정으로 변경하여 주세요.

• Preferences > Build, Execution, Deployment > Build Tools > Gradle
  • Gradle projects
    • Build and run using : Gradle 에서 IntelliJ IDEA 으로
    • Run tests using : Gradle 에서 IntelliJ IDEA 으로

./gradlew app-container:integrationTest

Run the Application

app-container/src/main/java/me/gogosing/ApplicationInitializr.java

Available Profiles

• 로컬 : local
• 개발 : dev
• 스테이징 : stage
• 운영 : prod

API Documentation

API 명세는 어플리케이션 실행 후, 아래의 경로를 통하여 확인할 수 있습니다.

http://localhost:9090/swagger-ui/index.html