Jenkins 설치 · 3 min read · Dec 20, 2025

CentOS 7에서 Nginx와 함께 Jenkins 자동화 서버 설치하기

Jenkins는 무료이며 오픈 소스인 지속적 통합 서버입니다. JAVA로 작성되었습니다. 소프트웨어 개발과 관련된 다양한 작업을 자동화하는 데 사용할 수 있으며, 빌드, 테스트 및 배포와 같은 작업을 포함합니다. git, SVN, mercurial 등과 같은 많은 버전 관리 시스템을 지원합니다.

이 튜토리얼에서는 CentOS 7 서버에 Jenkins 자동화 서버를 설치합니다. 또한 Jenkins를 위한 리버스 프록시로 Nginx를 설정할 것입니다.

전제 조건

  • 최소한의 CentOS 7 서버
  • 루트 권한. 이 가이드는 루트 사용자로 작성되었으며, sudo 사용자로 로그인한 경우 sudo -i를 실행하십시오.

기본 시스템 업데이트

패키지를 설치하기 전에 다음 명령어를 사용하여 패키지와 저장소를 업데이트하는 것이 좋습니다.

yum -y update

시스템이 업데이트되면 JAVA 설치를 진행하십시오.

JAVA 8 설치

Jenkins는 OpenJDK와 Oracle JAVA를 모두 지원합니다. 이 튜토리얼에서는 서버에 OpenJDK의 최신 버전을 설치합니다. 다음 명령어를 실행하여 서버에 OpenJDK를 설치하십시오.

yum install java-1.8.0-openjdk

이제 다음 명령어를 사용하여 Java 버전을 확인할 수 있습니다.

java -version

다음과 같은 출력이 표시됩니다.

[root@liptan-pc ~]# java -version
openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-b12)
OpenJDK 64-Bit Server VM (build 25.131-b12, mixed mode)

JAVA_HOME 환경 변수가 설정되어 있는지 확인해야 합니다. 다음 명령어를 실행하십시오.

echo $JAVA_HOME

null 또는 빈 출력이 표시되면 JAVA_HOME 변수를 수동으로 설정해야 합니다. 좋아하는 편집기를 사용하여 .bash_profile 파일을 편집하십시오. 이 튜토리얼에서는 nano 편집기를 사용할 것입니다. 다음 명령어를 실행하여 nano를 사용하여 .bash_profile을 편집하십시오.

nano ~/.bash_profile

이제 파일의 끝에 다음 줄을 추가하십시오.

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/
export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/jre

이제 다음 명령어를 사용하여 파일을 소스하십시오.

source ~/.bash_profile

이제 환경 변수가 설정되었는지 확인하기 위해 echo $JAVA_HOME 명령어를 다시 실행할 수 있습니다.

[root@pc ~]# echo $JAVA_HOME 
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/

이제 JAVA가 설치되었으므로 Jenkins 설치를 진행할 수 있습니다.

Jenkins 설치

Jenkins는 리포지토리를 추가하고 GPG 키를 가져와서 직접 설치할 수 있습니다. 다음 명령어를 실행하여 Jenkins 리포지토리를 시스템에 추가하십시오.

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

wget이 설치되어 있지 않은 경우 yum -y install wget을 실행할 수 있습니다.

다음 명령어를 실행하여 GPG 키를 가져오십시오.

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

가져오기가 성공하면 다음 명령어를 실행하여 Jenkins를 설치할 수 있습니다.

yum -y install jenkins

이제 Jenkins가 서버에 설치되었습니다. 필요한 모든 패키지가 설치되었습니다. 설치 프로그램은 프로세스를 실행하기 위해 새로운 사용자 jenkins를 생성했습니다. 서버를 시작할 수 있습니다.

Jenkins 시작

다음 명령어를 실행하여 Jenkins를 시작할 수 있습니다.

systemctl start jenkins

Jenkins를 중지하려면 다음 명령어를 실행하십시오.

systemctl stop jenkins

다음 명령어를 실행하여 프로세스의 상태를 확인할 수 있습니다.

systemctl status jenkins

