젠킨스가 무엇인지 알아보았으니 설치하는 과정도 진행해보겠습니다.
Windows 환경에서 설치해보겠습니다.
Windows 환경에서 젠킨스 설치
젠킨스 홈페이지 (https://www.jenkins.io/)에 접속합니다.
메인화면에 Download를 누릅니다.
젠킨스를 사용할 때 어떤 시스템에서 서비스를 실행할지 선택하는 화면입니다.
LocalSystem에서 실행할지, 윈도우의 특정 계정으로 실행할지 선택입니다.
젠킨스는 웹서비스 형태의 툴입니다. 젠킨스 웹페이지에 접속하기 위한 서버 포트를 결정합니다.
기본으로 8080으로 세팅되어 있습니다.
젠킨스에서 사용할 JAVA 1.8 또는 11버전에 해당하는 JDK, JRE의 경로를 설정합니다.
JDK - JAVA Development Kit, JRE - JAVA Runtime Environment
젠킨스는 JAVA에서 동작하는 웹서비스이기에 JDK 또는 JRE가 필요합니다.
쉽고 빠르게 OpenJDK를 설치하여 젠킨스 설치를 진행해보겠습니다.
https://jdk.java.net/archive/ 에 접속하여 Windows용 OpenJDK 11 버전을 zip를 받습니다.
적당한 경로에 압축을 푼 후 젠킨스 설치창에 넣고 설치를 계속 진행합니다.
젠킨스 설치가 완료되면 작업관리자 - 서비스탭에 Jenkins 가 실행 중 상태인 것을 확인합니다.
위와 같이 되어있다면 정상적으로 설치가 완료된 것입니다.
젠킨스 마스터(Jenkins Master) 설정
현재 설치한 것은 젠킨스 마스터입니다.
젠킨스 웹사이트를 보여주는 웹서버 역할을 하면서,
이후 세팅할 젠킨스 에이전트와 통신하여 작업 수행 명령을 내립니다.
localhost:8080에 접속합니다.
위 화면에 나온 경로로 가서 파일을 연 후 Administrator password를 입력합니다.
젠킨스에 설치할 플러그인을 선택합니다. 추천 플러그인 or 직접 선택해서 설치 중 선택입니다.
추천 플러그인을 모두 설치하도록 하겠습니다.
플러그인 설치가 완료되면 첫번째 관리자 계정을 생성합니다.
설정 완료 후 추가로 관리자 계정, 사용자 계정 등을 생성할 수 있습니다.
Jenkins 접속에 사용할 URL을 설정합니다.
개인 PC에서만 사용한다면 localhost 그대로 둡니다.
다른 PC에서 사용하며 다른 PC를 에이전트로 사용한다면 설치한 PC의 IP로 설정합니다.
젠킨스 마스터 설정이 완료되었습니다.
젠킨스 에이전트(Jenkins Agent) 설정
젠킨스 에이전트는 젠킨스 마스터로 부터 명령을 받아 수행하는 역할을 합니다.
메인 화면에서 Set up an agent를 선택합니다.
젠킨스 마스터에서 관리되는 에이전트를 노드라고 합니다.
노드명을 설정합니다. 여러 에이전트를 두게 된다면 관리가 편하도록 알아보기 쉬운 이름으로 설정합니다.
에이전트에서 원격 작업의 기준이 되는 경로를 설정합니다.
그 외에 옵션은 설정하지 않습니다.
WebSocket 옵션은 선택이지만 현재는 TCP로 마스터와 에이전트가 통신하도록 설정합니다.
생성한 노드를 선택하면 JNLP agent port가 꺼져있다고 합니다.
Go to security configuration screen and change it을 눌러 한가지 설정을 더 하겠습니다.
TCP port for inbound agents를 설정합니다.
Random을 누르거나 Fixed를 누른 후 TCP에서 사용할 포트를 설정합니다.
회사라면 주로 폐쇄망을 사용하기에 고정 포트를 허용하여 사용합니다.
젠킨스 마스터, 에이전트 통신에는 주로 50000번을 많이 사용한다고 합니다.
노드의 메인 화면에서 agent.jar을 눌러 해당 파일을 다운로드합니다.
그 후 적당한 위치에 저장합니다.
에이전트 작업 Root로 설정한 D:\Jenkins 경로에 저장하겠습니다.
Run from agent command line의 내용을 cmd창을 열러 실행하는 방법도 있지만,
좀 더 편하게 사용하기 위해 bat 파일을 생성하겠습니다.
java -jar D:\Jenkins\agent.jar -jnlpUrl http://localhost:8080/computer/Agent_01/jenkins-agent.jnlp
-secret da4857bb75ae0e4b29dda913c1055d9c276c4cfcf26de390b1a9d6ceababd054 -workDir "d:\jenkins"배치 파일 생성 후 Run from agent command line 내용을 입력하고
-jar 옵션에 agent.jar 파일의 위치를 넣어줍니다. bat랑 동일한 경로에 있다면 파일명만 써도 무관합니다.
OpenJDK 설치 후 환경변수를 등록하지 않았다면 Java 명령어는 동작하지 않을 것입니다. 아래 링크를 참고하여 설치합니다.
OpenJDK 설치 관련 링크 https://haenny.tistory.com/219
cmd 창 또는 bat 파일을 통해 에이전트 실행 명령어를 수행 후 INFO: Connected가 뜨면 설치 및 세팅 완료입니다.
젠킨스 웹상에 노드 페이지에도 연결된 상태로 표시됩니다.
마스터로부터 명령을 수행할 준비가 완료된 상태입니다.
젠킨스 설치 및 세팅을 진행해보았습니다.
다음은 젠킨스를 통하여 간단한 빌드를 수행해보겠습니다.
'Tools > Jenkins' 카테고리의 다른 글
| 젠킨스(Jenkins) 심플 튜토리얼 & 동작 구조 (0) | 2022.01.10 |
|---|---|
| 젠킨스(Jenkins) 소개 (0) | 2022.01.06 |
댓글