Ubuntu 22.04にJenkinsをインストールする方法

このチュートリアルはこれらのOSバージョンのために存在します

Ubuntu 22.04 (ジャミー・ジェリーフィッシュ)
Ubuntu 20.04 (フォーカルフォッサ)
Ubuntu 18.04 (ビオニックビーバー)
Ubuntu 16.04 (ゼニアル・ゼクサス)

このページで

前提条件
Javaをインストールする
ジェンキンスのインストール
Apache2をリバースプロキシとして設定する
Jenkinsのインストールを開始する
最初のJenkinsビルドを作成する
結論

Jenkinsは、継続的インテグレーション/継続的デリバリー（CI/CD）のためのオープンソースの自動化ツールです。これは完全にJavaで書かれており、プロジェクトの構築、デプロイ、および自動化のための1000以上のプラグインをサポートしています。Jenkinsは、自動化を通じて開発プロセスを加速する主要な自動化ツールの1つになっています。Jenkinsは、ビルド、文書化、テスト、パッケージ化、ステージング、デプロイ、静的分析など、開発ライフサイクルプロセスを統合します。

Jenkinsは、Git、Subversion、Mercurial、CVS、Perforce、RTCなど、複数のバージョン管理ツールをサポートしています。また、Apache Ant、Apache Maven、シェルスクリプト、Windowsバッチコマンドを実行することもできます。Jenkinsは、広範なドキュメントとウィキを持つ強力なコミュニティサポートがあり、Jenkinsは最も使用されている自動化CI/CDツールの1つです。また、開発とデプロイプロセスを自動化するためのさまざまなツール、言語、自動化タスクを提供しています。

このチュートリアルでは、最新のUbuntu 22.04にJenkinsをインストールする方法を学びます。このチュートリアルでは、JenkinsのためにApache2をリバースプロキシとして設定し、その上でSSL接続を有効にする方法も説明します。最後に、シェルスクリプトやコマンドを実行するための最初のJenkinsビルドプロジェクトを作成する方法も学ぶことができます。

前提条件

Ubuntu 20.04サーバー
ルート管理者権限を持つ非ルートユーザー。

Javaをインストールする

この最初のステップでは、Ubuntu システムに Java OpenJDK と JRE をインストールします。Jenkins の最新バージョンは Java v11 を要求しており、これをあなたのシステムにインストールします。

パッケージのインストールを開始する前に、以下のaptコマンドを実行してUbuntuリポジトリを更新およびリフレッシュしてください。

sudo apt update

次のコマンドを使用してJava OpenJDK 11をインストールしてください。

sudo apt install openjdk-11-jre

インストールを開始するには、Yを入力してENTERを押してください。これでJava OpenJDKのインストールが開始されます。

インストールが完了したら、下記のjavaコマンドを実行してjavaのバージョンを確認します。

java --version

以下のスクリーンショットでは、Ubuntu 22.04マシンにJava OpenJDK 11がインストールされている様子が確認できます。

ジェンキンスのインストール

あなたは今、UbuntuシステムにJavaをインストールしました。次に、Ubuntu 22.04マシンにJenkinsをインストールし始めます。

Jenkinsをインストールする方法はいくつかありますが、最も簡単な方法は、公式Jenkinsリポジトリが提供するプレビルドのJenkinsパッケージを使用することです。それを行うには、JenkinsリポジトリをUbuntuシステムに追加する必要があります。

JenkinsリポジトリのGPGキーを追加するには、以下のコマンドを実行してください。

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

その後、以下のコマンドを使用してJenkinsリポジトリをシステムに追加します。

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

今、下記のaptコマンドを実行して、すべてのシステムリポジトリを更新およびリフレッシュしてください。

sudo apt update

下のスクリーンショットでは、Jenkinsリポジトリが追加されているのが見えます。

次に、以下のaptコマンドを使用してJenkinsをインストールできます。

sudo apt install jenkins

インストールを確認するにはYを入力し、続行するにはENTERを押してください。Jenkinsのインストールが今始まります。

インストールが完了したら、以下のコマンドを実行してJenkinsサービスを開始し、有効にします。

sudo systemctl start jenkins
sudo systemctl enable jenkins

次に、以下のコマンドを使用してJenkinsサービスを確認してください。

sudo systemctl status jenkins

次のスクリーンショットでは、Jenkinsサービスがアクティブで実行中です。これはlocalhostでデフォルトポート8080で実行されています。また、Jenkinsは現在有効になっており、これはシステム起動時に自動的に実行されることを意味します。

Apache2をリバースプロキシとして設定する

この時点で、Jenkinsはデフォルトのアドレスlocalhostとポート8080で稼働しています。これから、JenkinsのリバースプロキシとしてApache2ウェブサーバーをインストールして設定します。

Apache2ウェブサーバーはJenkinsサービスの前で実行され、クライアントアクセスのために標準のHTTPおよびHTTPSポートを開きます。

以下のaptコマンドを実行して、apache2パッケージをシステムにインストールしてください。

sudo apt install apache2

インストールを確認するにはYを入力し、続行するにはENTERを押してください。

インストールが完了したら、リバースプロキシ設定に必要なApache2モジュールを有効にするために、以下のコマンドを実行してください。

sudo a2enmod ssl rewrite headers proxy proxy_http

今から次のスクリーンショットのような出力が表示されます。

次に、nanoエディタを使用して、新しい仮想ホストの設定ファイルを /etc/apache2/sites-available/jenkins.conf に作成します。

sudo nano /etc/apache2/sites-available/jenkins.conf

次の設定をファイルに追加してください。そして、ドメイン名とSSL証明書のパスを変更することを確認してください。

