Ubuntu 22.04に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サーバー
root管理者権限を持つ非rootユーザー。

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 openjdkのインストール

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

java --version

以下のスクリーンショットでは、Java OpenJDK 11がUbuntu 22.04マシンにインストールされていることがわかります。

Jenkinsのインストール

UbuntuシステムにJavaをインストールしたので、次にJenkinsをUbuntu 22.04マシンにインストールします。

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リポジトリが追加されたことがわかります。

jenkinsリポジトリの追加

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

sudo apt install jenkins

インストールを確認するためにYを入力し、続行するためにENTERを押します。Jenkinsのインストールが始まります。

jenkinsのインストール

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

sudo systemctl start jenkins  
sudo systemctl enable jenkins

次に、以下のコマンドを使用してJenkinsサービスを確認します。

sudo systemctl status jenkins

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

jenkinsサービスの開始、有効化、確認

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

この時点で、Jenkinsはデフォルトアドレスlocalhostでポート8080で稼働しています。次に、Apache2ウェブサーバーをJenkinsのリバースプロキシとしてインストールおよび構成します。

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

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

sudo apt install apache2

インストールを確認するためにYを入力し、続行するためにENTERを押します。

apache2のインストール

インストールが完了したら、以下のコマンドを実行してリバースプロキシ構成に必要なapache2モジュールを有効にします。

sudo a2enmod ssl rewrite headers proxy proxy_http

次に、以下のスクリーンショットのような出力が表示されます。

apache2モジュールの有効化

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

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

ファイルに以下の構成を追加します。ドメイン名とSSL証明書のパスを変更することを確認してください。

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    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  
      
        Order deny,allow  
        Allow from all  
      
    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"

完了したら、ファイルを保存して閉じます。

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

sudo a2ensite jenkins.conf

その後、以下のコマンドを使用してすべてのApache2構成を確認および検証します。

sudo apachectl configtest

「Syntax OK」のような出力メッセージが表示されることを確認してください。これは、すべてのApache2構成が正しいことを意味します。

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

sudo systemctl restart apache2

これで、Apache2ウェブサーバーはJenkinsのリバースプロキシ構成で稼働しています。

apache2リバースプロキシの設定

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の初期化パスワード

ウェブブラウザを開き、JenkinsインストールのURL（例：https://jenkins.howtoforge.local）にアクセスします。

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

jenkinsの初期化パスワード

次に、「推奨プラグインをインストール」ボタンをクリックして、追加のプラグインでJenkinsの構成を開始します。このオプションは初心者にとって良いもので、プロジェクトに必要なJenkinsプラグインを自動的にインストールします。

推奨プラグインのインストール

Jenkinsプラグインのインストールが開始されます。

jenkinsプラグインのインストール

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

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

jenkins管理者の設定

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

jenkinsのURLの設定

次に、以下のページが表示されます。再起動ボタンをクリックしてJenkinsサービスを再起動し、新しい構成を適用します。

jenkinsの再起動

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

管理ユーザーとJenkinsのパスワードを入力し、サインインをクリックします。

jenkinsにログイン

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

jenkinsダッシュボード

これで、最新のUbuntu 22.04にJenkinsを成功裏にインストールし、Apache2をリバースプロキシとしてデプロイメントのために設定しました。

最初のJenkinsビルドの作成

Jenkinsを成功裏にインストールおよび構成した後、Jenkinsダッシュボードから新しい最初のJenkinsビルドを作成します。

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

jenkinsビルドの作成

プロジェクトの名前を入力し、プロジェクトのタイプを選択して、OKをクリックします。このデモでは、プロジェクトの名前は「最初のビルド」で、プロジェクトのタイプは「フリースタイルプロジェクト」です。

フリースタイルjenkinsビルドの作成

「一般セクション」で、ビルドの説明を入力します。

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

echo "これはjenkinsでのテストビルドです"

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

次に、保存ボタンをクリックします。

ビルドの実行シェルの設定

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

ビルドプロジェクト

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

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

jenkinsビルド履歴

次に、「コンソール出力」メニューをクリックすると、最初のJenkinsビルドの出力が表示されます。「これはjenkinsでのテストビルドです」というメッセージが表示され、Jenkinsビルドは成功です。

jenkinsのビルド出力

結論

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