개발 독서 스터디/젠킨스로 배우는 CIㆍCD 파이프라인 구축

젠킨스 CI/CD - 전역 도구 구성의 이해

seoyyyy 2025. 5. 25. 21:30

 전역 도구 구성 페이지에서 JDK와 메이븐을 구성하는 방법을 알아보자

 

✔️전역 도구 구성 설정

Global Tool Configuration 페이지로 이동한다. 만약 메뉴가 한국어로 구성이 되어있을 시  Dashboard > Jenkins 관리 > Tools 을 선택하면 된다. 

 

그러면 아래와 같은 화면으로 이동된다. 

 

만일 그래들(gradle) 또는 깃과 같이 다른 도구들의 플러그인이 설치되어있다면 위 화면에 보이는 Git installations 와 같이 해당 도구와 관련된 설정이 나타난다.

🏀 Maven 구성 

 

다음은 메이븐 빌드 도구와 관련된 설정을 살펴보자.

💡 메이븐(Maven)
: 컴파일, 패키징 배포와 같은 자바 애플리케이션의 빌드 단계를 자동화 하는데 사용되며, 다른 플러그인들의 지원을 받아 작업을 수행하는 명령행 인터페이스 빌드 도구이다.

 

메이븐 설정에는 다음 2개의 구성파일이 사용되며 이 파일에는 메이븐으로 자바 프로젝트를 빌드하는 데 필요한 설정이 들어있다.

 

 

▶️ 메이븐 설치 파일(전역설정) 

   - 파일 기본 위치: ${maven.home}\conf

   - 파일명: settings.xml

   - 동일한 시스템에서 작업하는 모든 사용자에게 적용되는 공통 메이븐 설정

 

▶️ 사용자 설치 파일(사용설정) : 

   - 파일 기본 위치: ${user.hmle}\.m2

   - 파일명: settings.xml 

   - 특정 사용자별 메이븐 설정

   - 사용자 설치에서는 settings.xml이 없어도 되며, 없을 경우 메이븐 설치의 settings.xml 파일에서 필요한 설정을 가져온다.

 

 

참고로 maven.home은 메이븐 설치 경로이고 user.home은 현재 사용자 경로이다.

메이븐 설치, 사용자 설치 두개의 settings.xml 파일에서 동일한 설정이 있는 경우 사용자 설치의 설정 값이 우선 적용된다. 

 

젠킨스에서 메이븐을 구성하는 동안에 젠킨스는 사용자 및 전역 settings.xml 파일의 위치를 알아야 하는데 이들 파일이 위에서 설명한 기본 위치에 있다면 Default settings provider(기본 설정 공급자)는 Use default maven settings(기본 메이븐 설정 사용) 값으로, Default global settings provider(기본 전역 설정 공급자)는 Use default maven global settings(기본 메이븐 전역 설정 사용) 값으로 유지하면 된다.

 

하지만 만약 설정파일이 다른위치에 있다면 Default settings provider(기본 설정 공급자) 값을 Settings file in filesystem(파일 시스템 내의 설정 파일)을 선택하고 해당 파일 위치를 직접 지정해주어야 한다. 아래 Default global settings provider(기본 전역 설정 공급자) 를 설정할 때도 마찬가지다.

 

 

 

다음으로 아래에 Maven 섹션이 존재하는데 여기서는 Maven installations(메이븐 설치)를 구성할 수 있다. 

화면에 보이는 Add Maven(메이븐 추가) 버튼을 클릭하면 메이븐 설치 섹션이 확장된다.

 

Name(이름) 필드에는 메이븐 구성 이름을 입력한다.

 

주의해야할 점은 젠킨스 파이프라인에서 이곳에 입력한 이름을 직접 사용하기 때문에 이름은 영문으로 해주고, 숫자, 공백, 특수문자는 사용하지 않도록 해야한다. 

 

만약 젠킨스 작업을 운영중인 시스템에 이미 메이븐이 설치되어 있다면 install automatically(자동설치) 옵션을 체크해제 하고 MAVEN_HOME을 입력한다. 설치되어있지 않다면 install automatically(자동설치) 를 그대로 체크해주고 설치 환경을 구성해주도록 한다.

 

그 후 Save 버튼을 눌러 구성을 저장한다. 

젠킨스는 메이븐이 설치되지 않은 시스템에서 처음 작업을 실행할 때만 설치작업을 수행한다. 

 

.ZIP/.TAR 파일을 추출해서 메이븐을 설치하는 방법은 다음과 같다.

Add Installer(인스톨러 추가) 버튼을 클릭하고, Extract *.zip/*.tart.gz 항목을 선택한다.

그러고 Download URL for binary archive(다운로드할 바이너리 파일 주소) 필드에 메이븐 웹사이트의 메이븐 파일 주소를 입력한다. 예를들어 다음과 같이 입력하면 된다.

https://archive.apache.org/dist/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.zip

 

Subdirectory of extracted archive(추출 파일의 하위 디렉터리)에는 다운로드 파일의 압축 해제 폴더 내에 메이븐 설치 디렉터리 이름을 입력한다.

그러면 젠킨스가 메이븐 설치를 진행할 때 바이너리 파일을 다운로드 한 후 압축을 풀어 아래와 같은 디렉터리 구조를 갖는 메이븐 빌드 도구를 설치한다.

 

🩰 Java 구성

 

이번엔 자바를 구성하기 위해 Add JDK(JDK 추가) 버튼을 클릭해본다.

만약 시스템에 이미 자바가 설치되어있다면 Install automatically 체크를 해제하고 Name 필드에 적절한 이름을 입력한 후 JAVA_HOME 필드에 자바가 설치된 디렉터리 절대경로를 입력한다.

 

만약 JDK가 설치되어있지 않다면  Install automatically를 체크한 후 메이븐 구성 섹션에서 한 것과 같이 동일하게 진행한다.