<VirtualHost *:80>
    ServerAdmin  webmaster@localhost
    Redirect permanent / https://jenkins.howtoforge.local/
</VirtualHost>
<VirtualHost *:443>
    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem
    ServerAdmin  webmaster@localhost
    ProxyRequests     Off
    ProxyPreserveHost On
    AllowEncodedSlashes NoDecode
    <Proxy *>
        Order deny,allow
        Allow from all
    </Proxy>
    ProxyPass         /  http://localhost:8080/ nocanon
    ProxyPassReverse  /  http://localhost:8080/
    ProxyPassReverse  /  http://jenkins.howtoforge.local/
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Port "443"
</VirtualHost>

作業が完了したら、ファイルを保存して閉じてください。

次に、以下のコマンドを実行して、仮想ホスト設定 jenkins.conf を有効にします。

sudo a2ensite jenkins.conf

その後、以下のコマンドを使用して、すべてのApache2設定を確認し、検証してください。

sudo apachectl configtest

出力メッセージとして「構文は正しい」のようなものを確認してください。これは、Apache2の設定がすべて正しいことを意味します。

最後に、以下のコマンドを実行してApache2サービスを再起動し、Apache2設定の新しい変更を適用します。

sudo systemctl restart apache2

現在、Apache2ウェブサーバーはJenkinsのリバースプロキシ設定で稼働しています。

Jenkinsのインストールを開始する

この時点で、ウェブブラウザからJenkinsのインストールと設定を開始する準備が整いました。しかし、Jenkinsの設定を開始する前に、Jenkinsのパスワード初期化を取得する必要があります。

Jenkinsのパスワード初期化は、ファイル/var/lib/jenkins/secrets/initialAdminPasswordで利用可能です。このファイルには、Jenkinsインストールの初期化のために生成された秘密のパスワードが含まれています。

以下のコマンドを実行して、Jenkinsの初期パスワードを確認および取得します。

ls /var/lib/jenkins/secrets/initialAdminPassword
cat /var/lib/jenkins/secrets/initialAdminPassword

下のスクリーンショットでは、Jenkinsによって生成されたランダムな文字列を見ることができます。あなたは異なるランダムな秘密を持っているかもしれません。

初期の秘密のパスワードをメモにコピーしてください。これは後でJenkinsの設定に使用されます。

ウェブブラウザを開いて、Jenkinsのインストール用URL（例：https://jenkins.howtoforge.local）にアクセスしてください。

最初のページでは、Jenkinsのパスワード初期化を入力するように求められます。秘密のパスワードを貼り付けてJenkinsのインストールと設定を初期化し、次に続行をクリックしてください。

今、ボタン「推奨プラグインをインストール」をクリックして、追加のプラグインを使用したJenkinsの設定を開始します。このオプションは初心者に適しており、プロジェクトに必要なJenkinsプラグインを自動的にインストールします。

これからJenkinsプラグインのインストールが始まります。

インストールプロセスが完了した後、Jenkinsの新しい管理ユーザーを作成するよう求められます。

新しい管理ユーザー、パスワード、メールアドレス、および Jenkins インストールのフルネームを入力し、ボタン 保存して続ける をクリックしてください。

JenkinsのインストールURLには、Jenkinsのドメインを入力し、保存して完了をクリックします。

これから次のページが表示されます。再起動ボタンをクリックして、Jenkinsサービスを再起動し、新しい設定を適用してください。

ジェンキンスが再起動されたら、再度ジェンキンスインストールURLのドメイン名にアクセスしてください。すると、ジェンキンスのログインページが表示されます。

Jenkinsの管理者ユーザー名とパスワードを入力し、サインインをクリックしてください。

ログインすると、以下のJenkinsダッシュボードが表示されます。

あなたは今、最新のUbuntu 22.04にJenkinsを成功裏にインストールし、設定しました。Apache2をリバースプロキシとして使用して、デプロイメントを行っています。

最初のJenkinsビルドを作成する

Jenkinsを正常にインストールして構成した後、Jenkinsダッシュボードから最初のJenkinsビルドを作成します。

Jenkinsのダッシュボードで、メニュー新規アイテムをクリックして、新しいJenkinsビルドプロジェクトを作成します。

プロジェクトの名前を入力し、プロジェクトの種類を選択して、次にOKをクリックします。このデモでは、プロジェクトの名前は「first build」で、プロジェクトの種類は「フリースタイルプロジェクト」です。

一般セクションに、ビルドの説明を入力してください。

次に「ビルド」タブに移動し、ビルドを「シェルを実行」として選択し、以下のコマンドをビルドコマンドとして入力します。

echo "This is test build on jenkins"

このプロジェクトは、Jenkinsのビルド出力に「これはJenkins上のテストビルドです」というメッセージのみを表示します。

今すぐ保存ボタンをクリックしてください。

今、詳細についての「最初のビルド」プロジェクトで、メニューの「今すぐビルド」をクリックしてJenkinsビルドを開始および実行します。

プロセスが完了した後、次のスクリーンショットのように下部メニューにビルド履歴セクションが表示されます。

ビルド番号をクリックして、完了したビルド操作の詳細を取得します。

今、「コンソール出力」メニューをクリックすると、最初のJenkinsビルドの出力が表示されます。それは「This is a test build on jenkins」というメッセージです。そして、Jenkinsビルドは成功しました。

結論

おめでとうございます！最新のUbuntu 22.04サーバーにApache2をリバースプロキシとして、HTTPSの安全な接続を有効にしてJenkinsを正常にインストールしました。また、Jenkinsの基本的な初期化と設定を学び、Jenkinsを使用して最初のシンプルなビルドプロジェクトを作成しました。

Ubuntu 22.04にJenkinsをインストールする方法