4-05. SBB 오픈 관련

• 서버 환경설정하기
  • hostname 변경하기
  • 서버 시간 설정하기
  • 자바 설치
  • 프로젝트 디렉터리 생성
• SBB 배포파일 생성하기
• SFTP로 SBB 배포파일 전송하기
• SBB 배포파일 실행하기
• SBB 확인하기

---

4-05. SBB 오픈

---

점프 투 스프링부트 - WikiDocs

---

여러분만의 AWS 서버를 생성하고 서버 작업을 할 수 있는 준비가 완료되었다. 이제 서버에 SBB를 설치하고 모든 사람이 사용할 수 있도록 만들어 보자.

다음과 같은 순서로 차근차근 진행해 보자.

1. 서버에 자바를 설치하고 환경설정을 한다.
2. 서버에 적용할 SBB 배포파일을 생성한다.
3. SFTP를 통해 SBB 배포파일을 전송한다.
4. SBB 배포파일을 실행한다.
5. 웹 브라우저로 SBB 서비스를 테스트한다.

---

서버 환경설정하기

먼저 터미널(mobaXterm)을 사용하여 서버에 접속하자.

그러면 다음과 같은 터미널 창이 나타난다.

앞으로 서버에 필요한 모든 작업은 여기서 진행된다고 생각하면 된다.

hostname 변경하기

서버에 접속하면 다음과 비슷한 프롬프트가 보인다.

ubuntu@ip-172-26-1-61:~$

위에서 노란색으로 마킹한 부분은 서버의 호스트명이다. 만약 위와 같은 아이피 기준의 호스트명 대신 의미있는 호스트명으로 바꾸고자 한다면 다음의 명령으로 호스트명을 바꿀수 있다.

호스트명을 jumpto로 바꾸는 예

sudo hostnamectl set-hostname jumpto

호스트명을 바꾼후에는 서버를 리스타트해야 적용된다.

ubuntu@ip-172-26-1-61:~$ sudo reboot

서버 리스타트 완료 후에 다시 접속하면 다음과 같이 변경된 프롬프트를 확인할수 있다.

ubuntu@jumpto:~$

hostname 명령을 수행하면 다음과 같이 변경된 호스트명이 출력된다.

ubuntu@jumpto:~$ hostname
#
# jumpto

서버 시간 설정하기

터미널에서 date 명령을 사용해 보자. 그러면 우리나라 시간이 아닌 UTC 시간이 출력된다.

date
#
# Mon Mar 21 03:32:36 UTC 2022

참고로 UTC 시간은 국제 표준 시간이므로, SBB 게시물의 등록 시간을 우리나라 시간으로 맞추려면 설정을 바꿔야 한다.

한국 시간으로 설정하기 위해 다음 명령을 수행하자.

sudo ln -sf /usr/share/zoneinfo/Asia/Seoul /etc/localtime

다시 date 명령을 수행하면 우리나라 시간으로 출력된다. 여러분의 시계와 비교하여 맞는지 확인해 보자.

date
#
# Mon Mar 21 12:33:30 KST 2022

자바 설치

스프링부트를 사용하려면 자바가 반드시 설치되어 있어야 한다. 서버에 자바가 설치되어 있는지 java 명령을 입력해 보자.

java
# 
# Command 'java' not found, but can be installed with:
# 
# sudo apt install default-jre              # version 2:1.11-72, or
# sudo apt install openjdk-11-jre-headless  # version 11.0.7+10-3ubuntu1
# sudo apt install openjdk-13-jre-headless  # version 13.0.3+3-1ubuntu2
# sudo apt install openjdk-14-jre-headless  # version 14.0.1+7-1ubuntu1
# sudo apt install openjdk-8-jre-headless   # version 8u252-b09-1ubuntu1

자바를 미리 설치하지 않았다면 아마도 위와 같이 자바가 설치되지 않았다는 메시지가 출력될 것이다.

자바를 설치하기 전에 다음과 같이 sudo apt update 명령을 수행하여 우분투 패키지를 최신으로 업그레이드하자.

sudo apt update
#
# Hit:1 http://ap-northeast-2.ec2.archive.ubuntu.com/ubuntu focal InRelease
# Get:2 http://ap-northeast-2.ec2.archive.ubuntu.com/ubuntu focal-updates InRelease [114 kB]
# Get:3 http://ap-northeast-2.ec2.archive.ubuntu.com/ubuntu focal-backports InRelease [108 kB]
# Get:4 http://ap-northeast-2.ec2.archive.ubuntu.com/ubuntu focal/universe amd64 Packages [8628 kB]
# Get:5 http://security.ubuntu.com/ubuntu focal-security InRelease [114 kB]
# (... 생략 ...)

이어서 다음과 같이 자바를 설치하자.

sudo apt install openjdk-17-jdk
# 
# Reading package lists... Done
# Building dependency tree
# Reading state information... Done
# (... 생략 ...)

설치가 완료되면 다음과 같이 java -version 실행해 보자.

java -version
#
# openjdk version "17.0.5" 2022-10-18
# OpenJDK Runtime Environment (build 17.0.5+8-Ubuntu-2ubuntu118.04)
# OpenJDK 64-Bit Server VM (build 17.0.5+8-Ubuntu-2ubuntu118.04, mixed mode, sharing)

