SW/Gradle

Gradle: Gretty 플러그인 : 활용, 사용 방법, 예제, 개념, 설명

얇은생각 2025. 1. 22. 07:30
반응형

오늘은 Java로 웹 애플리케이션을 만들 때 자주 사용하는 Gretty 플러그인에 대해 이야기를 좀 해볼까 해요. 솔직히 저도 이 플러그인을 처음 사용했을 때 진짜 엄청난 시행착오를 겪었거든요. 그래서 여러분이 저처럼 헤매지 않도록, 최신 정보와 쉽게 따라할 수 있는 사용법을 공유해 드릴게요. 특히 Java의 WAR 파일을 Gretty 플러그인으로 패키징해서 서버에 배포하는 과정까지 다룰 예정이라 기대하셔도 좋아요. 그럼 시작해 볼까요?

 

Gradle: Gretty 플러그인 : 활용, 사용 방법, 예제, 개념, 설명

 

1. Gretty 플러그인 최신 버전 사용하기

먼저 가장 중요한 포인트 하나! Gretty 플러그인을 사용할 때는 꼭 4.0.3 이상의 버전을 사용하세요. 왜냐하면 예전 버전인 4.0.0을 쓰면 Gradle로 App.run을 실행할 때 여기저기서 문제들이 터질 수 있거든요. 저도 처음엔 그걸 모르고 4.0.0을 써서 오류 해결하느라 정말 몇 시간을 날린 적이 있어요. 시간 절약을 위해서라면 최신 버전을 쓰는 게 답이에요.

이렇게 작은 업데이트 하나가 큰 차이를 만들어낼 수 있다는 걸 경험하고 나니, 항상 최신 버전을 사용하는 게 얼마나 중요한지 절실히 깨달았어요.

 

2. 웹 애플리케이션 배포: Gretty 플러그인 활용하기

이제 본격적으로 우리가 만든 웹 애플리케이션을 배포해 볼 시간이에요. 이전 강의에서 만든 WAR 파일을 Tomcat 같은 웹 컨테이너에 수동으로 배포할 수도 있지만, Gretty 플러그인을 쓰면 훨씬 간단하게 해결할 수 있어요. 사실 저도 처음엔 손으로 직접 배포하는 걸 하다가 시간이 너무 많이 걸려서 불편했는데, Gretty를 쓰고 나서야 "아, 이게 진짜 꿀이구나" 싶더라고요.

우선 build.gradle 파일에서 플러그인 섹션을 열고 이렇게 추가해 주세요:

plugins {
    id 'arg.gretty' version '4.0.3'
}

 

이 Gretty 플러그인은 최신 Servlet API와 Jakarta 패키징 구조를 사용해요. 그래서 4.0.3 이상을 써야 하는 이유죠. 이 한 줄만 추가해 주면, Jetty 서버에서 바로 웹 애플리케이션을 실행할 수 있어요. 저도 처음 설정하고 나서, "이게 진짜 이렇게 간단해?" 싶어서 감탄했어요.

 

3. Gretty 플러그인으로 애플리케이션 실행하기

이제 Gretty 설정을 마쳤으니, 한 번 실행해 봐야겠죠? 명령어 하나만 치면 애플리케이션이 돌아가는 모습을 볼 수 있어요:

gradle appRun

이 명령어를 입력하면 Jetty 서버에서 기본적으로 애플리케이션이 구동되고, 콘솔에 관련 정보들이 나와요. 예를 들어 http://localhost:8080/first-web-app 같은 URL이 나오는데, 이걸 브라우저에 입력하면 우리가 만든 HTML과 JSP 페이지들이 제대로 돌아가는 걸 확인할 수 있어요.

저는 처음 이걸 보고 제 웹 애플리케이션이 브라우저에서 제대로 실행되는 걸 확인했을 때 진짜 감동했어요. 그 순간만큼은 "와, 이게 내가 만든 서비스가 돌아가는구나!" 하는 뿌듯함이 엄청났죠. 특히 버튼을 클릭하고 쿠폰 코드 입력 페이지로 넘어가서 할인을 받는 화면을 보니까 마치 제 아이디어가 진짜 생명력을 얻은 것 같은 느낌이 들었어요.

 

4. Tomcat에서 실행하기

Jetty도 정말 훌륭하지만, 때로는 Tomcat에서 애플리케이션을 실행해야 할 때도 있어요. 그럴 땐 다음과 같은 명령어를 써보세요:

gradle tomcatRun

이렇게 하면 이번에는 Apache Tomcat에서 애플리케이션이 실행됩니다. 같은 포트로 접근하면, 이제 Jetty 대신 Tomcat에서 애플리케이션이 돌아가는 걸 볼 수 있어요. 개인적으로 Jetty랑 Tomcat 둘 다 써보면서 각자의 차이를 경험하는 것도 참 재미있더라고요. Jetty는 뭔가 속도감 있고 가볍게 돌아가는 느낌이었고, Tomcat은 안정적이고 대규모 프로젝트에 잘 맞는 느낌이었어요. 이런 경험들이 개발자로서 성장하는 데 정말 큰 도움이 된다고 생각해요.

 

5. 포트 변경하기

기본적으로 Gretty 플러그인은 포트 8080을 사용해요. 그런데 가끔 이미 이 포트를 다른 애플리케이션이 사용하고 있으면 문제가 생기겠죠? 그럴 때는 포트를 간단하게 변경할 수 있어요. build.gradle 파일 끝부분에 다음과 같이 추가해 주세요:

gretty {
    httpPort = 8082
}

이렇게 설정한 후에 gradle tomcatRun이나 gradle appRun을 실행하면 애플리케이션이 포트 8082에서 실행됩니다. 저도 이전에 다른 앱이 8080 포트를 점유하고 있어서 계속 충돌이 나곤 했는데, 이렇게 포트를 변경하고 나니까 문제없이 잘 돌아가더라고요. 포트를 바꾸는 게 이렇게 간단하다니 진짜 다행이었어요.

 

6. Gretty 플러그인을 사용하면서 느낀 점

처음에 Gretty 플러그인을 사용할 땐 막막했던 게 사실이에요. 뭔가 설정도 많아 보이고, 어디서부터 시작해야 할지 모르겠더라고요. 하지만 막상 해보니까 의외로 간단했고, 한 번 설정해 놓으니까 그 뒤로는 애플리케이션을 실행하는 게 정말 편리했어요. 특히 Jetty나 Tomcat 같은 서버에서 테스트하는 과정이 이렇게 쉽게 가능하다는 게 정말 큰 장점이었죠.

물론 처음에는 시행착오도 많았지만, 그런 과정을 거치면서 얻는 배움이 컸어요. 그래서 여러분도 꼭 한 번 직접 해보셨으면 좋겠어요. 처음엔 약간 복잡하고 어려워 보일 수 있지만, 한 번 해내면 그 성취감이 엄청나요. 그리고 그 과정에서 정말 많은 것을 배우게 될 거예요.

 

7. 마무리

Java 웹 애플리케이션을 만들 때 Gretty 플러그인을 활용하는 건 정말 많은 도움이 돼요. 복잡한 설정 없이도 Jetty나 Tomcat 같은 서버에서 바로 애플리케이션을 실행할 수 있는 점이 가장 큰 매력인 것 같아요. Gradle로 빌드하고, 바로 실행해 보고, 문제가 생기면 그 자리에서 수정할 수 있으니까 개발 과정이 훨씬 수월하고, 오류도 금방 해결할 수 있었어요.

반응형