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

우분투 16.04에 Apache와 함께 Jenkins 자동화 서버 설치하는 방법

Jenkins는 Hudson 프로젝트에서 포크된 자동화 서버입니다. Jenkins는 Java 서블릿 컨테이너에서 실행되는 서버 기반 애플리케이션으로, Git, SVN 및 Mercurial을 포함한 많은 SCM(소스 제어 관리) 소프트웨어 시스템을 지원합니다. Jenkins는 프로젝트를 자동화하기 위한 수백 개의 플러그인을 제공합니다. Jenkins는 Kohsuke Kawaguchi에 의해 만들어졌으며, 2011년에 MIT 라이센스 하에 처음 출시되었으며, 무료 소프트웨어입니다.

이 튜토리얼에서는 우분투 서버 16.04에 최신 Jenkins 버전을 설치하는 방법을 보여드리겠습니다. 우리는 Jenkins를 자신의 도메인 이름에서 실행할 것이며, Apache 웹 서버 아래에서 Jenkins가 실행되도록 설치하고 구성할 것입니다.

전제 조건

  • 우분투 서버 16.04 - 64비트
  • 루트 권한

1단계 - Java OpenJDK 7 설치

Jenkins는 Java 기반이므로 서버에 Java OpenJDK 7 버전을 설치해야 합니다. 이 단계에서는 먼저 추가할 PPA 저장소에서 Java 7을 설치합니다.

기본적으로 우분투 16.04는 PPA 저장소를 관리하기 위한 python-software-properties 패키지가 포함되어 있지 않으므로, 먼저 이 패키지를 설치해야 합니다. apt 명령어로 python-software-properties를 설치합니다.

apt-get install python-software-properties

다음으로, 서버에 Java PPA 저장소를 추가합니다.

add-apt-repository ppa:openjdk-r/ppa  
Just Press ENTER

우분투 저장소를 업데이트하고 apt 명령어로 Java OpenJDK를 설치합니다.

apt-get update  
apt-get install openjdk-7-jdk

아래 명령어를 입력하여 설치를 확인합니다:

java -version

그러면 서버에 설치된 Java 버전을 확인할 수 있습니다.

우분투 16.04에 Java 7 openJDK 설치

2단계 - Jenkins 설치

Jenkins는 설치 패키지를 위한 우분투 저장소를 제공하며, 우리는 이 저장소에서 Jenkins를 설치할 것입니다.

아래 명령어로 Jenkins 키와 저장소를 시스템에 추가합니다.

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -  
echo 'deb https://pkg.jenkins.io/debian-stable binary/' | tee -a /etc/apt/sources.list

저장소를 업데이트하고 Jenkins를 설치합니다.

apt-get update  
apt-get install jenkins

설치가 완료되면, 이 systemctl 명령어로 Jenkins를 시작합니다.

systemctl start jenkins

기본적으로 Jenkins가 사용하는 포트(포트 8080)를 확인하여 Jenkins가 실행 중인지 확인합니다. 아래의 netstat 명령어로 확인하겠습니다:

netstat -plntu

Jenkins가 설치되어 포트 8080에서 실행되고 있습니다.

Jenkins가 포트 8080에 설치되었습니다

3단계 - Apache를 Jenkins의 리버스 프록시로 설치 및 구성

이 튜토리얼에서는 Apache 웹 서버 뒤에서 Jenkins를 실행할 것이며, Apache를 Jenkins의 리버스 프록시로 구성할 것입니다. 먼저 Apache를 설치하고 필요한 모듈을 활성화한 다음, Jenkins를 위한 도메인 이름 my.jenkins.id로 가상 호스트 파일을 생성하겠습니다. 여기서 자신의 도메인 이름을 사용하고 모든 구성 파일에서 나타나는 부분을 교체하십시오.

우분투 저장소에서 apache2 웹 서버를 설치합니다.

apt-get install apache2

설치가 완료되면, Jenkins의 프론트엔드 서버/리버스 프록시로 Apache를 구성할 수 있도록 프록시 및 proxy_http 모듈을 활성화합니다.

a2enmod proxy  
a2enmod proxy_http

다음으로, sites-available 디렉토리에 새 가상 호스트 파일을 생성합니다.

cd /etc/apache2/sites-available/  
vim jenkins.conf

아래의 가상 호스트 구성을 붙여넣습니다.

  
    ServerName        my.jenkins.id  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
   
      
      Order deny,allow  
      Allow from all  
      
   
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://my.jenkins.id/  

파일을 저장합니다. 그런 다음 a2ensite 명령어로 Jenkins 가상 호스트를 활성화합니다.

a2ensite jenkins

