Spring Boot의 기본 프로젝트 설정과 실행

Spring Boot의 기본 프로젝트 설정과 실행

Spring Boot는 자바 기반의 애플리케이션을 쉽고 빠르게 구축할 수 있도록 돕는 프레임워크입니다. 이 글에서는 Spring Boot 프로젝트의 기본적인 설정 방법과 실행 과정에 대해 설명하겠습니다.

프로젝트 생성

Spring Boot 프로젝트를 생성할 때는 Spring Initializr를 활용하는 것이 일반적입니다. 이 웹사이트에서 Build Tool로 Gradle을 선택하고, 사용할 Java 버전을 설정한 후 필요한 의존성들을 추가할 수 있습니다. 예를 들어, Spring Web 모듈과 Thymeleaf 템플릿 엔진을 선택하면 웹 애플리케이션을 신속하게 개발할 수 있습니다.

프로젝트 구조 이해하기

프로젝트를 생성하면 기본적인 디렉토리 구조가 형성됩니다. 이는 다음과 같은 주요 폴더로 구성됩니다:

• src/main/java: Java 소스 파일
• src/main/resources: 리소스 파일 (예: 설정 파일)
• src/test/java: 테스트 소스 파일

리소스 폴더 아래에는 기본적으로 application.properties 또는 application.yml 파일이 포함되어 있으며, 이는 애플리케이션의 설정을 정의하는 데 사용됩니다.

Spring Boot 설정 관리 프로파일

Spring Boot에서는 다양한 환경에 맞춘 설정 관리가 가능하도록 프로파일 기능을 제공합니다. 예를 들어, 개발과 운영 환경에서 각각 다른 데이터베이스를 사용하는 경우, 이 기능이 유용하게 활용될 수 있습니다.

프로파일 설정의 중요성

프로파일을 사용하면 애플리케이션의 설정을 환경별로 분리하여 관리할 수 있습니다. 예를 들어, 데이터베이스 연결 구성이나 보안 관련 설정이 달라질 수 있습니다. 각 프로파일은 application-{profile}.properties 또는 application-{profile}.yml 형식으로 존재하며, 기본 설정 파일에 덮어씌워지는 형태로 작동합니다.

YAML 설정 파일 예시

아래는 두 가지 데이터베이스에 대한 프로파일 설정 예시입니다.

# application.yml
spring:
 profiles:
  active: h2
spring:
 config:
  activate:
   on-profile: h2
 datasource:
  url: jdbc:h2:~/test
  driver-class-name: org.h2.Driver
  username: sa
  password:
spring:
 config:
  activate:
   on-profile: mysql
 datasource:
  url: jdbc:mysql://localhost:3306/test
  driver-class-name: com.mysql.cj.jdbc.Driver
  username: root
  password: secret

위와 같이 설정한 후, 스프링 부트를 실행할 때 활성화할 프로파일을 지정하면 됩니다.

Spring Boot 애플리케이션 실행하기

Spring Boot 애플리케이션을 실행하는 방법은 여러 가지가 있습니다. 가장 일반적인 방법은 터미널에서 java -jar 명령어를 사용하는 것입니다. 이 때 프로파일을 지정하기 위해 --spring.profiles.active=[프로파일명] 옵션을 추가할 수 있습니다.

JAR 파일 실행 예시

아래와 같은 방법으로 JAR 파일을 실행하여 프로파일을 설정할 수 있습니다:

java -jar build/libs/myapp-0.0.1-SNAPSHOT.jar --spring.profiles.active=mysql

또는 -Dspring.profiles.active=[프로파일명] 옵션을 사용하여 프로파일을 설정하는 방법도 가능합니다.

java -jar -Dspring.profiles.active=mysql build/libs/myapp-0.0.1-SNAPSHOT.jar

IntelliJ에서의 프로파일 설정

IntelliJ IDEA를 사용하여 Spring Boot 프로파일을 설정하는 것도 가능합니다. IDE 내에서 실행 구성(run configuration)에서 특정 프로파일을 활성화 할 수 있도록 설정할 수 있습니다. 이를 통해 손쉽게 다양한 환경에서 애플리케이션을 테스트하고 실행할 수 있습니다.

결론

Spring Boot의 프로파일 설정 기능을 적극 활용하면 다양한 환경에서의 설정을 유연하게 관리할 수 있습니다. 이를 통해 애플리케이션의 배포 및 운영 과정이 더욱 매끄럽고 효율적으로 진행될 것입니다. 다양한 설정 방법과 실행 방법을 숙지하여 보다 나은 개발 환경을 구성해 보시기 바랍니다.

자주 찾는 질문 Q&A