[BE] IntelliJ Spring boot (WSL2) 프로젝트 설정

본 글에서는 윈도우 리눅스(WSL2) 환경에서 스프링 프로젝트를 생성하고 "HelloWorld"를 구동하는 과정을 살펴본다.

테스트 환경

Windows10 : 21H2 (19044.18889) WSL2
Ubuntu-20.04
Spring Boot 2.6.10
Java 11

1. 윈도우 리눅스 WSL2 설정 및 Ubuntu 설치

1.1. 윈도우 업데이트 : 실행 (Window 키 + R) ▶ winver 입력 ▶ 2004 이하 버전 업데이트
1.2. WSL1 설정 : PowerShell 관리자 모드 실행 ▶ 아래 명령 입력

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

1.3 재부팅 (재부팅 하지 않으면 linux eanble 되지 않아서 다음 진행이 되지 않음)
1.4 Ubuntu 설치 (https://aka.ms/wslstore)
1.5 WSL2 전환 : PowerShell 관리자 모드 실행 ▶ 아래 명령 입력

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

1.6 WSL 버전 확인 : PowerShell 관리자 모드 ▶ 아래 명령 입력

wsl -l -v

버전 확인 결과

1.7 WSL1 -> WSL2 전환 명령 수행 (1.6에서 Ubuntu 풀네임을 작성)

wsl --set-version Ubuntu-20.04 2

"가상 컴퓨터 플랫폼 windows 기능을 사용하도록 설정하고 BIOS에서 가상화가 사용하도록 설정되어 있는지 확인하세요"
메시지가 나오면 재부팅 후, BIOS설정에서 가상화 사용 설정 (보통은 기본 설정이 가상화 사용이라서 재부팅이면 충분)

"WSL 2에 커널 구성 요소 업데이트가 필요합니다"
메시지가 나오면 https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi  를 설치

"변환이 완료되었습니다"
메시지를 보고, wsl 버전이 2로 변경된 것을 확인하면 완료! 

탐색기에서 \\wsl$입력시 설치한 리눅스가 보이면 성공

1.8 추가 편의성 설정

wsl --set-default-version 2 //새로운 배포판을 WSL1 or WSL2에서 실행할지 지정
wsl --set-default Ubuntu-20.04 //기본 리눅스 배포판을 설정

Reference
https://docs.microsoft.com/ko-kr/windows/wsl/basic-commands

WSL의 기본 명령

2. Spring Boot 프로젝트 생성 및 IntelliJ 설정

2.1 WSL2 서버 패키지, 레포지토리 업데이트

sudo apt update
sudo apt -y upgrade

2.2 JDK 설치

//Install JDK & JRE
sudo apt install openjdk-11-jdk openjdk-11-jre -y
//Install JDK
sudo apt install openjdk-11-jdk //only jdk
//Install JRE
sudo apt install openjdk-11-jre //only jre

 

2.3 Spring 프로젝트 설정
https://start.spring.io/

2.4 프로젝트를 리눅스로 옮기고 IntelliJ로 열기

2.5 WSL 리눅스에 설치된 JDK 설정 (File ▶Settings)

리눅스 설치된 JDK를 선택해도 에러가 나는 경우에는 Add JDK를 클릭하고 리눅스에 JDK가 설치된 경우를 직접 선택

2.6 프로젝트 빌드 및 실행

chmod +x gradlew
./gradlew build

빌드 결과 확인

java -jar ./build/libs/p2e-0.0.1-SNAPSHOT.war

서버 실행!!