🚀 Ubuntu 서버에 프로젝트 배포

프로젝트 배포 과정

1. JDK 설치
2. Oracle DB 설치
3. JAR 파일 실행
4. 테스트

✅ JDK 설치

# 우분투 저장소 내 패키지 목록 갱신
sudo apt update

# JDK 설치
sudo apt install openjdk-17-jdk

# JDK 환경설정 등록
sudo vi /etc/environment
JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"

# 수정된 환경설정 반영
source /etc/environment

# 정상적으로 설치됐는지 확인
java -version

• 정상적으로 설치된 경우 Java 버전이 출력 된다.

✅ Oracle DB 설치

Oracle DB 설치 링크

• 우선 위 링크에 접속하여 파일을 다운로드 받는다.
• 다운로드 받은 파일을 압축 해제하면 DISK1 디렉터리 내에 rpm 파일이 있다.

해당 파일을 FileZila를 통해 애플리케이션 서버의 home/ubuntu 폴더에 전송해 준다.

# 우분투 저장소 내 패키지 갱신
sudo apt-get update

# deb 파일 변환 및 설치를 위한 패키지 설치
sudo apt-get install alien

# deb 파일 변환
sudo alien --scripts -d oracle-xe-11.2.0-1.0.x86_64.rpm

# 변환된 deb 파일 설치
sudo dpkg -i oracle-xe_11.2.0-1.0_amd64.deb

# 오라클 데이터베이스 환경설정 등록
sudo /etc/init.d/oracle-xe configure

• deb 파일 변환 시 화면에 아무것도 출력이 안되는데 중단하지 않고 계속 기다려야 한다.
• 설치가 완료되면 다음 사항들을 점검해야 한다.
  1. Listener TNS의 Metadata 설정 일치 여부
  2. DB 설정과 control_files 경로 일치 여부

select value from v$spparameter where name = 'control_files';

• 위 SQL문을 통해 DB 설정에 control_files 경로가 어떻게 되어 있는지 확인 할 수 있다.

  1. 환경설정
     • ~/.bashrc(기본 환경설정), ~/.bash_profile(사용자별 환경설정)을 설정해야 한다.
     • 사용자별 환경설정은 서버를 재부팅 할 때마다 source ~/.bash_profile 명령어를 통해 환경설정을 적용해야 한다.
  2. DB 접속 가능 여부
     • sqlplus / as sysdba 명령어를 통해 sysdba 계정으로 DB에 접근이 가능한지 확인해야 한다.
  3. Listener 실행 여부
     • lsnrctl start를 통해 Listener를 가동해야 한다.
     • Listener 관련 조작을 할 때 다음 명령어들을 활용 할 수 있다.

#리스너 가동
rsnlctl start

#리스너 중지
rsnlctl stop

#리스너 상태 확인
rsnlctl status

#리스너 서비스 확인
rsnlctl services

• $ORACLE_HOME/network/admin 경로의 Listener.ora 파일이나 Tnsname.ora 파일을 수정 및 적용하려면 Listener를 중지하고 가동하는 작업이 필요하다. 

✅ JAR 파일 실행

# java -DENV='jdbc:oracle:thin:@localhost:1521:xe' -jar jar_파일명 --server.port=8081
java -D환경설정_키_값='환경설정_값' -jar jar_파일명 --server.port=포트번호

• Spring Boot를 빌드하면 application.yml 환경설정 값이 적용되는데, DB URL을 localhost로 설정할 경우 빌드한 PC의 IP 값이 들어가게 된다.
• 그러나 빌드한 PC의 IP가 아니라, JAR 파일을 실행하는 시점의 애플리케이션 서버의 IP를 주입해야 하므로 URL 관련 설정은 JAR 파일을 실행하는 시점에 주입해주어야 한다.

테스트

• Postman을 통해 요청 및 응답이 정상적으로 오고 가는지 확인하면 된다.

회고

• 이전에 AWS EC2에 프로젝트 배포를 해본 적이 있어서 금방 할 줄 알았다. 
• Oracle DB를 설치하는 과정이 신경 쓸 것도 많아서 힘들었다.
• 지금 생각해보면 Docker를 도입하면 이렇게 Resource 설치 과정에 겪는 어려움은 신경 쓸 필요가 없다.
• 그런데 이런 불편함을 겪어보지 않고 Docker를 통해 쉽게 진행해버렸다면, 이런 배움도 없었을 것 같다.