5. Upgrading Spring Boot

이전 버전의 스프링 부트를 업그레이드하는 방법에 대한 지침은 프로젝트 위키에서 제공된다. 릴리스 노트 섹션의 링크를 따라 업그레이드하려는 버전을 찾아보자.

업그레이드 지침은 항상 릴리스 노트의 첫 번째 항목이다. 두 개 이상의 릴리스가 뒤처져 있는 경우 점프한 버전의 릴리스 노트도 검토해야 한다.

5.1. Upgrading From 1.x

스프링 부트 1.x 릴리스에서 업그레이드하는 경우 자세한 업그레이드 지침을 제공하는 프로젝트 위키의 “마이그레이션 가이드”를 확인해보자. 또한 각 릴리스의 “새롭고 주목할만한” 기능 목록을 보려면 “릴리스 노트”를 확인해보자.

5.2. Upgrading to a New Feature Release

새로운 기능 릴리스로 업그레이드할 때, 일부 프로퍼티의 이름이 바뀌거나 제거되었을 수 있다. 스프링 부트는 애플리케이션 환경을 분석하고, 시작 시 진단 내역을 표시할 수 있는 방법을 제공할 뿐만 아니라 런타임 시 일시적으로 프로퍼티를 마이그레이션할 수도 있다. 해당 기능을 활성화하려면 프로젝트에 다음 의존성을 추가해보자:

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-properties-migrator</artifactId>
        <scope>runtime</scope>
    </dependency>

@PropertySource를 사용할 때와 같이, 환경에 늦게 추가되는 프로퍼티는 고려하지 않는다.

마이그레이션이 완료되면 프로젝트 의존성에서 이 모듈을 제거해야 한다.

5.3. Upgrading the Spring Boot CLI

기존 CLI를 업그레이드하려면 적절한 패키지 관리자 명령(예: brew upgrade)을 사용하자. CLI를 수동으로 설치한 경우 표준 지침을 따르자. 이때 PATH 환경 변수를 업데이트하여 이전 참조를 제거해야 한다.

5.4. What to Read Next

애플리케이션을 업그레이드하기로 결정한 후, 문서의 나머지 부분에서 특정 기능에 대한 자세한 정보를 찾을 수 있다. 스프링 부트 문서는 해당 버전에만 적용되므로 여기에서 찾을 수 있는 모든 정보에는 해당 버전의 최신 변경 사항이 포함되어 있다.