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

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

이 튜토리얼에서는 우분투 서버 18.04 LTS(Bionic Beaver)에 최신 안정적인 Jenkins 버전을 설치하는 방법을 보여드리겠습니다. 우리는 Jenkins를 자신의 도메인 이름에서 실행하고, Apache 웹 서버 리버스 프록시 아래에서 Jenkins를 실행하도록 설치하고 구성할 것입니다.

전제 조건

• 우분투 18.04
• 루트 권한

우리가 할 일

1. Java 설치
2. Jenkins 설치
3. Jenkins를 위한 Apache2 리버스 프록시 설치 및 구성
4. UFW 방화벽 구성
5. Jenkins 구성
6. Jenkins 보안
7. 테스트

1단계 - Java 설치

Jenkins는 Java 기반 애플리케이션이므로 서버에 Java OpenJDK를 설치해야 합니다. 이 단계에서는 먼저 추가할 PPA 리포지토리에서 Java 8을 설치합니다.

소프트웨어 속성 공통 패키지를 설치한 후, Java OpenJDK PPA 리포지토리를 추가합니다.

sudo apt install software-properties-common apt-transport-https -y  
sudo add-apt-repository ppa:openjdk-r/ppa -y

이제 apt 명령을 사용하여 Java 8을 설치합니다.

sudo apt install openjdk-8-jdk -y

설치가 완료되면 시스템에 설치된 Java 버전을 확인합니다.

java -version

그리고 Java OpenJDK 1.8이 이제 우분투 18.04 시스템에 설치되었음을 알 수 있습니다.

참고:

• 시스템에 여러 Java 버전이 있는 경우 아래 명령을 사용하여 기본 Java 버전을 변경합니다.

sudo update-alternatives --config java

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를 설치합니다.

sudo apt update  
sudo apt install jenkins -y

설치가 완료되면 Jenkins 서비스를 시작하고 부팅 시 자동으로 시작되도록 추가합니다.

systemctl start jenkins  
systemctl enable jenkins

Jenkins는 이제 우분투 18.04 서버에서 실행 중이며, 기본 포트 ‘8080’에서 실행되고 있습니다. 아래와 같이 netstat를 사용하여 확인합니다.

netstat -plntu

그리고 아래와 같은 결과를 얻을 수 있습니다.

3단계 - Jenkins를 위한 Apache2 리버스 프록시 설치 및 구성

이 튜토리얼에서는 Apache 웹 서버 뒤에서 Jenkins를 실행할 것이며, Apache를 Jenkins의 리버스 프록시로 구성할 것입니다.

먼저 Apache를 설치하고 필요한 모듈을 활성화한 후, Jenkins를 위한 도메인 이름 jenkins.hakase-labs.io로 가상 호스트 파일을 생성합니다. 여기서 자신의 도메인 이름을 사용하고 모든 구성 파일에서 나타나는 부분을 교체하십시오.

우분투 리포지토리에서 apache2 웹 서버를 설치합니다.

sudo apt install apache2 -y

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

a2enmod proxy  
a2enmod proxy_http

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

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

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

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

저장하고 종료한 후, a2ensite 명령으로 Jenkins 가상 호스트를 활성화합니다.

a2ensite jenkins

Apache와 Jenkins 서비스를 재시작합니다.

systemctl restart apache2  
systemctl restart jenkins

Apache2 설치 및 Jenkins를 위한 리버스 프록시로서의 구성이 완료되었습니다.

4단계 - UFW 방화벽 구성

우분투 서버에서 UFW 방화벽을 활성화하기 전에 SSH, HTTP 및 HTTPS와 같은 기본 서비스 포트를 추가해야 합니다.

UFW 방화벽에 SSH, HTTP 및 HTTPS 서비스를 추가합니다.

ufw allow ssh  
ufw allow http  
ufw allow https

이제 UFW 방화벽을 시작하고 활성화합니다.

ufw enable

type ‘y’를 입력하고 Enter를 누릅니다.

UFW 방화벽이 이제 활성화되었으며, HTTP 포트가 추가되었습니다.

5단계 - Jenkins 구성

Jenkins는 도메인 이름 ‘http://jenkins.hakase-labs.io’에서 실행되고 있습니다. 웹 브라우저를 열고 URL을 입력합니다.

초기 관리자 비밀번호를 입력하라는 화면이 표시됩니다. Jenkins에 의해 이미 생성된 비밀번호가 있으므로 결과를 비밀번호 상자에 복사하여 붙여넣기만 하면 됩니다.

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

cat /var/lib/jenkins/secrets/initialAdminPassword

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

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

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

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

인스턴스 구성에서 Jenkins 도메인 이름 ‘http://jenkins.hakase-labs.io’를 입력하고 ‘저장 및 완료’ 버튼을 클릭합니다.

이제 ‘Jenkins 사용 시작’ 버튼을 클릭합니다.

그리고 Jenkins 관리자 대시보드로 리디렉션됩니다.

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

6단계 - Jenkins 보안

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

Jenkins는 ‘액세스 제어’ 섹션에서 여러 권한 부여 방법을 제공합니다. 우리는 모든 사용자 권한을 제어할 수 있도록 ‘행렬 기반 보안’을 사용할 것입니다.

‘사용자/그룹’ 상자에 ‘hakase’ 사용자를 추가하고 추가를 클릭합니다.

‘hakase’ 사용자에게 모든 권한을 부여하기 위해 모든 옵션을 체크하고 ‘저장’ 버튼을 클릭합니다.

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

7단계 - 테스트

이 섹션에서는 Jenkins 서버를 위한 간단한 작업을 생성하고, Jenkins를 테스트하고 서버 부하를 top 명령으로 확인할 것입니다.

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

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

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

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

top -b -n 1 | head -n 5

‘저장’을 클릭합니다.

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

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

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

우분투 18.04에서 Apache2를 리버스 프록시로 사용하여 Jenkins 자동화 도구 설치 및 구성이 성공적으로 완료되었습니다.

참고 문헌

• https://wiki.jenkins.io/
• https://wiki.jenkins.io/Standard+Security+Setup
• https://jenkins-le-guide-complet.github.io/