このチュートリアルでは、Alibaba Cloud ECS Ubuntu 16にJenkins自動化サーバーの最新版をインストールします。
本ブログは英語版からの翻訳です。オリジナルはこちらからご確認いただけます。一部機械翻訳を使用しております。翻訳の間違いがありましたら、ご指摘いただけると幸いです。
Alibaba Cloud Tech Share 著者Liptan Biswas, Tech Shareは、クラウドコミュニティ内で技術的な知識やベストプラクティスを共有することを奨励するAlibaba Cloudのインセンティブプログラムです。
3部構成の前回のチュートリアルシリーズでは、Ubuntu 16.04にJenkinsをインストールする方法を見て、Mavenを使ってサンプルのJavaアプリケーションを作成しました。また、サンプルのWebアプリケーションを構築するためにJenkinsでビルドジョブを作成し、最初のビルドジョブを正常に実行しました。
このシリーズ最後のチュートリアルでは、ビルドジョブを自動化するためにJenkinsを設定します。また、Jenkinsを設定してWebアプリケーションをTomcatのWebサーバに自動的に配信することで、継続的な配信の基本を見ていきます。
自動ビルドの設定
Jenkinsのダッシュボードから、サンプルジョブ「MyMavenApp」をクリックして、ジョブのステータスページを開きます。次に、「構成」リンクをクリックして、ビルドジョブの構成を開きます。下にスクロールして「Build Triggers」セクションを見つけます。このセクションには、ビルドトリガーに複数のオプションがあることがわかります。ここでは、"Poll SCM "オプションのみに注目します。チェックボックスを選択すると、ポーリングスケジュールを入力するテキストボックスが表示されます。Jenkinsでのスケジュールの設定は、少し修正したcron構文を使用しています。
cronの構文は以下の通りです。
MINUTE HOUR DATE MONTH DAY
MINUTE - Minutes in an hour, (0 to 59)
HOUR - Hour of the day, (0 to 23)
DATE - Date of the month, (1 to 31)
MONTH - Month of the year, (1 to 12)
DAY - Day of the week, (0 to 7), 0 and 7 both are Sundays
Examples.
0 20 * * * At 20:00 every day
0 4 * * 0 At 04:00 on every Sunday
0 22 * * 1-5 At 22:00 on every day-of-week from Monday through Friday
上のスクリーンショットでは、5分ごとにソースの変更をポーリングするH/5を使用しています。本番環境では、6時間ごとなど、あまり頻繁ではない期間で変更をポーリングしたいかもしれません。これを実現するためにH /6を使用することができます。cronスケジュールを提供したら、設定を保存します。サイドバーに "Git Polling Log "という名前の新しいオプションが追加されているのがわかります。このオプションを使って、前回のGitポーリングを知ることができます。
ソースコードに変更があった場合に Jenkins が自動ビルドを起動しているかどうかを確認するために、コードに変更を加えてみます。すべてが正常に動作していれば、次のgit pollで変更を検知します。変更が検出されると、Jenkins が自動ビルドを開始します。
ECSインスタンスのターミナルにsudoユーザーでログインします。Mavenサンプルプロジェクトを作成したディレクトリに切り替えます。
cd ~/MyMavenApp
プロジェクト内のJSPファイルを編集し、コンテンツを追加します。ボディタグに「I love Alibaba Cloud」という行を追加することができます。目的は、ファイルの中にいくつかの変更を加えるだけです。
nano src/main/webapp/index.jsp
ファイルを保存したら、以下のコマンドで更新したファイルをgitに追加します。
git add .
では、変更した内容をプロジェクトにコミットします。
git commit -m "Updated index.jsp”
以下のような出力が表示されるはずです。
aliyun@jenkins:~/MyMavenApp$ git add .
aliyun@jenkins:~/MyMavenApp$ git commit -m "Updated index.jsp"
[master 4e5e2ce] Updated index.jsp
1 file changed, 1 insertion(+)
変更内容をリモートのGithubリポジトリにプッシュします。
git push origin master
コードをリモートリポジトリにプッシュしたら、Jenkinsのジョブに戻り、Webページを更新し続けます。5分ごとにSCMの変更をポーリングするようにJenkinsを設定しているので、Jenkinsが変更を検出してビルドを開始するのにそれほど時間はかかりません。
ビルドの情報はビルドステータスページでも確認できます。index.jspに変更が発生し、SCMの変更によってビルドが開始されていることがわかります。
スクリプトによるビルドのトリガー
また、Webブラウザを介して、またはスクリプトから特別な事前定義されたURLを呼び出すことでビルドをトリガーすることもできます。このタイプのビルドトリガーは、スクリプトからビルドをトリガーする必要がある場合に便利ですし、ソースコントロールシステムのフックスクリプトで使用することもできます。URL からのビルドを有効にするには、作成した Maven ジョブの設定ページに移動します。下にスクロールして「ビルドトリガー」セクションを見つけます。スクリプトからのビルドトリガーを認証するために使用するランダムな認証トークンの秘密を提供します。ビルドをトリガーするには、この秘密の認証トークンを提供することが必須です。
設定を保存した後、以下のURLにアクセスすることで簡単にビルドをトリガーすることができます。
JENKINS_URL/job/PROJECT_NAME/build?token=TOKEN_NAME
例えば、私の場合、ビルドURLは以下のようになります。
https://jenkins.example.com/job/MyMavenApp/build?token=Random_ToKen
また、メッセージと一緒にパラメータの原因を追加することで、コメントやビルドの原因を追加することもできます。例えば、以下のようになります。
https://jenkins.example.com/job/MyMavenApp/build?token=Random_ToKen&cause=Invoked+from+browser
下のスクリーンショットは、URLからビルドを起動した際のスクリーンショットで、リモートホストのIPアドレスからビルドが開始されていることがわかります。また、ビルドを開始する際に添付されたメモも表示されています。
その他のビルド方法
Jenkinsがサポートしているビルドトリガーは他にもいくつかあります。
他のプロジェクトがビルドされた後にビルドする。この方法では、他のプロジェクトのビルドが終了したときにJenkinsがビルドをトリガーします。例えば、以下のスクリーンショットでは、"SomeOtherProject "という名前の別のプロジェクトがビルドを終了し、ビルドが安定したらすぐに "MyMavenApp "をトリガーするように指定しています。
定期的にビルドします。このメソッドを使用すると、プロジェクトの定期的なビルドをトリガーすることができます。ソースコードに変更があるかどうかは関係ありません。トリガーのスケジュールは、cron構文を使って設定する必要があります。cron構文の詳細については、上で説明したPoll SCMメソッドを参照してください。
Jenkinsによる継続的なデリバリー
継続的デリバリーとは、ソフトウェアの新しいバージョンを自動的に、より頻繁にユーザーにリリースすることを目的としたDevOpsのアプローチです。
新しいバージョンのソフトウェアを継続的に配信する方法を学ぶために、Jenkinsを使って継続的インテグレーションを行う方法を学ぶ際に使用したのと同じサンプルMavenプロジェクトを使用します。ここでは、生成したwarファイルをTomcat 8のWebサーバに自動的にデプロイするようにJenkinsを設定します。Tomcat 8 Webサーバは、Ubuntu 16.04にデフォルトのUbuntuリポジトリから簡単にインストールできます。もう一度、Ubuntu ECSインスタンスにsudoユーザーとしてログインし、以下のコマンドを実行してTomcat 8 Webサーバーをインストールします。
sudo apt -y install tomcat8 tomcat8-admin
デフォルトでは、Apache Tomcatはポート "8080 "をリッスンするように設定されています。私たちのUbuntuインスタンスでは、すでにJenkinsがポート "8080 "をリッスンしているので、Tomcatのポートを変更する必要があります。Tomcatサーバの設定ファイルを開きます。
sudo nano /etc/tomcat8/server.xml
次の行を探します。
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
...
ポートの値を「808080」から「8081」に変更します。
<Connector port="8081" protocol="HTTP/1.1"
connectionTimeout="20000"
さらに、"manager-script" ロールを持つ新しい tomcat サーバユーザを作成する必要があります。このユーザは、JenkinsがTomcatサーバの設定とwarアプリケーションのデプロイに使用します。
sudo nano /etc/tomcat8/tomcat-users.xml
テキストファイルの前に以下の行を追加します。
<user username="jenkins" password="StrongPassword" roles="manager-script" />
完了すると、以下のような設定になっているはずです。
ファイルを保存してエディタを終了します。これで、Tomcatサーバを再起動し、コマンドを実行することで起動時に自動的に起動するようにすることができます。
sudo systemctl restart tomcat8
sudo systemctl enable tomcat8
Tomcatが動作しているかどうかを確認するには、Webブラウザを使って、http://jenkins.example.com:8081 または http://172.16.0.1:8081 のアドレスにアクセスします。Tomcatの例のページが表示されます。
これでウェブアプリケーションのステージングとテスト環境の準備ができました。さらに、アプリケーションをTomcat 8に自動的にデプロイするためにJenkinsを設定する必要があります。 Jenkinsインスタンスにログインし、"Manage Jenkins >> Manage Plugins "に移動します。「Available」タブに切り替え、「Deploy to container」プラグインを検索します。
プラグインを選択し、「再起動せずにインストール」ボタンをクリックします。Jenkinsダッシュボードに戻り、「MyMavenApp」プロジェクトをクリックし、プロジェクトの構成ページを開きます。下にスクロールして「Post-build Action」を見つけ、ドロップダウンメニューから「Archive artifacts」オプションを選択します。[アーカイブするファイル]テキストボックスにワイルドカードの */.war を入れます。これにより、Jenkinsはワークスペース全体をスキャンして、すべてのwarファイルを見つけ出し、アーカイブするようになります。
アーカイブされたアーティファクトは、すべてのビルド情報ページでダウンロードできるようになります。将来的には、すべてのビルド後に生成されたwarファイルをダウンロードできるようになります。
次に、ドロップダウンメニューから "Deploy war/ear to a container "を選択して、別のビルド後のアクションを追加します。"war/ear files" テキストボックスにワイルドカード */.war を入れて、現在のワークスペース内のすべての war アーティファクトを検索します。Context path" テキスト入力には、アプリケーションが公開されるパスを入力します。例えば、"MyMavenApp "と入力すると、アプリケーションはURLの "http://jenkins.example.com:8081/MyMavenApp "にデプロイされます。コンテナで、「コンテナの追加」のドロップダウンメニューから「Tomcat 8.x」を選択します。
「資格情報」の横にある「追加」ボタンをクリックします。「資格情報の追加 」では、先ほど "tomcat-users.xml "ファイルに入力したユーザ名とパスワードを入力します。IDフィールドは空欄のままにしておき、Jenkinsが生成するようにします。後で簡単に識別できるように、キーの説明を記述します。
キーが追加されたら、"Credentials "のドロップダウンメニューからキーを選択します。プロトコル "http "または "https "とTomcatがリッスンしているポートと一緒に、Tomcat 8インスタンスへのリンクを提供します。ビルド後の設定は、スクリーンショットのようになっているはずです。
設定を保存し、サンプルプロジェクトのメインページに戻ります。「Build now」リンクをクリックしてプロジェクトをビルドしてください。チュートリアルの通りに進めば、ビルドは正常に行われているはずです。
ビルド情報のページでは、生成されたアーティファクトをダウンロードすることもできます。JenkinsがアプリケーションをTomcat 8上に正常にデプロイしたかどうかを確認するには、「コンソール出力」をクリックします。最後にスクロールダウンすると、Jenkinsがアプリケーションをアーカイブし、Tomcat 8上にデプロイしたことに関するログが表示されます。
これで、http://jenkins.example.com:8081/MyMavenApp
にアクセスしてWebアプリケーションにアクセスできます。アプリケーションが正常に機能していることがわかります。私たちのアプリケーションはサンプルアプリケーションだったので、「HelloWorld！」だけが表示されるはずです。
結論
このチュートリアルの最後の部分では、複数の方法を使ってJenkinsの自動ビルドを設定することを学びました。最後に、Jenkinsを設定して、サンプルのWebアプリケーションをTomcat 8のWebサーバに自動的にデプロイすることで、Jenkinsでの継続的な配信を有効にしました。
これで、Jenkinsを使い始めるための3部構成のチュートリアルを終了します。我々は、単一ノードにJenkinsオートメーションサーバーをインストールする手順を見てきました。また、JenkinsにCI/CDパイプラインを作成するための基本を学びました。また、Jenkinsを学習しながら、Mavenのインストールとその中でのサンプルJavaウェブアプリケーションプロジェクトの作成についても見てきました。プロジェクトの初期化、リポジトリの作成、変更のコミット、リモートオリジンの追加、変更のプッシュなど、「git」コマンドの使い方の基本を見ました。同様に、実際のプロジェクトをJenkinsにセットアップしていきます。ビルドパイプラインには様々なアプローチがあります。今回のプロジェクトで使用したのと同じような設定に従えば、あとはコミットをプッシュするだけで、Jenkinsがそれ以外のことはすべてやってくれます。変更をプッシュした後、ビルドが終了するのを待つと、アプリケーションがコンテナにデプロイされるのがわかります。ここではJenkinsの基本的なことしか説明していませんので、Jenkinsのドキュメントのページを参照してください。
アリババクラウドは日本に２つのデータセンターを有し、世界で60を超えるアベラビリティーゾーンを有するアジア太平洋地域No.1(2019ガートナー)のクラウドインフラ事業者です。
アリババクラウドの詳細は、こちらからご覧ください。
アリババクラウドジャパン公式ページ