Apache와 Jenkins를 재시작합니다.

systemctl restart apache2  
systemctl restart jenkins

포트 80과 8000이 Jenkins와 Apache에 의해 사용되고 있는지 확인합니다.

netstat -plntu

Apache와 Jenkins가 실행 중인지 확인

4단계 - Jenkins 구성

Jenkins는 도메인 이름 ‘my.jenkins.id’에서 실행되고 있습니다. 웹 브라우저를 열고 URL을 입력합니다. 초기 관리자 비밀번호를 입력하라는 화면이 나타납니다. Jenkins에 의해 이미 생성된 비밀번호가 있으므로, 결과를 비밀번호 상자에 표시하고 복사하면 됩니다.

cat 명령어로 초기 관리자 비밀번호를 표시합니다.

cat /var/lib/jenkins/secrets/initialAdminPassword  
   
a1789d1561bf413c938122c599cf65c9

결과를 화면에 붙여넣고 ‘ 계속 ‘을 클릭합니다.

Jenkins 설치 및 구성

이제 나중에 사용할 수 있도록 Jenkins에 몇 가지 플러그인을 설치해야 합니다. ‘ 제안된 플러그인 설치 ‘를 선택하고 클릭합니다.

Jenkins 플러그인 설치

Jenkins 플러그인 설치 진행 중입니다.

Jenkins 플러그인 설치 중

플러그인 설치 후, 새 관리자 비밀번호를 생성해야 합니다. 관리자 사용자 이름, 비밀번호, 이메일 등을 입력하고 ‘ 저장 및 완료 ‘를 클릭합니다.

Jenkins 관리자 계정 생성

시작을 클릭하고 Jenkins를 사용하기 시작합니다. Jenkins 관리자 대시보드로 리디렉션됩니다.

관리 대시보드로 리디렉션

Jenkins 설치 및 구성이 성공적으로 완료되었습니다.

Jenkins 관리자 대시보드

5단계 - Jenkins 보안

Jenkins 관리자 대시보드에서 Jenkins의 표준 보안 설정을 구성해야 합니다. ‘ Jenkins 관리 ‘를 클릭한 다음 ‘ 전역 보안 구성 ‘을 클릭합니다.

Jenkins 전역 보안 설정

Jenkins는 ‘ 액세스 제어 ‘ 섹션에서 여러 인증 방법을 제공합니다. 모든 사용자 권한을 제어할 수 있도록 ‘ 행렬 기반 보안 ‘을 선택합니다. ‘ 사용자/그룹 ‘ 상자에서 관리자 사용자를 활성화하고 추가를 클릭합니다. 관리자에게 모든 권한을 부여하려면 모든 옵션을 체크하고, 익명 사용자에게는 읽기 권한만 부여합니다. 이제 ‘ 저장 ‘을 클릭합니다.

Jenkins 권한 구성

대시보드로 리디렉션되며, 로그인 옵션이 있으면 관리자 사용자와 비밀번호를 입력합니다.

6단계 - 간단한 자동화 작업 테스트

이 섹션에서는 Jenkins 서버에 대한 간단한 작업을 테스트하고 싶습니다. Jenkins를 테스트하기 위한 간단한 작업을 생성하고 top 명령어로 서버 부하를 확인하겠습니다.

Jenkins 관리자 대시보드에서 ‘ 새 작업 생성 ‘을 클릭합니다.

Jenkins에서 새 작업 생성

작업 이름을 입력합니다. 여기서는 ‘시스템 점검‘을 사용하고, ‘ 프리스타일 프로젝트 ‘를 선택한 후 ‘ 확인 ‘을 클릭합니다.

새 Jenkins 작업 구성

빌드 ‘ 탭으로 이동합니다. ‘ 빌드 단계 추가 ‘에서 ‘ 셸 실행 ‘ 옵션을 선택합니다.

아래 명령어를 상자에 입력합니다.

top -b -n 1 | head -n 5

저장 ‘을 클릭합니다.

Jenkins 작업 시작

이제 ‘프로젝트 시스템 점검‘ 작업 페이지에 있습니다. ‘ 지금 빌드 ‘를 클릭하여 ‘시스템 점검‘ 작업을 실행합니다.

작업이 실행된 후, ‘ 빌드 기록 ‘을 확인하고 첫 번째 작업을 클릭하여 결과를 확인합니다.

여기 Jenkins에 의해 실행된 작업의 결과가 있습니다.

Jenkins 작업 빌드 및 실행

우분투 16.04에서 Apache 웹 서버와 함께 Jenkins 설치가 성공적으로 완료되었습니다.

참고

Share: X/Twitter LinkedIn

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

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