AWS EC2에서 Gradle 빌드 실패 및 인스턴스 연결 실패 문제 해결 과정

상황 개요

Java + Spring Boot 기반의 포트폴리오 프로젝트를 AWS EC2 인스턴스에서 실행하려고 했고, 다음과 같은 흐름으로 환경을 설정하였다. 

 

주요 목표

- GitHub에 있는 프로젝트 클론

- Java17 설치 및 Gradle 빌드

- EC2 인스턴스에서 프로젝트 실행 및 배포 테스트

 

EC2 환경 및 사양

 - 인스턴스 타입 : t2.micro

 - 플랫폼 : Amazon Linux 2023 (커널 6.1 기반)

 - 프로젝트 저장소 : https://github.com/MyYeonbi/spring-portfolio-trilingual.git

 

---

진행 단계 요약 및 발생한 이슈들

 

 

1. Git 설치 및 프로젝트 클론

yum install -y git
git clone https://github.com/MyYeonbi/spring-portfolio-trilingual.git

- 성공적으로 Git 설치 및 프로젝트 다운로드 완료.

 

 

 

2. Node.js 설치

yum install -y nodejs npm
node -v
npm -v

- 버전 확인 결과 Node.js 및 npm 모두 정상 설치.

 

 

 

3. Java 17 설치

yum install -y java-17-amazon-corretto
java -version

- Java17(Amazon Corretto)설치 및 버전 확인 성공.

 

 

 

4. Gradle 빌드 실행

cd spring-portfolio-trilingual
./gradlew clean build

 

 

 

* 에러 발생.

> Cannot find a Java installation on your machine (Linux ...) matching: {languageVersion=17, vendor=any vendor, implementation=vendor-specific}

- Gradle이 "Java Toolchain"을 사용하도록 설정되어 있는데, 적절한 toolchain 설정이 없어 인식 불가. 

- build.gradle 파일에 다음 코드가 있었기 때문 :

java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(17)
  }
}

- 조치 : 위 설정을 주석처리 하거나 삭제함으로써 Gradle이 로컬 Java17을 직접 사용하도록 유도함.

 

 

5. 빌드 재시도 (Gradle 캐시 삭제 포함)

./gradlew --no-daemon clean build --refresh-dependencies

 

결과 : 무한 대기

- Gradle이 "CONFIGURING"단계에서 10분 이상 멈춤

- 이유 : Gradle Daemon이 Toolchain 관련 자동 다운로드를 시도하며 무한 루프에 빠졌을 가능성. 

- 조치 : 강제 중지 시도하려 했으나, Mac에서 EC2 인스턴스 접속이 불가능해짐.

---

치명적 문제 발생 : EC2 SSH 접속 불가

 

현상 

- EC2 Instance Connect로 접속 시도 시 다음과 같은 에러 발생 :

Failed to connect to your instance
Error establishing SSH connection to your instance. Try again later.

 

 

원인

- Gradle 빌드 무한 대기로 인해 CPU 100% 사용 상태 지속 -> 인스턴스 내부 커널 동결

- 시스템이 강제 종료되며 비정상 상태로 진입

 이후 인스턴스를 수동 중지한 후 시작하려 했지만 실패 

The instance is not in a state from which it can be started.

 

조치 필요 :

1. EBS 볼륨 분리 후 새 인스턴스에 마운트하여 데이터 복구

2 또는 기존 인스턴스는 폐기하고 새로운 인스턴스에 git clone부터 다시 설정.

---

정리 : 지금까지 내가 해결한 것 vs 해결 못 한 것

 

해결된 것

항목	상태
Git 설치 및 프로젝트 clone	완료
Node.js + npm 설치	완료
Java 17 설치	완료
Gradle 실행 환경 구성	완료

                                                                                                              

 

해결되지 않은 것

항목	문제
Gradle 빌드	Toolchain 설정 문제로 인해 빌드 실패
Gradle 무한 대기	--refresh-dependencies 옵션 실행 시 CONFIGURING에서 멈춤
EC2 인스턴스	현재 SSH 접속 불가, 강제 중지 후 복구 실패

 

---

다음 단계

 

옵션 1: EBS 볼륨 분리 후 복구

1. EBC 콘솔 -> 중지된 인스턴스 -> 스토리지 탭에서 루트 볼륨 확인

2. EBS 콘솔로 이동 -> 해당 볼륨 선택 -> "볼륨 분리"

3. 새 인스턴스 생성

4. 새 인스턴스에 위 볼륨을 마운트하여 /mnt/recover에 연결

5. 기존 프로젝트 파일을 백업

 

 

옵션 2: 새 인스턴스에서 초기화

yum install -y git java-17-amazon-corretto
git clone https://github.com/MyYeonbi/spring-portfolio-trilingual.git
cd spring-portfolio-trilingual
./gradlew clean build

단, build.gradle에서 toolchain 관련 설정은 반드시 제거하거나 수정할 것.

---

느낀 점 및 교훈

- Gradle의 toolchain 기능은 강력하지만, 서버 환경에서는 자동 다운로드 설정이 없으면 문제를 일으킬 수 있다.

- EC2 인스턴스의 CPU를 고갈시키는 명령은 되도록 screen 또는 tmux를 통해 별도로 실행하고, 백그라운드 상태를 확인하면서 실행할 것. 

- ctrl + c 가 불가능한 상황에서 무한 루프에 빠질 수 있다는 점은 클라우드 환경에서도 치명적이다.

- EC2 인스턴스를 복구하려면 "스토리지 마운트 전략"을 반드리 익혀둬야겠다.

 

---

참고 자료

- Gradle Toolchains 공식 문서

- Amazon Linux 2023 Java 설치 가이드

- EC2 인스턴스 수동 복구 가이드

 

이렇게 나는 AWS EC2에서의 실습 환경 설정 중 발생한 Gradle 빌드 실패 -> 시스템 과부화 -> SSH 접속 불가 -> 인스턴스 복구 실패라는 흐름을 직접 겪으며 다음 단계를 위한 학습과 경험을 쌓을 수 있었다.

다음엔 더 안정적이고 견고한 배포 자동화 환경을 구성하는 것이 목표이다.