우분투(Ubuntu) 환경에 패키지(Package)로 젠킨스(Jenkins) 설치하기

젠킨스(Jenkins)는 MIT license로 오픈소스(open source) 소프트웨어이며, 소프트웨어 개발 시 지속적 통합(CI, continuous integration) 서비스(service)를 제공하는 자동화 서버(server)입니다.

jenkins는 모든 프로젝트의 빌드(build)와 배포(deploy), 자동화를 지원하며, 수백 개의 플러그인(plugin)을 제공합니다.

이 포스트에서는 우분투(ubuntu) 환경에서 패키지(package)로 jenkins를 설치하는 방법을 소개합니다.

선행조건(PREREQUISITE)

  • ubuntu 환경에 Java가 설치되어 있어야 합니다.
    • jenkins 버전(version)에 따른 필요 Java version
      • 2.164 (2019-02) and newer: Java 8 or Java 11
      • 2.54 (2017-04) and newer: Java 8
      • 1.612 (2015-05) and newer: Java 7
  • 방화벽 설정이 필요합니다.
    • TCP 8080 포트가 개방되어 있어야 합니다.

Java 설치 방법은 우분투(Ubuntu) 환경에 OpenJDK(Java) 설치하기 포스트를 참고하시기 바랍니다.

jenkins version에 따른 Java version에 대한 자세한 정보는 https://jenkins.io/doc/administration/requirements/java/를 확인해 주시기 바랍니다.

방화벽 설정 방법은 우분투(Ubuntu) 환경에 방화벽(Firewalld) 설치 및 설정하기 포스트를 참고하시기 바랍니다.

테스트 환경(TEST ENVIRONMENT)

  • VMware® Workstation 15 Pro (15.5.1 build-15018445)
  • Ubuntu 16.04.4 LTS (Xenial Xerus) Server (64-bit)
  • jenkins 2.121.1
  • OpenJDK 1.8.0_171

요약(SUMMARY)

  1. jenkins debian packages repository 설정
  2. apt 명령어로 jenkins 설치
  3. (선택사항) Java 경로 설정 및 jenkins의 기본 포트 변경
  4. systemctl 명령어로 jenkins 실행
  5. 웹브라우저로 jenkins 접속

내용(CONTENTS)

1. jenkins debian packages repository key 추가

$ sudo wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -

2. jenkins debian packages repository 추가

$ sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

3. apt install 명령어로 jenkins 설치

$ sudo apt update && sudo apt install jenkins -y

4. (선택사항) Java 경로 설정

4.1. 설치된 Java 경로 확인

$ sudo which java
/usr/bin/java

4.2. Java 경로 추가

$ sudo vi /etc/init.d/jenkins

----------------------------------------
PATH="/bin:/usr/bin:/sbin:/usr/sbin:/usr/bin/java" 
----------------------------------------

5. (선택사항) 기본 포트 변경

$ sudo vi /etc/default/jenkins  

----------------------------------------
JENKINS_PORT="8080"  
JENKINS_AJP_PORT="9091"  
JENKINS_USER="root"  
----------------------------------------

6. systemctl 명령어로 jenkins service 관리

6.1. jenkins service 설정 반영

$ sudo systemctl daemon-reload

6.2. jenkins service 시작

$ sudo systemctl start jenkins.service

6.3. jenkins service 중지

$ sudo systemctl stop jenkins.service

6.4. jenkins service 재시작

$ sudo systemctl restart jenkins.service

6.5. jenkins service 설정 재적용

$ sudo systemctl reload jenkins.service

6.6. jenkins service 상태 조회

$ sudo systemctl status jenkins.service

6.7. jenkins service 활성화(부팅 시 자동 시작)

$ sudo systemctl enable jenkins.service

6.8. jenkins service 비활성화

$ sudo systemctl disable jenkins.service

6.9. jenkins service 및 관련 프로세스 모두 중지

$ sudo systemctl kill jenkins.service

7. 웹브라우저로 jenkins 접속

  • http://[MY-IP]:8080

마무리(CONCLUSION)

ubuntu 환경에 package로 jenkins 설치를 완료했습니다.

jenkins 초기 설정은 젠킨스(Jenkins) 초기 설정하기 포스트를 참고하시기 바랍니다.

다음 포스트에서는 우분투(Ubuntu) 환경에 WAR 파일로 젠킨스(Jenkins) 설치하기를 소개하겠습니다.

참고(REFERENCES)

Leave a comment

You may also enjoy