Junhyunny's Devlogs

글 검색

기술 글 제목, 본문, 카테고리에서 검색합니다.

    이전 화면으로

    스프링 부트 3.0.X 버전으로 업그레이드

    • spring-boot
    • spring-cloud
    • jpa
    • query-dsl
    이 글의 목차

    0. 들어가면서

    spring-boot-starter-parent 2.7.4 버전에서 3.0.2 버전으로 업그레이드하면서 마주친 에러들에 대해 정리하였다. 문제가 발생한 것들은 다음과 같다.

    • JDK 17 and Jakarta EE 9
    • JPA QueryDSL
    • Spring Cloud

    1. JDK 17 and Jakarta EE 9

    2018년 2월 28일부터 약 4년 동안 운영된 2.X 버전이 3.X 버전으로 업그레이드되었다. 다음과 같은 사항들이 변경되었다.

    • JDK17 버전 이상을 사용해야 한다.
    • Java EE(enterprise edition)은 Jakarta EE로 되었다.
      • javax.* 패키지에 속하는 기능들이 jakarta.* 패키지로 대체되었다.

    This next major revision will be based on Spring Framework 6.0 and will require Java 17 or above. It will also be the first version of Spring Boot that makes use of Jakarta EE 9 APIs (jakarta.) instead of EE 8 (javax.).

    해당 문제로 다음과 같은 작업들을 수행하였다.

    • IDE(integrated development environment)의 JDK 컴파일러를 변경한다.
      • JDK8에서 JDK17으로 변경한다.
    • pom.xml 파일의 java.version 변경한다.
      • 1.8에서 17으로 변경한다.
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>3.0.2</version>
            <relativePath/> <!-- lookup parent from repository -->
        </parent>
        ...
        <properties>
            <java.version>17</java.version>
            <spring-cloud.version>2021.0.3</spring-cloud.version>
        </properties>
    • Dockerfile에서 사용하는 이미지를 변경한다.
      • maven:3.8.6-jdk-8에서 maven:3.8.3-openjdk-17으로 변경한다.
      • openjdk:8에서 openjdk:17-alpine으로 변경한다.
    # Maven Build
    FROM maven:3.8.3-openjdk-17 as MAVEN_BUILD
    
    WORKDIR /build
    
    COPY pom.xml .
    
    RUN --mount=type=cache,target=/root/.m2 mvn dependency:go-offline
    
    COPY src ./src
    
    RUN --mount=type=cache,target=/root/.m2 mvn package -Dmaven.test.skip=true
    
    # Run
    FROM openjdk:17-alpine
    
    WORKDIR /app
    
    ARG JAR_FILE=*.jar
    
    COPY --from=MAVEN_BUILD /build/target/${JAR_FILE} ./app.jar
    
    EXPOSE 8080
    
    ENTRYPOINT exec java -jar ./app.jar
    • javax.* 패키지 의존성을 jakarta.*로 변경한다.
    package action.in.blog.controller;
    
    import jakarta.servlet.ServletRequest;
    import jakarta.servlet.ServletResponse;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @Slf4j
    @RestController
    public class BlogController {
    
        @GetMapping("/health")
        public String health(ServletRequest servletRequest, ServletResponse servletResponse) {
            log.info("health");
            return "OK";
        }
    }

    2. JPA QueryDSL Compatibility

    JPA, QueryDSL을 사용한다면 EntityManager가 호환이 되지 않는 문제가 발생한다. 기존 EntityManager는 javax.persistence.* 패키지에 속한다. jakarta.persistence.* 패키지로 대체되면서 JPAQueryFactory 클래스에서 컴파일 에러가 발생한다.

    • pom.xml 파일의 QueryDSL 관련 의존성에 jakarta 식별자(classifier)를 추가한다.
        <dependency>
            <groupId>com.querydsl</groupId>
            <artifactId>querydsl-apt</artifactId>
            <version>${querydsl.version}</version>
            <classifier>jakarta</classifier>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>com.querydsl</groupId>
            <artifactId>querydsl-jpa</artifactId>
            <version>${querydsl.version}</version>
            <classifier>jakarta</classifier>
        </dependency>

    3. Substitution for spring-cloud-starter-sleuth

    스프링 부트를 3.0.X 버전으로 업그레이드되었으므로 이에 맞는 스프링 클라우드 버전을 사용한다. 스프링 클라우드 공식 홈페이지에 릴리즈 트레인(release train)이 표로 정리되어 있다.

    Release Train Release Train
    2022.0.x aka Kilburn 3.0.x
    2021.0.x aka Jubilee 2.6.x, 2.7.x (Starting with 2021.0.3)
    2020.0.x aka Ilford 2.4.x, 2.5.x (Starting with 2020.0.3)
    Hoxton 2.2.x, 2.3.x (Starting with SR5)
    Greenwich 2.1.x
    Finchley 2.0.x
    Edgware 1.5.x
    Dalston 1.5.x

    다음과 같이 pom.xml 파일의 스프링 클라우드 버전을 변경한다.

    • 2021.0.3에서 2022.0.1으로 변경한다.
        <properties>
            <java.version>17</java.version>
            <spring-cloud.version>2022.0.1</spring-cloud.version>
        </properties>

    스프링 클라우드 버전을 변경 후 컴파일을 수행하면 다음과 같은 에러를 만나게 된다.

    org.springframework.cloud:spring-cloud-starter-sleuth:jar:unknown was not found in https://repo.maven.apache.org/maven2 during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of central has elapsed or updates are forced

    클라우드 환경에서 트랜잭션 추적을 위해 사용했던 Spring Cloud Sleuth는 릴리즈 체인에서 제외되었다. 대신 Micrometer Tracing 프로젝트에서 관리하는 의존성으로 대체되었다.

    Spring Cloud Sleuth
    This project has been removed from the release train. The core of this project has moved to Micrometer Tracing project and the instrumentations will be moved to Micrometer and all respective projects(no longer all instrumentations will be done in a single repository).

    3.1. Setup for micrometer-tracing in pom.xml

    pom.xml 파일에 다음과 같은 의존성들을 추가하는 작업을 수행한다.

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>io.micrometer</groupId>
                <artifactId>micrometer-tracing-bom</artifactId>
                <version>${micrometer-tracing.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    
    <dependencies>
    <!-- have to remove sleuth dependency -->
    <!--<dependency>-->
    <!--    <groupId>org.springframework.cloud</groupId>-->
    <!--    <artifactId>spring-cloud-starter-sleuth</artifactId>-->
    <!--</dependency>-->
        <dependency>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-tracing</artifactId>
        </dependency>
        <dependency>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-tracing-bridge-brave</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
    </dependencies>

    3.2. Make logging pattern for TraceID and SpanID in application.yml

    application.yml 파일에 다음과 같은 작업을 수행한다.

    spring:
      application:
        name: action-in-blog
    logging:
      pattern:
        level: "%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]"
    TraceID and SpanID in Log

    위 작업을 수행하면 다음과 같은 로그를 볼 수 있다.

    2023-02-10T22:53:18.240+09:00  INFO [action-in-blog,63e64c4e61be68dfce5b35b5ebe3cf4d,ce5b35b5ebe3cf4d] 17484 --- [nio-8080-exec-1] a.in.blog.controller.BlogController      : health
    2023-02-10T22:53:19.836+09:00  INFO [action-in-blog,63e64c4f25832747b013fc32f0a099f7,b013fc32f0a099f7] 17484 --- [nio-8080-exec-2] a.in.blog.controller.BlogController      : health

    KEEP READING

    DISCUSSION

    댓글