🚀 배포

📖 배포란?

배포는 개발한 애플리케이션을 실제 운영 환경에서 실행하는 과정입니다. Docker를 사용하면 어디서든 동일하게 실행할 수 있습니다!

💡 JAR 빌드

build.gradle.kts 설정

plugins {
    application
    kotlin("jvm") version "1.9.0"
    id("io.ktor.plugin") version "2.3.5"
}

application {
    mainClass.set("com.example.ApplicationKt")
}

ktor {
    fatJar {
        archiveFileName.set("app.jar")
    }
}

빌드 명령

# JAR 파일 생성
./gradlew buildFatJar

# 실행
java -jar build/libs/app.jar

🎯 환경 설정

application.conf

ktor {
    deployment {
        port = 8080
        port = ${?PORT}  # 환경 변수 우선
    }

    application {
        modules = [ com.example.ApplicationKt.module ]
    }
}

database {
    url = "jdbc:postgresql://localhost:5432/mydb"
    url = ${?DATABASE_URL}
    user = "admin"
    user = ${?DATABASE_USER}
    password = "password"
    password = ${?DATABASE_PASSWORD}
}

환경 변수 사용

fun Application.module() {
    val dbUrl = environment.config.property("database.url").getString()
    val dbUser = environment.config.property("database.user").getString()
    val dbPassword = environment.config.property("database.password").getString()

    Database.connect(
        url = dbUrl,
        user = dbUser,
        password = dbPassword
    )

    routing {
        get("/health") {
            call.respondText("OK")
        }
    }
}

🐳 Docker 배포

Dockerfile

# 1단계: 빌드
FROM gradle:8.4-jdk17 AS build
WORKDIR /app

COPY build.gradle.kts settings.gradle.kts ./
COPY src ./src

RUN gradle buildFatJar --no-daemon

# 2단계: 실행
FROM openjdk:17-jdk-slim
WORKDIR /app

COPY --from=build /app/build/libs/app.jar ./app.jar

EXPOSE 8080

CMD ["java", "-jar", "app.jar"]

docker-compose.yml

version: '3.8'

services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=jdbc:postgresql://db:5432/mydb
      - DATABASE_USER=admin
      - DATABASE_PASSWORD=secret
    depends_on:
      - db

  db:
    image: postgres:15
    environment:
      - POSTGRES_DB=mydb
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=secret
    volumes:
      - db-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  db-data:

실행

# 빌드 및 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f app

# 중지
docker-compose down

🔧 프로덕션 설정

로깅

import org.slf4j.LoggerFactory

val logger = LoggerFactory.getLogger("Application")

fun Application.module() {
    logger.info("애플리케이션 시작")

    routing {
        get("/") {
            logger.info("/ 요청")
            call.respondText("Hello!")
        }
    }
}

CORS 설정

import io.ktor.server.plugins.cors.routing.*

fun Application.module() {
    install(CORS) {
        allowHost("myapp.com", schemes = listOf("https"))
        allowHeader(HttpHeaders.ContentType)
        allowMethod(HttpMethod.Options)
        allowMethod(HttpMethod.Get)
        allowMethod(HttpMethod.Post)
        allowCredentials = true
    }
}

압축

import io.ktor.server.plugins.compression.*

fun Application.module() {
    install(Compression) {
        gzip {
            priority = 1.0
        }
        deflate {
            priority = 10.0
            minimumSize(1024)
        }
    }
}

🛡️ 보안

HTTPS 설정

embeddedServer(Netty, environment = applicationEngineEnvironment {
    connector {
        port = 8080
    }

    sslConnector(
        keyStore = KeyStore.getInstance("PKCS12").apply {
            load(FileInputStream("keystore.p12"), "password".toCharArray())
        },
        keyAlias = "myalias",
        keyStorePassword = { "password".toCharArray() },
        privateKeyPassword = { "password".toCharArray() }
    ) {
        port = 8443
    }
}).start(wait = true)

Rate Limiting (간단 버전)

class RateLimiter {
    private val requests = mutableMapOf<String, MutableList<Long>>()
    private val limit = 100  // 100 requests
    private val windowMs = 60_000L  // per minute

    fun isAllowed(key: String): Boolean {
        val now = System.currentTimeMillis()
        val userRequests = requests.getOrPut(key) { mutableListOf() }

        // 오래된 요청 제거
        userRequests.removeIf { it < now - windowMs }

        return if (userRequests.size < limit) {
            userRequests.add(now)
            true
        } else {
            false
        }
    }
}

