호스팅 서버에서 Spring boot 프로젝트 배포하기

개요

---

원격 호스팅 서버에서 Spring boot 프로젝트를 배포하는 과정을 정리해 보았다.

 

VS code에서 원격 접속이 필요하므로 REMOTE - SSH 확장 플러그인을 설치해야 한다.

---

프로젝트 빌드 파일 생성

---

먼저 로컬 환경에서 프로젝트 빌드를 해야 한다.

 

Spring boot 프로젝트의 경우 프로젝트 내에서 다음 명령어로 빌드를 실행한다.

gradle build

// 위 명령어 안될 경우
./gradlew build -x test

 

빌드에 성공할 경우 다음 메세지와 함께 프로젝트 내부에 jar 확장자의 빌드 파일이 생성된다.

빌드 성공

빌드 파일의 경로는 다음과 같다.

[프로젝트 루트]/[프로젝트 패키지명]/build/libs

빌드 파일

위와 같은 빌드 파일이 생성된다.

 

맨 위의 파일로 배포를 수행할 것이다.

---

원격 서버에 빌드 파일 옮기기

---

이제 서버에 빌드 파일을 옮겨야 한다.

 

서버에 원격 접속하는 방법은 여러가지가 있으며 본 글에서는 VScode의 REMOTE - SSH 확장 프로그램을 활용할 것이다.

 

먼저 원격 접속하는 서버의 정보를 입력한다.

 

로컬에서 다음 경로의 파일에 서버의 정보를 입력한다.

~/.ssh/config

 

작성 예시

 

위 사진과 같은 형태로 서버의 정보를 입력한다.

 

만약 ssh 포트가 22번이 아니라면 Port 속성을 추가하여 포트번호도 같이 입력한다.

 

그 후 VScode 검색창에 '>' 를 입력한 후 "REMOTE-SSH: 호스트에 연결"을 선택한다.

호스트에 연결을 선택한 후 입력한 서버의 정보로 접속 후 ssh 연결 과정을 수행한다.

 

이후 서버에 배포용 폴더를 생성한다.

 

웹 프로젝트의 경우 프론트와 백엔드의 빌드 파일이 모두 같은 폴더에 위치하는 것이 좋다.

 

폴더 생성 후 로컬에서 생성한 빌드 파일을 넣는다.

빌드 폴더 예시

---

서버 실행 및 배포

---

다음 명령어로 spring boot 빌드 파일을 백그라운드에서 실행한다.

nohup java -jar [빌드파일명] &

 

다음 명령어로 서버 실행 로그를 출력하여 서버가 실행중인지 확인한다.

tail -f nohup.out

실행 로그

서버가 실행되었다면 서버 포트가 열려있는지 확인한다.

 

위 과정을 통해 Spring boot 배포를 할 수 있다.