[Jenkins] 파이프라인 빌드 오류 해결: Gradle 설정 문제

Jenkins 파이프라인 빌드 시 아래와 같은 에러가 발생했습니다.

org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed:
WorkflowScript: 4: Tool type "gradle" does not have an install of "Gradle" configured - did you mean "gradle"? @ line 4, column 16.
           gradle 'Gradle'

해당 오류는 Jenkins 파이프라인에서 gradle 명령어를 사용할 때 발생하는 것으로 Jenkins에서 gradle을 찾지 못하고 있다는 의미입니다.

 

해결 방법

1. Gradle 설치 확인 및 구성
   • Jenkins에서 관리 > Global Tool Configuration(글로벌 도구 구성)으로 이동합니다.
   • Gradle 섹션으로 가서 설치된 Gradle 버전이 설정되어 있는지 확인합니다.
   • 설치되어 있지 않다면 Add Gradle(Gradle 추가)를 클릭하고, Gradle 버전을 추가하거나 Jenkins가 자동으로 다운로드하도록 설정합니다.
2. 파이프라인 스크립트에서 올바른 Gradle 버전 사용
   • 위에서 설정한 Gradle 이름을 파이프라인 스크립트에 맞게 지정해야 합니다. 예를 들어, gradle 'Gradle' 대신 올바른 이름으로 변경해보세요.

 

저는 Jenkinsfile은 아래와 같이 gradle을 Gradle이라는 이름으로 등록된 버전을 사용하도록 설정하고

pipeline {
    agent any
    tools {
        gradle 'Gradle'
    }

Jenkins에서 gradle name을 gradle로 설정해서 Jenkins에서 설정한 gradle name(Gradle)과 Jenkinsfile에서 설정한 gradle 이름(gradle)이 일치하지 않아서 발생한 에러였고 이름을 일치시키니 오류가 해결되었습니다.