Spring Boot에서 실행되는 Tomcat 서버 포트 변경 방법

참고 문서

• Spring.io: Common Application Properties

이 문서의 내용

테스트 환경 및 주요 아젠다

Spring Boot를 사용하여 두 개 이상의 Spring 애플리케이션을 실행하고 있습니다.

애플리케이션에서 실행되는 Tomcat 서버의 디폴트 포트 8080이 중복되면서 두 번째 이상의 Tomcat 서버가 실행되지 않습니다.

Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.

application.properties

애플리케이션 설정 파일 application.properties를 생성하고 다음 프로퍼티를 추가합니다.

server.port = 8080

server.port 프로퍼티는 Spring Boot 애플리케이션에서 실행되는 Tomcat 서버 포트를 지정합니다.

다른 서비스에서 사용하는 포트와 중복되지 않도록 프로퍼티 값을 입력합니다.

Step 1: 외부 설정 파일로 사용

application.properties 파일을 Spring Boot 애플리케이션이 읽기 위해 외부 설정 파일로 사용합니다.

Gradle 빌드 환경에서 ./gradlew build를 실행하였다면 프로젝트 루트 디렉토리에서 build/libs/에 JAR 파일이 생성됩니다.

$ ./gradlew build

$ cd build/libs/
$ ls
<프로젝트 이름>-0.0.1-SNAPSHOT.jar

JAR 파일과 동일한 경로에서 application.properties 파일을 저장합니다.

Java 명령문 java -jar로 애플리케이션을 실행하면 동일한 경로의 설정 파일을 읽습니다.

Step 2: 내부 설정 파일로 사용

프로젝트 루트 디렉토리에서 src/main/resources/의 application.properties 파일을 사용합니다.

프로젝트 내부 설정 파일로 사용하면 ./gradlew bootRun 실행으로도 설정 파일을 읽습니다.

$ ./gradlew bootRun

Tomcat started on port(s): 8089 (http) with context path ''

정리 및 복습

• Spring Boot로 실행되는 Tomcat 서버 포트를 변경하려면 server.port 프로퍼티를 사용합니다.
• 프로퍼티는 application.properties 파일에서 관리합니다.
• 설정 파일은 JAR 파일이 위치한 경로에서의 외부 설정 파일과 resources 경로에서의 내부 설정 파일로 구분됩니다.