Gradle: Jenkins에서 프로젝트 빌드하기: 쉽고 재밌는 가이드, 방법, 예제

자, Jenkins랑 Gradle을 같이 써야 한다고요? 사실 처음에는 좀 헷갈릴 수도 있는데, 막상 해보면 정말 간단해요! Jenkins는 소프트웨어 개발 자동화에 정말 유용한 도구이고, Gradle은 Java 프로젝트 빌드할 때 많이 쓰이는 강력한 도구죠. 이 두 가지를 잘 연결하면, 매번 손으로 빌드할 필요 없이 Jenkins가 알아서 해주는 멋진 환경을 만들 수 있어요.

이 가이드에서는 Jenkins에서 Gradle 프로젝트를 빌드하는 방법을 아주 쉽게 설명할 거예요. DevOps 엔지니어든, Java 개발자든, 아니면 단순히 궁금해서 찾아오신 분이든, 누구나 이해할 수 있도록 만들어봤어요!

 

준비물 체크!

이걸 시작하기 전에 몇 가지 준비해야 할 게 있어요. 꼭 확인하세요!

• Jenkins (로컬에서 localhost:8080에서 실행 가능해야 함)
• Gradle (미리 설치되어 있어야 함)
• JDK (Java 개발 도구)
• Gradle을 사용해 만든 Java 프로젝트

 

Jenkins를 아직 설치 안 했다면, Jenkins 공식 웹사이트에서 다운로드하고 설치 방법을 참고하세요. 어렵지 않아요!

 

---

 

Gradle: Jenkins에서 프로젝트 빌드하기: 쉽고 재밌는 가이드, 방법, 예제

 

1단계: Jenkins에 접속하기

Jenkins가 잘 실행되고 있다면, 웹 브라우저를 열고 다음 주소로 들어가면 됩니다:

http://localhost:8080

 

처음 로그인하면 기본 계정 정보가 필요할 수도 있어요:

• 기본 사용자명: admin
• 기본 비밀번호: (Jenkins 설치 폴더에서 확인 가능!)

 

그리고 처음 접속하면 플러그인 설치하라고 할 텐데, 그냥 “기본 플러그인 설치” 버튼을 누르면 됩니다. 편하게 따라가세요!

 

---

 

2단계: Gradle 플러그인 설치

Gradle 프로젝트를 Jenkins에서 빌드하려면 Gradle 플러그인을 깔아야 해요.

1. Jenkins 대시보드에서 Manage Jenkins 클릭.
2. Manage Plugins 선택.
3. Available 탭에서 Gradle 검색.
4. 검색된 Gradle 플러그인을 선택하고 Install Without Restart 클릭.
5. 설치 후 Installed 탭에서 제대로 설치됐는지 확인!

 

설치가 끝나면 Jenkins를 한 번 재시작해 주세요. 그래야 제대로 적용됩니다!

 

---

 

3단계: Jenkins에서 Gradle 설정하기

이제 Gradle을 Jenkins에 연결할 차례예요.

1. Manage Jenkins → Global Tool Configuration 메뉴로 이동.
2. Gradle 섹션에서 Add Gradle 버튼 클릭.
3. Gradle의 이름을 적어주세요 (예: Gradle-7.5).
4. Gradle이 설치된 경로를 입력 (Windows나 Mac 환경에 따라 다름).
5. Save 버튼을 눌러 저장!

 

팁: Jenkins에서 자동으로 Gradle을 설치하는 옵션이 있긴 하지만, 특정 버전을 쓰는 게 더 안정적이라 직접 경로를 지정하는 걸 추천해요!

 

---

 

4단계: Jenkins에서 Gradle 빌드 작업 만들기

이제 본격적으로 Jenkins에서 빌드 작업을 만들어 볼까요?

새 작업 생성하기

1. Jenkins 대시보드에서 New Item 버튼 클릭.
2. 작업 이름을 입력 (예: Java-Webapp-Build).
3. Freestyle Project 선택 후 OK 버튼 클릭.

 

Jenkins 작업 설정하기

이제 다양한 설정을 해볼 거예요!

 

1. 프로젝트 설명 추가

프로젝트에 대한 설명을 간단히 적어주세요.

이 작업은 Gradle을 이용하여 Java 웹 애플리케이션을 빌드합니다.

 

2. 소스 코드 가져오기

GitHub에서 코드를 가져오려면:

1. Source Code Management에서 Git 선택.
2. Repository URL 입력.
3. 필요하면 인증 정보 추가.

 

로컬 프로젝트를 빌드하는 경우 이 부분은 생략해도 됩니다.

 

3. 자동 빌드 설정하기

자동으로 빌드를 실행하려면 Poll SCM 또는 Build Periodically 옵션을 활용하면 됩니다.

• Poll SCM: Git 저장소 변경 사항을 일정 간격으로 감지. (H/5 * * * * → 5분마다 체크)
• Build Periodically: 정해진 시간에 자동 빌드 실행.

 

4. Gradle 빌드 설정

• Build 섹션에서 Add Build Step → Invoke Gradle Script 선택.
• Gradle 버전 선택.
• Tasks 필드에 다음 입력:

gradle clean build

 

• Build File 경로 지정. 예를 들어, 프로젝트 경로가:

C:/Users/YourName/Projects/FirstWebApp/

 

이라면, 빌드 파일 경로는:

C:/Users/YourName/Projects/FirstWebApp/build.gradle

• Save 클릭!

 

---

5단계: Gradle 빌드 실행하기

이제 마지막 단계! 직접 빌드를 실행해 봅시다.

1. 생성한 작업 (Java-Webapp-Build) 클릭.
2. Build Now 버튼을 눌러 빌드 시작.
3. Console Output에서 진행 상황을 확인.

 

빌드가 성공하면 이렇게 뜰 거예요:

BUILD SUCCESSFUL