📌 Spring Boot EC2 배포 이후 실습 (MySQL 이후 단계)

📅 2025-05-28

📝 학습 내용

✅ EC2 서버에서 Spring Boot 프로젝트 실행

1. EC2 인스턴스에 접속한 뒤 /app 디렉토리 생성 및 이동

mkdir /app
cd /app

1. GitHub에서 프로젝트 클론

git clone <https://github.com/your-repo/your-springboot-app.git>
cd your-springboot-app

1. 실행 권한 부여 후 빌드

chmod o+x gradlew
./gradlew build

1. 실행 파일 경로 이동 및 실행

cd build/libs
ls -l
java -jar demo-0.0.1-SNAPSHOT.jar &

✅ & 붙이면 백그라운드에서 실행됨

---

🧩 트러블슈팅: JDK Toolchain 에러

❗ 오류 메시지

Cannot find a Java installation on your machine matching: {languageVersion=21 ...}
Toolchain download repositories have not been configured.

✅ 해결 방법

방법 1: EC2에 JDK 21 직접 설치

sudo yum install -y java-21-amazon-corretto

• 환경 변수 등록

export JAVA_HOME=/usr/lib/jvm/java-21-amazon-corretto
export PATH=$JAVA_HOME/bin:$PATH
source /etc/profile

방법 2: Gradle 설정 파일 수정 (settings.gradle)

pluginManagement {
  plugins {
    id 'org.gradle.toolchains.foojay-resolver-convention' version '0.8.0'
  }
}

• 수정 후 GitHub에 커밋 & 푸시
• EC2에서 다시 git pull, ./gradlew build

---

🌐 배포 확인

• 다시 EC2 에서 실행

  cd build/libs
  ls -l
  java -jar demo-0.0.1-SNAPSHOT.jar &
  

• 브라우저 주소창에 EC2 탄력적 IP 입력

  http://[EC2-IP]:8080
  

• 페이지에 다음과 같이 출력되면 정상 동작:

  Hello World!
  

---

⚠️ AWS 인스턴스 종료 주의

✅ 반드시 중지(Stop)해야 함
❌ 종료(Terminate)하면 인스턴스 및 EBS 디스크 완전 삭제됨

인스턴스 중지 방법:

1. EC2 대시보드 > 실행 중인 인스턴스 클릭
2. 인스턴스 상태 > 인스턴스 중지 선택

---

🔗 참고 자료

• Gradle Toolchains 공식 문서
• Amazon Corretto 설치 가이드
• AWS EC2 인스턴스 라이프사이클

😎 느낀 점

• EC2 서버 위에 직접 애플리케이션을 배포하고 브라우저로 결과를 확인하는 과정이 인상 깊었다.
• 작은 설정 하나가 전체 빌드에 영향을 줄 수 있다는 걸 실감했다.
• JDK 버전, 실행 권한, 인스턴스 종료 방식 등 세심한 관리가 중요하다는 것을 배웠다.

🧾 요약

• EC2에 Spring Boot 프로젝트 클론 → 빌드 → 실행
• gradlew에 실행 권한 부여 필요
• java -jar ... &로 백그라운드 실행
• 푸티 환경에서는 JDK와 환경 변수 설정 중요
• 인스턴스는 중지만 해야 데이터 보존됨

---