자바 17버전이 정상적으로 설치된 것을 확인할 수 있다.

프로젝트 디렉터리 생성

그리고 홈 디렉터리(/home/ubuntu) 하위에 sbb라는 디렉터리를 생성하자.

mkdir sbb
ls
#
# sbb

위 터미널에서 보이는 프롬프트에서 '~'는 홈 디렉터리인 /home/ubuntu를 의미한다.

---

SBB 배포파일 생성하기

이제 서버에 적용할 SBB 배포파일을 만들어 보자. SBB 배포파일은 단 하나의 jar 파일이며 서버에서는 이 jar파일을 실행하여 SBB 서비스를 할 것이다.

STS에서 다음과 같이 따라해 보자.

메뉴에서 [Run -> Run Configurations]을 선택하자.

그러면 다음과 같은 화면이 나타난다.

"Gradle Task"를 선택하고 마우스 우측 버튼을 눌러 "New Configuration"을 선택하자.

그러면 다음과 같은 화면이 나타난다.

위 화면에서 다음 순서대로 입력하자.

1. Name을 "sbb"로 변경한다.
2. ["Workspace"] 버튼을 누른다.
3. "sbb" 프로젝트를 선택한다.
4. ["Add"] 버튼을 누른다.
5. 위에서 "Add" 버튼을 누르면 "task"라는 문자열이 입력되는데 이 "task" 문자열을 "bootJar"로 바꾼다. ("bootJar"는 명령어이기 때문에 다른 이름으로 하면 안되고 반드시 "bootJar"라는 이름으로 해야 한다.)
6. ["Apply"] 버튼을 누른다.

여기까지 진행하면 "Gradle Task"에 "sbb" 항목이 추가된다. 위 화면에서 이제 ["Run"] 버튼을 눌러 배포 파일을 작성해 보자.

그러면 STS 하단에 다음과 같이 "Gradle Executions" 창이 나타나고 진행결과가 표시될 것이다.

오류 없이 잘 실행되었다면 SBB 프로젝트 디렉터리의 하위에 build 디렉터리가 생기고 다음과 같은 파일이 생성된 것을 확인할 수 있을 것이다.

workspace/sbb/build/libs/sbb-0.0.1-SNAPSHOT.jar

이때 생성되는 sbb-0.0.1-SNAPSHOT.jar 파일이름은 build.gradle 파일의 version 항목이 결정한다.

파일명: /sbb/build.gradle

// (... 생략 ...)

group = 'com.mysite'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

// (... 생략 ...)

새로운 배포파일을 생성할 때마다 version 명을 달리하면 해당 version명의 배포파일이 생성될 것이다.

---

SFTP로 SBB 배포파일 전송하기

이제 생성한 sbb-0.0.1-SNAPSHOT.jar 파일을 파일질라를 통해 서버에 전송해 보자.

위 그림과 같이 sbb-0.0.1-SNAPSHOT.jar 파일을 서버의 /home/ubuntu/sbb 디렉터리로 드래그 앤 드롭으로 업로드 한다.

---

SBB 배포파일 실행하기

터미널 프로그램을 사용하여 다시 서버에 접속하자. 그리고 다음과 같이 입력하여 배포파일을 실행해 보자.

cd sbb
java -jar sbb-0.0.1-SNAPSHOT.jar
# 
#   .   ____          _            __ _ _
#  /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
# ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
#  \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
#   '  |____| .__|_| |_|_| |_\__, | / / / /
#  =========|_|==============|___/=/_/_/_/
#  :: Spring Boot ::                (v2.6.4)
# 
# 2022-03-21 03:55:28.598  INFO 17474 --- [           main] com.mysite.sbb.SbbApplication            : Starting SbbApplication using Java 11.0.14 on jumpto with PID 17474 (/home/ubuntu/sbb/sbb-0.0.1-SNAPSHOT.jar started by ubuntu in /home/ubuntu/sbb)
# (... 생략 ...)

먼저 cd sbb를 입력하여 sbb-0.0.1-SNAPSHOT.jar 파일이 있는 디렉터리로 이동한 후에 다음의 명령을 실행하여 SBB 서비스를 실행했다.

java -jar sbb-0.0.1-SNAPSHOT.jar

.sbb-0.0.1-SNAPSHOT.jar 파일을 실행하기 위해서는 위와 같이 java -jar jar파일명과 같이 실행한다.

---

SBB 확인하기

그리고 여러분의 컴퓨터에서 웹 브라우저를 실행하고 앞서 설정한 고정 IP에 포트 번호를 붙여(http://3.37.58.70:8080) 접속해 보자.

그러면 다음 화면을 볼 수 있다.

이제부터 누구나 웹 브라우저에서 http://3.37.58.70:8080을 입력하면 여러분의 SBB 서비스를 사용할 수 있다. 여러분이 만든 서비스가 세상에 공개되는 순간이다. 축하한다!

local.mv.db

로컬 컴퓨터에서 생성했던 데이터는 더 이상 보이지 않는다. 왜냐하면 서버에서도 H2 데이터베이스의 데이터 파일인 local.mv.db 파일이 새로 만들어지기 때문이다. 서버에도 다음과 같이 홈 디렉터리에 local.mv.db 파일이 생성된 것을 확인할 수 있다.

ls
# 
# local.mv.db  sbb