Kotlin, Spring Cloud Function, AWS Lambda 함수 제작하기

개요

• 이번 글에서는 Kotlin, Spring Cloud Function을 이용하여 함수를 작성하고, AWS Lambda에 업로드하는 방법을 설명하고자 한다.

Spring Boot 프로젝트 생성

• Spring Initializr 웹사이트를 방문하여 아래 옵션으로 빠르게 시작점이 되는 빈 프로젝트를 생성할 수 있다.

브라우저에서 https://start.spring.io/ 접속
→ Project: [Gradle Project] 선택 (기본값: Maven Project)
→ Language: [Kotlin] 선택 (기본값: Java)
→ Spring Boot: 2.X.X (Java 11을 지원하는 마지막 버전인 2.X.X를 선택)
→ Packaging: [Jar] 선택
→ Java: [11] 선택
→ [Generate] 클릭

• 현재 AWS Lambda는 Java 11까지 지원한다. 따라서 Java 11을 지원하는 Spring Boot 최신 버전인 2.X.X을 선택해야 한다.
• 다운로드가 완료되면 demo.zip 파일의 압축을 풀어 생성된 프로젝트를 확인할 수 있다. IntelliJ IDEA로 build.gradle.kts 파일을 실행하면 프로젝트가 열린다.

build.gradle.kts

• 프로젝트의 루트의 build.gradle.kts에 아래 내용을 추가한다. (특히, 아래 내용은 AWS Lambda Function로 프로젝트를 기능하도록 하기 위한 가장 복잡하면서 중요한 부분이다.)

plugins {
    ...
    id("com.github.johnrengelman.shadow") version "7.1.2"
}

dependencies {
    ...
    // org.springframework.cloud:spring-cloud-starter-function-web 을 삭제하고 org.springframework.cloud:spring-cloud-starter-function-web 으로 대체
    // Java 11을 마지막으로 지원하는 3.X.X으로 명시
    implementation("org.springframework.cloud:spring-cloud-starter-function-web:3.2.8")
    implementation("org.springframework.cloud:spring-cloud-function-kotlin:3.2.8")
    implementation("org.springframework.cloud:spring-cloud-function-adapter-aws:3.2.8")
    implementation("com.amazonaws:aws-lambda-java-events:3.11.0")
    implementation("com.amazonaws:aws-lambda-java-core:1.2.2")
    runtimeOnly("com.amazonaws:aws-lambda-java-log4j2:1.5.1")
}

tasks.withType<Jar> {
    manifest {
        attributes["Start-Class"] = "com.example.demo.DemoApplication"
    }
}

tasks.assemble {
    dependsOn("shadowJar")
}

tasks.withType<com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar> {
    archiveFileName.set("demo-function.jar")
    dependencies {
        exclude("org.springframework.cloud:spring-cloud-function-web")
    }
    mergeServiceFiles()
    append("META-INF/spring.handlers")
    append("META-INF/spring.schemas")
    append("META-INF/spring.tooling")
    transform(com.github.jengelman.gradle.plugins.shadow.transformers.PropertiesFileTransformer::class.java) {
        paths.add("META-INF/spring.factories")
        mergeStrategy = "append"
    }
}

application.yml

• 프로젝트의 루트의 build.gradle.kts에 아래 내용을 추가한다.

spring:
  cloud:
    function:
      definition: reverseString
  main:
    banner-mode: off

logging:
  level:
    root: info

함수 작성

• 아래는 Input 문자열을 거꾸로 뒤집어 Output 문자열로 반환하는 간단한 기능의 함수를 작성한 예이다.

import org.springframework.context.annotation.Bean
import org.springframework.stereotype.Component

@Component
class FooFunction {

    @Bean
    fun reverseString(): (String) -> String {

        return { it.reversed() }
    }
}

프로젝트 실행 및 테스트

• 프로젝트 제작이 완료되었으면 아래와 같이 실행 및 테스트가 가능하다.

# 프로젝트 실행
$ ./gradlew bootRun

# 앞서 제작한 reverseString 기능 작동 테스트
$ curl localhost:8080/reverseString -H "Content-Type: text/plain" -d "Hello World"
dlroW olleH

프로젝트 빌드 및 업로드

• 이제 프로젝트를 빌드할 차례이다. 빌드가 완료되면 build/libs/demo-function.jar 파일이 생성된 것을 확인할 수 있다. 이 파일을 Amazno S3의 임의의 버킷에 업로드한다.

# 프로젝트 빌드
$ ./gradlew shadowJar

AWS Lambda 함수 생성

• AWS Lambda 함수를 생성할 차례이다.

AWS Lambda 콘솔 접속
→ [함수]
→ [함수 생성]
→ 함수 이름: [foo-function] 입력
→ 런타임: [Java 11 (Corretto)] 선택
→ 아키텍처: [x86_64] 선택
→ [함수 생성]

• 앞서 Amazon S3에 업로드한 주소를 이용하여 프로젝트를 업로드한다.

코드 소스
→ [에서 업로드]
→ [Amazon S3 위치]
→ Amazon S3 링크 URL: (S3에 업로드한 URL 입력)
→ [저장]

• 함수가 정상적으로 실행되려면 런타임 핸들러를 아래와 같이 지정해야 한다.

런타임 설정
→ [편집]
→ 핸들러: [org.springframework.cloud.function.adapter.aws.FunctionInvoker::handleRequest] 입력
→ [저장]

참고 글

• Spring Cloud Function AWS Adaptor
• Samples for AWS Lambda + Spring Cloud Function + Kotlin
• Serverless Functions with Spring Cloud Function
• Spring Cloud Function Example for AWS Lambdas