[VSCode] SpringBoot 로컬에서 실행하는 법

yricog·2025년 1월 9일
0

프로젝트 진행 중에 백엔드를 로컬에서 돌려 테스트할 상황이 생겼는데, 백엔드(java) 세팅은 처음 해보는 거라 생각보다 시간이 많이 걸렸다..ㅎㅎ
그 과정들을 정리해 보았다 😀

  • 실행 환경 : MacOS M3, VSCode

1. JDK 설치

JDK는 Java 애플리케이션을 컴파일하고 실행하는 데 필요한 필수 소프트웨어이다.

$ which java     //java 위치 확인 
$ java --version //java 버전 확인  

2. gradle 설치

Gradle은 Java 프로젝트 빌드를 자동화하는 도구로, Java Development Kit (JDK)와 함께 사용되어야 한다.

$ brew install gradle
$ gradle -v   

3. VSCode Extension 설치

  • Debugger for Java
    - Red Hat의 Java™에 대한 언어 지원
    - 자바용 디버거(Debugger for Java)
    - 자바용 테스트 러너
    - 자바용 메이블(Maven for Java)
    - 자바용 프로젝트 관리자(Project manager for Java)
    - 비주얼 스튜디오 인텔리코드(Visual Studio IntelliCode)

4. aws cli 설치 및 세팅

계속 아래 에러가 나서 찾아보니 aws cli 설정이 추가로 필요했다.

현재 프로젝트에서는 소스 코드 내 민감정보를 외부 저장소에 저장하기 위해 AWS Parameter Store 사용하고 있다. 때문에 AWS Parameter Store를 통해 데이터를 읽기 위해서는 Credential을 세팅해줘야 했다.
AWS Configure(AWS CLI) 세팅은 Credential을 세팅하는 방법 중 하나로 맥북에서는 간단히 brew를 통해 설치할 수 있고, Access Key, Secret Key, region name 등을 입력하면 된다.

$ brew install awscli // aws cli 설치
$ which aws           // aws 위치 확인
$ aws --version       // aws 버전 확인
$ aws configure       // aws 구성 세팅 

AWS Access Key ID [None]: (Access Key 입력)
AWS Secret Access Key [None]: (Secret Key 입력)
Default region name [None]: ap-northeast-2 (서울 리전)
Default output format [None]: text / json / table

5. build & start

build & start 명령어는 각 프로젝트마다 다르게 적용될 수 있다.
아래 실행한 명령어는 application-local.yml 파일을 실행할 수 있게 세팅된 것이다.

  • build
    • gradlew : Gradle Wrapper로, 빌드 실행 스크립트
    • clean : 이전 빌드에서 생성된 모든 파일 삭제
    • -x test : 특정 작업(test) 제외
$ ./gradlew clean build -x test
  • start
    • bootRun : Spring Boot 애플리케이션 실행
    • --args : bootRun에 인수를 전달하는 옵션
    • '--spring.profiles.active=local' : application-local.yml 파일 사용
$ ./gradlew :프로젝트명:bootRun --args='--spring.profiles.active=local'

로컬 테스트 성공!! 🤩

profile
의미와 가치를 쫓는 개발자 ✨

0개의 댓글