AWS EC2에서 Gradle을 활용한 배포 가이드

AWS EC2에서 애플리케이션을 배포할 때 Gradle을 활용하는 경우가 많습니다. 하지만 Gradle 버전이 맞지 않으면 빌드 오류가 발생할 수 있으므로 반드시 버전을 확인하고 설치해야 합니다. 이 글에서는 Gradle을 올바르게 설치하고, EC2에서 프로젝트를 배포하는 방법을 정리하겠습니다.

---

1. AWS EC2 인스턴스 설정

먼저 AWS EC2 인스턴스를 설정해야 합니다.

📌 EC2 인스턴스 생성

1. AWS 콘솔에서 EC2 서비스로 이동합니다.
2. "인스턴스 시작" 버튼을 클릭합니다.
3. 적절한 Amazon Machine Image (예: Ubuntu 22.04 또는 Amazon Linux 2)를 선택합니다.
4. 인스턴스 유형을 선택합니다. (예: t2.micro)
5. 키 페어를 생성 또는 기존 키를 선택합니다.
6. 보안 그룹을 설정하여 SSH(22번 포트)와 애플리케이션(예: 8080 포트)를 허용합니다.
7. 인스턴스를 생성하고, 퍼블릭 IP 주소를 확인합니다.

📌 SSH로 EC2 접속

생성된 인스턴스에 SSH로 접속합니다.

ssh -i your-key.pem ubuntu@your-ec2-ip

---

2. Gradle 설치 및 버전 관리

Gradle을 설치할 때는 애플리케이션에서 사용하는 버전과 맞춰야 합니다. 그렇지 않으면 org.gradle.api.tasks.TaskProvider 관련 오류 등이 발생할 수 있습니다.

📌 기존 Gradle 확인 및 삭제

기본적으로 Gradle이 설치되어 있는지 확인합니다.

gradle -v

만약 이전 버전(예: 4.10.2)이 설치되어 있다면 삭제합니다.

sudo rm -rf /usr/local/gradle-4.10.2

또는 환경 변수에서 제거해야 할 수도 있습니다.

echo $GRADLE_HOME
nano ~/.bashrc   # 또는 nano ~/.zshrc

위 파일에서 export GRADLE_HOME 관련 설정을 삭제한 후 적용합니다.

source ~/.bashrc

📌 Gradle 최신 버전 설치 (예: 8.13)

1. Gradle 다운로드

wget https://services.gradle.org/distributions/gradle-8.13-bin.zip

1. 압축 해제 및 이동

sudo mkdir /opt/gradle
sudo unzip -d /opt/gradle gradle-8.13-bin.zip

1. 환경 변수 설정

echo "export GRADLE_HOME=/opt/gradle/gradle-8.13" >> ~/.bashrc
echo "export PATH=\$GRADLE_HOME/bin:\$PATH" >> ~/.bashrc
source ~/.bashrc

1. 설치 확인

gradle -v

---

3. 애플리케이션 빌드 및 실행

Gradle이 정상적으로 설치되었으면 애플리케이션을 빌드하고 실행할 수 있습니다.

📌 프로젝트 Clone 및 빌드

git clone https://github.com/your-repo/your-project.git
cd your-project
./gradlew clean build

📌 실행하기

java -jar build/libs/your-app.jar

EC2에서 실행 중인 애플리케이션이 정상적으로 동작하는지 확인합니다.

curl http://localhost:8080

---

4. 애플리케이션을 백그라운드에서 실행하기

EC2에서는 SSH 세션이 종료되면 애플리케이션이 중단될 수 있으므로 nohup을 사용하여 백그라운드에서 실행합니다.

nohup java -jar build/libs/your-app.jar > app.log 2>&1 &

로그 확인:

tail -f app.log

---

5. 방화벽 설정 및 도메인 연결

EC2에서 외부에서 접근 가능하도록 포트를 열어야 합니다.

sudo ufw allow 8080

또한, AWS 보안 그룹에서 8080 포트를 인바운드 규칙에 추가해야 합니다.

도메인을 연결하려면 Route 53을 이용해 도메인을 설정하고, EC2의 퍼블릭 IP 또는 Elastic IP를 도메인과 연결하면 됩니다.

---

✅ 마무리

이제 AWS EC2에서 Gradle을 이용해 애플리케이션을 빌드하고 배포하는 방법을 배웠습니다. 중요한 점은 Gradle 버전을 반드시 맞춰야 하며, 환경 변수를 올바르게 설정해야 한다는 것입니다.

🚀 주요 체크리스트:

✔ EC2 인스턴스 생성 및 SSH 접속 ✔ Gradle 최신 버전 설치 및 환경 변수 설정 ✔ 애플리케이션 빌드 및 실행 ✔ 백그라운드 실행 및 보안 그룹 설정

이제 EC2에서 안정적으로 애플리케이션을 배포할 수 있습니다! 😊