chore: Flyway 마이그레이션 검증 환경 구축 (#149)

.github/workflows/ci.yml

@@ -10,9 +10,30 @@ on:
 
 jobs:
   build:
-    name: Build and Docker Image Check
+    name: Migration, Build and Docker Image Check
     runs-on: ubuntu-latest
 
+    services:
+      mysql:
+        image: mysql:8.4.9
+        env:
+          MYSQL_DATABASE: slatto_ci
+          MYSQL_USER: slatto_ci
+          MYSQL_PASSWORD: ci-password
+          MYSQL_ROOT_PASSWORD: ci-root-password
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -uroot -pci-root-password"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+
+    env:
+      FLYWAY_URL: jdbc:mysql://127.0.0.1:3306/slatto_ci?serverTimezone=Asia/Seoul&characterEncoding=UTF-8&allowPublicKeyRetrieval=true&useSSL=false
+      FLYWAY_USER: slatto_ci
+      FLYWAY_PASSWORD: ci-password
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -27,8 +48,31 @@ jobs:
       - name: Make Gradle Wrapper executable
         run: chmod +x ./gradlew
 
+      - name: Load V8 baseline schema into CI MySQL
+        run: |
+          docker run --rm --network host \
+            -e MYSQL_PWD="$FLYWAY_PASSWORD" \
+            -i mysql:8.4.9 \
+            mysql --host=127.0.0.1 --user="$FLYWAY_USER" slatto_ci \
+            < .github/flyway/baseline-v8.sql
+
+      - name: Baseline and migrate CI MySQL
+        run: |
+          ./gradlew flywayBaseline --no-daemon
+          ./gradlew flywayInfo --no-daemon
+          ./gradlew flywayMigrate --no-daemon
+          ./gradlew flywayValidate --no-daemon
+
+      - name: Validate migrated schema against JPA entities
+        env:
+          FLYWAY_SCHEMA_VALIDATION: "true"
+        run: >-
+          ./gradlew test
+          --tests com.slatto.global.database.FlywaySchemaValidationTest
+          --no-daemon
+
       - name: Test and build Spring Boot jar
         run: ./gradlew clean test bootJar --no-daemon
 
       - name: Build Docker image
-        run: docker build -t slatto-api:ci .
+        run: docker build -t slatto-api:ci .

build.gradle

@@ -1,7 +1,18 @@
+buildscript {
+	repositories {
+		mavenCentral()
+	}
+	dependencies {
+		classpath 'org.flywaydb:flyway-mysql:11.7.2'
+		classpath 'com.mysql:mysql-connector-j:9.7.0'
+	}
+}
+
 plugins {
 	id 'java'
 	id 'org.springframework.boot' version '3.5.15'
 	id 'io.spring.dependency-management' version '1.1.7'
+	id 'org.flywaydb.flyway' version '11.7.2'
 }
 
 group = 'com.slatto'
@@ -18,6 +29,41 @@ repositories {
 	mavenCentral()
 }
 
+flyway {
+	url = providers.environmentVariable('FLYWAY_URL').orNull
+	user = providers.environmentVariable('FLYWAY_USER').orNull
+	password = providers.environmentVariable('FLYWAY_PASSWORD').orNull
+	locations = ['filesystem:src/main/resources/db/migration']
+	baselineOnMigrate = true
+	baselineVersion = '8'
+	baselineDescription = 'legacy-schema'
+	validateOnMigrate = true
+	cleanDisabled = true
+}
+
+def flywayDatabaseTasks = [
+	'flywayBaseline',
+	'flywayClean',
+	'flywayInfo',
+	'flywayMigrate',
+	'flywayRepair',
+	'flywayUndo',
+	'flywayValidate'
+]
+
+tasks.matching { it.name in flywayDatabaseTasks }.configureEach {
+	doFirst {
+		def missingVariables = ['FLYWAY_URL', 'FLYWAY_USER', 'FLYWAY_PASSWORD']
+			.findAll { !providers.environmentVariable(it).orNull?.trim() }
+
+		if (!missingVariables.isEmpty()) {
+			throw new GradleException(
+				"Flyway task requires explicit environment variables: ${missingVariables.join(', ')}"
+			)
+		}
+	}
+}
+
 dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.springframework.boot:spring-boot-starter-security'

src/main/resources/db/migration/V014__project_file_size_not_null.sql

@@ -0,0 +1,5 @@
+-- 파일 업로드 시 항상 저장되는 실제 파일 크기와 스키마 제약을 일치시킨다.
+-- 운영 DB 확인 결과 file_size IS NULL 행은 0건이므로 별도 backfill은 필요하지 않다.
+
+ALTER TABLE project_file
+    MODIFY COLUMN file_size BIGINT NOT NULL;

src/test/java/com/slatto/global/database/FlywaySchemaValidationTest.java

@@ -0,0 +1,16 @@
+package com.slatto.global.database;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.ActiveProfiles;
+
+@SpringBootTest
+@ActiveProfiles("flyway-ci")
+@EnabledIfEnvironmentVariable(named = "FLYWAY_SCHEMA_VALIDATION", matches = "true")
+class FlywaySchemaValidationTest {
+
+	@Test
+	void migratedSchemaMatchesJpaEntities() {
+	}
+}

src/test/resources/application-flyway-ci.yml

@@ -0,0 +1,19 @@
+spring:
+  config:
+    activate:
+      on-profile: flyway-ci
+
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: ${FLYWAY_URL}
+    username: ${FLYWAY_USER}
+    password: ${FLYWAY_PASSWORD}
+
+  jpa:
+    database: mysql
+    database-platform: org.hibernate.dialect.MySQLDialect
+    hibernate:
+      ddl-auto: validate
+
+  flyway:
+    enabled: false