젠킨스 CI/CD - 젠킨스 설치

 하드웨어 요구사항

- 256MB 메모리 용량
- 1 GB 이상의 하드디스크 용량 (도커 컨테이너로 실행하는 경우엔 10GB 이상을 추천)

 

소프트웨어 요구사항

- 자바: 젠킨스 버전에 따라서 지원하는 버전이 다르다. 

         : 젠킨스 버전 2.357과 LTS 버전 2.361 1과 이후버전은 JDK11 또는 JDK 17이 필요

         : 젠킨스 버전 2.164.1 및 LTS 2.236.1 이하 버전은 JDK8과 JDK11을 지원

         : 이하 오래된 버전의 자바는 지원하지 않음

- 젠킨스 버전 확인: https://get.jenkins.io/war-stable  참고

 

젠킨스 설치방법

 https://www.jenkins.io/download/ 경로로 가면 여러 유형으로 젠킨스를 설치할 수 있다.

 

✔️ MSI 인스톨러로 설치

   https://www.jenkins.io/download/thank-you-downloading-windows-installer-stable/

 

✔️ .war 파일로 설치

    https://get.jenkins.io/war-stable/2.504.1/jenkins.war

 

✔️ 도커 이미지로 설치

    https://hub.docker.com/r/jenkins/jenkins

 

위의 다양한 설치방법이 있지만 실습을 위해 MSI 인스톨러로 설치를 해볼 것이다.

 

1) Jenkins.msi 파일을 더블클릭하면 설치마법사가 나타나며 Next를 선택한다.

2) 젠킨스 설치파일을 저장할 경로를 선택한 후 Next. 별도로 지정하지 않으면 기본 경로로 설치된다.

 

3) 계정을 설정하는 단계. 나중에도 설정 가능하니 따로 지정하지 않고 Next를 선택 한다.

 

4) 접속 포트 설정 기본 8080으로 되어있는데 다른 서비스에서 8080 포트를 사용할 가능성이 높으므로 다른 포트번호로 지정한 후 Test Port 버튼 클릭

테스트 성공 시 Next 선택하여 다음으로 넘어간다. 

 

5) JDK 연동. 자바가 설치되어있는 경로로 연결해준다. 

 

 

6) 세부 설치 옵션인데 별다른 설정을 하지 않고 Next 를 선택하여 다음으로 넘어간다.

 

7) Install 버튼을 클릭해 설치를 진행한다.  

8) 진행중

9) 완료

---

 

💡젠킨스의 구성 파일 및 디렉터리 구조 이해

 

젠킨스는 기본적으로 .jenkins 폴더 내 $user.home 디렉터리(현재 사용자 디렉터리 )에 설치된다. 

MSI 인스톨러로 젠킨스를 설치한 경우에는 사용자가 선택한 디렉터리에 설치된다.

 

실습을 위해 좀전에 MSI로 설치를 했었는데 설치 경로로 설정 했었던 디렉터리로 이동하여 확인해보니 파일이 몇개 없다.

 

당황해서 Jenkins.xml 파일을 열어 보니 JENKINS_HOME을 통해 실제 설치된 경로를 알 수 있었다.

 

value 에 경로로 작성되어있는 %ProgramData% 는 커맨드 창에서 찾아보니 C:\ProgramData 폴더였다.

 

JENKINS_HOME 디렉터리 구조

JENKINS_HOME
+- config.xml                        (젠킨스 루트 구성 파일)
+- *.xml                                (기타 사이트 전체 대상 구성 파일)
+- userContent                    (이 디렉터리 파일은 http://server/userContent/ 경로에서 제공)
+- fingerprints                      (핑거프린트 기록 저장)
+- nodes                              (에이전트 구성 파일)
+- plugins                            (플러그인 저장)
+- secrets                            (크리덴셜을 다른 서버로 이전할 때 필요한 시크릿)
+- workspace                      (버전 관리 시스템용 작업 디렉터리)
      +- [JOBNAME]              (작업별 서브 디렉터리)
+- jobs
      +- [JOBNAME]              (작업별 서브 디렉터리)
            +- config.xml           (job 구성 파일)
            +- latest                   (최종 성공 빌드에 대한 심볼릭 링크)
            +- builds
                  +- [BUILD_ID]            (빌드별로 생성되는 디렉터리)
                        +- build.xml           (빌드 결과 요약)
                        +- log                     (로그 파일)
                        +- changelog.xml  (변경 로그)

 

위 디렉터리 구조는 책에서 소개하는 JAVA_HOME 으로 설정된 디렉터리의 구조이다.

 

하지만 실습하며 확인한 디렉터리 구조에는 위에서 소개한 구조에 비해 fingerPrints, nodes, workspace 등의 일부 디렉터리가 보이지 않는다.

 

아직 초기 설치만 성공한 상황이라 그런 것 같고 이후 이런저런 구성이 끝나면 다른 폴더들도 생성 되어있을 것 같다.

 

---

jenkins.xml 주요 설정값 이해

방금 jenkins 설치 디렉터리 위치를 찾았을 때 jenkins.xml 파일을 열어서 확인을 했는데 이 파일에서 JENKINS_HOME 외에도  자바 관련 설정 정보도 알 수 있다. 

자바 버전을 변경하고 싶으면 아래의 <executable> 태그의 경로를 원하는 자바 설치 디렉터리의 java.exe 파일의 경로로 변경해주면 된다.