Ubuntu 18.04にApacheを使ってJenkins自動化サーバーをインストールする方法

Jenkinsは、Hudsonプロジェクトからフォークされた自動化サーバーです。JenkinsはJavaサーブレットコンテナで動作するサーバーベースのアプリケーションで、Git、SVN、Mercurialなどの多くのSCM（ソース管理）ソフトウェアシステムをサポートしています。Jenkinsはプロジェクトを自動化するための数百のプラグインを提供しています。JenkinsはKohsuke Kawaguchiによって作成され、2011年にMITライセンスの下で初めてリリースされ、無料ソフトウェアです。

このチュートリアルでは、Ubuntu Server 18.04 LTS（Bionic Beaver）に最新の安定版Jenkinsをインストールする方法を示します。私たちは自分のドメイン名でJenkinsを実行し、Apacheウェブサーバーのリバースプロキシの下でJenkinsをインストールおよび構成します。

前提条件

• Ubuntu 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をインストールします。

software-properties-commonパッケージをインストールし、次に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がUbuntu 18.04システムにインストールされました。

注意:

• システムに複数のJavaバージョンがある場合は、以下のコマンドを使用してデフォルトのJavaバージョンを変更します。

sudo update-alternatives --config java

ステップ2 - Jenkinsをインストールする

Jenkinsはインストールパッケージ用のUbuntuリポジトリを提供しており、このリポジトリから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は現在、Ubuntu 18.04サーバーで実行中で、デフォルトのポート「8080」で動作しています。以下のようにnetstatを使用して確認します。

netstat -plntu

以下のような結果が得られます。

ステップ3 - JenkinsのリバースプロキシとしてApache2をインストールおよび構成する

このチュートリアルでは、JenkinsをApacheウェブサーバーの背後で実行し、ApacheをJenkinsのリバースプロキシとして構成します。

まず、Apacheをインストールし、必要なモジュールを有効にし、次にJenkins用のドメイン名jenkins.hakase-labs.ioの仮想ホストファイルを作成します。ここでは自分のドメイン名を使用し、すべての構成ファイルで表示される場所を置き換えてください。

Ubuntuリポジトリから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ファイアウォールを構成する

UbuntuサーバーでUFWファイアウォールを有効にする前に、SSH、HTTP、HTTPSなどの基本サービスポートを追加する必要があります。

SSH、HTTP、およびHTTPSサービスをufwファイアウォールに追加します。

ufw allow ssh  
ufw allow http  
ufw allow https

次に、ufwファイアウォールを開始して有効にします。

ufw enable

type ‘y’ and press 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管理ダッシュボードから「新しいジョブを作成」をクリックします。

ジョブ名を入力します。ここでは「システムの確認」を使用し、「フリースタイルプロジェクト」を選択して「OK」をクリックします。

「ビルド」タブに移動します。「ビルドステップを追加」で「シェルを実行」を選択します。

以下のコマンドをボックスに入力します。

top -b -n 1 | head -n 5

「保存」をクリックします。

今、あなたは「プロジェクトシステムの確認」のジョブページにいます。「今すぐビルド」をクリックして「システムの確認」ジョブを実行します。

ジョブが実行された後、「ビルド履歴」を見ると、最初のジョブをクリックして結果を確認できます。

以下は、Jenkinsによって実行されたジョブの結果です。

Apache2をリバースプロキシとして使用したJenkins自動化ツールのインストールと構成が正常に完了しました。

参考文献

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