Nginx 설치

애플리케이션에 포트 8080으로 접근하는 대신 Apache 또는 Nginx 웹 서버로 애플리케이션의 리버스 프록시를 생성할 수 있습니다. 이 튜토리얼에서는 애플리케이션의 리버스 프록시로 Nginx를 사용할 것입니다. 이제 Nginx는 Nginx 프록시 서버 뒤에서 실행됩니다. Nginx는 기본 YUM 리포지토리에 없습니다. Nginx를 설치하려면 EPEL 리포지토리를 설치해야 합니다.

yum -y install epel-release

이제 다음 명령어를 실행하여 Nginx를 설치할 수 있습니다:

yum -y install nginx

다음 명령어를 실행하여 새로운 서버 블록을 생성하십시오.

nano /etc/nginx/conf.d/jenkins.conf

파일에 다음 내용을 추가하십시오. ci.yourdomain.com을 실제 도메인 이름으로 바꾸십시오.

upstream jenkins{
    server 127.0.0.1:8080;
}

server{
    listen      80;
    server_name ci.yourdomain.com;

    access_log  /var/log/nginx/jenkins.access.log;
    error_log   /var/log/nginx/jenkins.error.log;

    proxy_buffers 16 64k;
    proxy_buffer_size 128k;

    location / {
        proxy_pass  http://jenkins;
        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        proxy_redirect off;

        proxy_set_header    Host            $host;
        proxy_set_header    X-Real-IP       $remote_addr;
        proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto https;
    }
}

파일을 저장하고 편집기를 종료하십시오. 이제 다음 명령어를 실행하여 Nginx를 시작할 수 있습니다.

systemctl start nginx

다음 명령어를 실행하여 부팅 시 Nginx가 자동으로 시작되도록 설정하십시오.

systemctl enable nginx

방화벽 및 SELinux 구성

서버에서 방화벽이 실행 중인 경우 방화벽을 통해 포트 8080 및 표준 HTTP 포트를 허용해야 합니다. 다음 명령어를 실행하여 포트 8080 및 80을 허용하는 방화벽 규칙을 추가하십시오.

firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --zone=public --add-service=http --permanent

다음 명령어를 실행하여 방화벽 영역을 다시 로드하십시오:

firewall-cmd --reload

다음 명령어를 실행하여 Nginx 프록시 구성을 위해 SELinux를 구성하십시오.

setsebool httpd_can_network_connect 1 -P

Jenkins 구성

이제 다음 웹 주소로 Jenkins CI 서버의 웹 인터페이스에 접근할 수 있습니다.

http://ci.yourdomain.com

ci.yourdomain.com을 실제 도메인으로 바꾸십시오. 다음과 같은 인터페이스가 표시됩니다.

Jenkins 잠금 해제

초기 관리자 비밀번호를 입력하라는 메시지가 표시됩니다. 이 비밀번호는 설치 프로그램에 의해 생성되어 /var/lib/jenkins/secrets/initialAdminPassword 파일에 저장됩니다. 다음 명령어를 실행하여 초기 관리자 비밀번호를 얻으십시오.

cat /var/lib/jenkins/secrets/initialAdminPassword

비밀번호를 사용하여 로그인하고 진행하십시오.

다음 섹션에서는 설치할 플러그인을 선택하라는 메시지가 표시됩니다. 초보자에게는 추천 플러그인 설치를 선택하는 것이 좋습니다.

Jenkins 사용자 정의

이렇게 하면 시작하는 데 필요한 모든 플러그인이 설치됩니다.

다음 인터페이스에서는 플러그인이 설치됩니다.

Jenkins 시작하기

이제 Jenkins 관리 대시보드를 위한 관리자 사용자를 생성해야 합니다.

Jenkins에서 사용자 생성

마지막으로 Jenkins 관리 대시보드로 이동합니다.

Jenkins 대시보드

결론

이제 소프트웨어 개발에서 지속적 통합을 위해 Jenkins를 사용할 수 있습니다. Jenkins에 대해 더 알아보려면 Jenkins 웹사이트를 방문하십시오.

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.