fun Application.module() {
    val rateLimiter = RateLimiter()

    routing {
        intercept(ApplicationCallPipeline.Call) {
            val ip = call.request.origin.remoteHost

            if (!rateLimiter.isAllowed(ip)) {
                call.respond(HttpStatusCode.TooManyRequests)
                finish()
            }
        }

        get("/api/data") {
            call.respondText("데이터")
        }
    }
}

🎯 모니터링

Health Check

fun Application.module() {
    routing {
        get("/health") {
            val dbHealth = try {
                transaction {
                    exec("SELECT 1") {}
                }
                "ok"
            } catch (e: Exception) {
                "error"
            }

            call.respond(
                mapOf(
                    "status" to "ok",
                    "database" to dbHealth,
                    "timestamp" to System.currentTimeMillis()
                )
            )
        }
    }
}

메트릭

class Metrics {
    private val requestCount = AtomicInteger(0)
    private val errorCount = AtomicInteger(0)

    fun incrementRequests() = requestCount.incrementAndGet()
    fun incrementErrors() = errorCount.incrementAndGet()

    fun getMetrics() = mapOf(
        "requests" to requestCount.get(),
        "errors" to errorCount.get()
    )
}

fun Application.module() {
    val metrics = Metrics()

    routing {
        intercept(ApplicationCallPipeline.Monitoring) {
            metrics.incrementRequests()
            try {
                proceed()
            } catch (e: Exception) {
                metrics.incrementErrors()
                throw e
            }
        }

        get("/metrics") {
            call.respond(metrics.getMetrics())
        }
    }
}

🔥 실전 배포 예제

완전한 설정

// Application.kt
fun main(args: Array<String>) {
    EngineMain.main(args)
}

fun Application.module() {
    // 설정 로드
    val config = environment.config

    // 로깅
    install(CallLogging) {
        level = Level.INFO
    }

    // CORS
    install(CORS) {
        allowHost(config.property("cors.host").getString())
        allowCredentials = true
    }

    // 압축
    install(Compression)

    // JSON
    install(ContentNegotiation) {
        json()
    }

    // 에러 처리
    install(StatusPages) {
        exception<Throwable> { call, cause ->
            log.error("Unhandled exception", cause)
            call.respond(
                HttpStatusCode.InternalServerError,
                mapOf("error" to "Internal server error")
            )
        }
    }

    // 데이터베이스
    configureDatabases(config)

    // 라우팅
    configureRouting()
}

fun Application.configureDatabases(config: ApplicationConfig) {
    val url = config.property("database.url").getString()
    val user = config.property("database.user").getString()
    val password = config.property("database.password").getString()

    Database.connect(
        url = url,
        user = user,
        password = password
    )
}

🤔 자주 묻는 질문

Q1. 어디에 배포하나요?

A: 클라우드 서비스 추천!

# AWS (Elastic Beanstalk, ECS)
# Google Cloud (Cloud Run)
# Azure (App Service)
# DigitalOcean (App Platform)
# Heroku

# Docker만 있으면 어디든 가능!

Q2. 무중단 배포는?

A: Blue-Green 배포나 Rolling Update!

# docker-compose.yml (Rolling Update)
version: '3.8'

services:
  app:
    image: myapp:latest
    deploy:
      replicas: 3
      update_config:
        parallelism: 1
        delay: 10s

Q3. 환경별 설정은?

A: 프로파일 사용!

// application-dev.conf
ktor {
    deployment {
        port = 8080
    }
}

// application-prod.conf
ktor {
    deployment {
        port = 80
    }
}

// 실행
java -jar app.jar -config=application-prod.conf

🎬 마치며

안전하고 효율적인 배포를!

핵심 정리:
✅ JAR 빌드로 실행 파일
✅ Docker로 환경 통일
✅ 환경 변수로 설정 분리
✅ Health Check로 모니터링
✅ 보안 설정 필수

축하합니다! Backend 시리즈와 모든 Kotlin 문서를 완료했습니다! 🎉

이제 Kotlin으로 풀스택 개발이 가능합니다!

전체 시리즈 복습:

• Basics: Kotlin 기초 문법
• Practical: 실전 활용 (확장 함수, 예외, 파일, 정규식, DSL)
• Coroutines: 비동기 프로그래밍
• Testing: 테스트 작성
• Backend: 서버 개발과 배포