리눅스(CentOS 7)에 젠킨스(Jenkins) 설치하기

---

[목차]
1. Java JDK 설치
2. 젠킨스 설치
3. 젠킨스 포트 변경
4. 방화벽에 포트 허용
5. 젠킨스 실행
6. 젠킨스 초기 설정

---

준비된 서버 OS는 CentOS 7.

참고로 젠킨스(Jenkins)는 Java로 제작된 오픈소스 CI(Continous Integration) 툴이다.

빌드 자동화, 서버 배포, 각종 배치 작업 등 젠킨스 파이프라인을 이용하여 많이 사용하는 편이다.

 

1. Java JDK 설치

우선 젠킨스를 실행하기 위해 Java JDK가 필요하다.

- yum 업데이트해주고.

참고로 yum은 Redhat 리눅스 계열의 패키지 관리 도구인 RPM의 패키지 의존성 문제를 해결한 버전.

sudo yum update -y

 

- 설치 가능한 자바 목록을 확인.

yum list java*jdk-devel

젠킨스 2.357 버전부터 자바 11 이상 버전을 요구하므로 11 버전으로 설치.

https://www.jenkins.io/blog/2022/06/28/require-java-11/

Jenkins requires Java 11 or newer

 

- x86_64은 64 bit

- i386 또는 i686이면 32 bit

참고로 'arch' 명령어로 리눅스 32bit, 64bit 확인 가능하다.

- 11 버전 설치

sudo yum install -y java-11-openjdk-devel.x86_64

- 제대로 설치됐는지 확인.

java -version

이제 JAVA_HOME 환경변수를 설정한다.

- 먼저 위치를 찾고,

which javac

- readlink -f 명령어로 경로를  구한다.

readlink -f /usr/bin/javac

- 이 경로 중 끝 부분의 /bin/javac를 제외하고 앞부분까지 복사하여 환경변수로 등록.

sudo vi /etc/profile

- 파일 제일 하단에 추가.

- source 명령어로 변경 사항 적용.

source /etc/profile

 

팁.

만약 1.8 버전도 설치하고 환경변수도 1.8로 설정되어 있다면, 11 버전 추가 설치 후 환경변수를 변경한다.(위에서 한 작업 참고) 모두 변경한 뒤 java -version 다시 확인.

sudo alternatives --config java

sudo alternatives --config javac

 

 

2. 젠킨스 설치

- 먼저 wget 설치

sudo yum install -y wget

- yum repository에 젠킨스 레드햇 안정화 버전을 추가

wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo

- rpm에 젠킨스 추가.

rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

- EXPL(Extra Packages for Enterprise Linux) - yum의 확장된 최신 저장소 설치

sudo yum install -y epel-release

 

- 젠킨스 설치

sudo yum install -y jenkins

- 설치 확인

rpm -qa | grep jenkins

 

 

3. 젠킨스 포트 변경

- spring 프로젝트를 동일한 서버에 배포할 예정이기 때문에 기본값인 8080이 중복되어 불편할 수 있으므로 젠킨스 포트를 8090으로 변경한다. 포트번호는 충돌 없는 원하는 걸로 변경 가능.

sudo vi /etc/sysconfig/jenkins

 

4. 방화벽에 포트 허용

- 방화벽에서 해당 포트 허용

sudo firewall-cmd --permanent --zone=public --add-port=8090/tcp

- 적용 확인

firewall-cmd --list-all

- 변경 사항 적용

sudo firewall-cmd --reload

 

 

 

5. 젠킨스 실행

sudo systemctl start jenkins

- 제대로 active 중인지 상태 체크

sudo systemctl status jenkins

실행 성공.

 

만약 아래처럼 안된다면 'journalctl -xe' 명령어로 어떤 문제인지 파악한다.

나의 경우 자바 1.8 버전이 설치되어 환경변수로 잡혀 있어서 최신 버전의 젠킨스 자바 요구조건에 맞지 않았던 탓.

때문에 11로 업데이트해 준 뒤 해결.

 

- 만약 8080 포트로 접속되고 바꾼 포트가 적용이 안된다면, 위에서 변경해준 설정파일보다 우선 적용되는 설정이 있는 경우다. 일단 8080으로 돌아가고 있는 젠킨스를 종료하고,

sudo systemctl stop jenkins

- 아래 파일 수정

sudo vi /usr/lib/systemd/system/jenkins.service

아래처럼 Environment="JENKINS_PORT=8080" 부분을 8090으로 변경.

- 리로드 후 재시작

sudo systemctl daemon-reload

sudo systemctl start jenkins

성공했다면 아래처럼 'ps -ef | grep jenkins' 명령어로 프로세스 확인 가능.

--httpPort=8090 부분 확인.

 

 

- 부팅 시 자동실행 추가

sudo systemctl enable jenkins

 

 

 

 

6. 젠킨스 초기 설정

- 브라우저를 통해 아래 url로 접속. '젠킨스서버IP' 부분은 자기 걸로 변경할 것.

http://젠킨스서버IP:8090

이렇게 나오면 성공.

 

- 아래 명령어로 초기 비밀번호 확인 후 입력하고 Continue 클릭

cat /var/lib/jenkins/secrets/initialAdminPassword

 

- 설치 유형 선택.(일단 여기선 기본형으로 진행)

- 각종 자동 설치가 끝난 뒤 admin user 생성

- 젠킨스 URL 설정 후 다음

초기 설정 끝.