[Spring Boot]Ubuntu20.04에 Jenkins설치 오류 해결

선행조건

• JDK-8 또는 JDK-11 설치

Step.

• Jenkins 설치
• Jenkins 설치 후 시작 오류 해결

1.Jenkins 설치

1. 루트 계정 접속

$ sudo su

2. 젠킨스 저장소(Repository) 키 다운로드

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

3. Key 저장 확인

$ apt-key list

4. 젠킨스 저장소를 source.list에 추가

$ echo deb http://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list

5. 추가(4번) 확인

$ vi /etc/apt/sources.list.d/jenkins.list

source.list.d/jenkins.list에 deb http://pkg.jenkins.io/debian-stable binary/ << 있으면 추가 된거다.

6. apt 업데이트 후 젠킨스 설치

$ apt-get update && apt-get install jenkins

2. Jenkins 설치 후 시작 오류 해결

설치 후 실행할 때 오류 로그 ↓

Job for jenkins.service failed because the control process exited with error code.
See "systemctl status jenkins.service" and "journalctl -xe" for details.

혹은

위 그림과 같이 오류가 발생 시 젠킨스 기본 포트(8080)와 충돌되는 서비스가 이미 동작하고 있을 수 있다. 필자의 경우 tomcat의 기본 포트(8080)과 충돌이 났기 때문에 tomcat 포트를 미리 변경 후 Jenkins를 설치하였다.

하지만 포트 충돌이 없음에도 위와 같은 에러가 뜨는 경우 Jenkins를 실행하는 JDK버전이 잘못 설정된 경우다.

1. Java --version 확인

Tomcat 구동을 위해 이미 JDK-17을 다운받으면서 자동으로 Ubuntu20 서버의 Default Java Version이 11에서 17로 변경되어 있었다.
Jenkins를 구동하기 위해서는 JDK-11버전이 구동되어야 하는데 디폴트 자바 버전이 17로 설정되어 있어서 오류 발생
(주의 : JDK를 설치하면 가장 최근에 설치한 JDK가 자동으로 Default 버전으로 설정된다.)

2. 오류 해결 : Default Java Version 변경 (to jdk8 or jdk11)

$ update-alternatives --config java

다음과 같이 Default Java 버전을 선택한다. 필자의 경우 1번 선택을 하였다.

jdk-11로 변경 확인.

Jenkins start(이미 구동 중이면 restart)를 하여 다음과 같이 아무것도 안뜨면 성공

Status 확인 후 실행 확인.