게시판 구현(4) EC2이용해 배포하기

도롱뇽·2025년 5월 12일

안녕하세요. 이번에는 EC2를 이용해 Spring Boot로 만든 게시판을 실제 서버에 배포해보았습니다.

사실 지난번 배포 관련 스터디를 처음 했을 때(약 한 달 전), 스터디가 끝나고 집에서 혼자 계속 작업해 배포에 성공했었습니다. 하지만 당시 기록을 남기지 않아, 이번 글을 통해 과정을 다시 정리하며 복습해보고자 합니다.

이전까지는 로컬 환경에서만 게시판을 실행해보았지만, 다른 사용자도 게시글을 작성할 수 있도록 하기 위해 실제 서버에 배포하는 과정이 필요했습니다.

개발자들이 흔히 말하는 “배포는 삽질의 연속”이라는 말이 왜 나오는지 몸소 느끼게 되었습니다.

EC2에 배포한 전체 흐름

프로젝트 개발 및 빌드
게시판 기능 구현을 마친 후, 프로젝트를 .jar 파일로 빌드하였습니다.
```
./gradlew build
```
EC2 인스턴스 생성
AWS 콘솔에서 Ubuntu 20.04 기반 EC2 인스턴스를 생성하였습니다.
보안그룹 설정
인바운드 규칙에 22 (SSH), 8080 (서버 포트), 이후 80 (HTTP) 포트를 추가로 개방하였습니다.
SSH로 EC2 접속
.pem 키 파일을 사용하여 다음과 같은 순서로 접속을 진행하였습니다.
1. Git Bash 실행
2. Downloads 디렉토리로 이동
```
cd /c/Users/사용자명/Downloads
```
1. 권한 설정
```
chmod 400 ec2-key.pem
```
1. SSH 접속
```
ssh -i ec2-key.pem ubuntu@공인IP
```
접속 과정 중 Are you sure you want to continue connecting (yes/no/[fingerprint])? 메시지가 나타나며, yes를 입력해 신뢰를 설정하였습니다.

아래는 정상적으로 EC2에 접속한 화면입니다.
Java 설치
EC2에 Java를 설치하기 위해 다음 명령어를 실행하였습니다.
```
sudo apt update
sudo apt install openjdk-17-jdk
```
MariaDB 설치
데이터 저장을 위한 MariaDB를 설치하였습니다.
```
sudo apt install mariadb-server
```
이후 사용자 생성과 권한 부여를 통해 데이터베이스 설정을 완료하였습니다.
프로젝트 파일 복사
로컬에서 .jar 파일을 EC2로 복사하였습니다.
```
scp -i jaeung.pem board2.jar ubuntu@13.48.136.24:~/
```
복사된 파일은 ls 명령어로 정상 업로드 여부를 확인하였습니다.
환경 설정 파일 수정
application.yml 파일을 EC2 환경에 맞게 수정하였습니다.
프로그램 실행
업로드된 .jar 파일은 /app.jar로 저장되었고, 아래 명령어로 백그라운드 실행하였습니다.
```
java -jar /app.jar &
```
이번에는 nohup을 사용하지 않았지만, EC2가 중간에 종료되지 않아 현재까지 서버가 정상적으로 작동하고 있습니다.

※ 참고: EC2가 재시작될 경우에도 자동 실행되도록 하려면 nohup 또는 systemd를 사용하는 것이 좋습니다.
8080 포트로 접속 확인
브라우저에서 다음 주소로 접속하여 정상적으로 게시판이 동작함을 확인하였습니다.
```
http://13.48.136.24:8080/
```