【CI奮闘記】第6章：エージェントを作ってみよう！

今回は「エージェント」を実際に作っていってみようか。
「エージェント」ってなにか覚えてる？

そうだね。今回はエージェントを設定して分散ビルドの準備をしてみようか。

大丈夫！やってみよう。
分散ビルドについてもう一度触れるわね。

分散ビルドのイメージはこんな感じ。
Jenkinsを軸として複数台のノードを接続して、それぞれのノードでビルドを行うの。

こうすることでまず単純にビルドに使えるリソースが増えるから、複数のビルドを同時に走らせるという事が可能になるわ。

そうね。あと分散ビルドと書いているけど、ビルドに限った話ではないわ。
複数同時にテストを走らせたいけど、例えばそれぞれのテストが同じポートを使ったり、UIテストで同じブラウザを使ったりといった、お互いに干渉してしまう場合にも有効ね。

それぞれのマシンにJenkinsをインストールする必要はないわ。あくまで軸であるJenkinsは一個。
それぞれのノードにagent.jarと呼ばれる小さなプログラムを走らせばエージェントの構築は完了ね。

そう！

Jenkinsから取得する事ができるの。
$JENKINS_URL以下の　/jnlpJars/agent.jar　にアクセスすればjarファイルを取得できるわ。

Jenkinsのバージョンとあまりに乖離したagent.jarだとうまく動作しないこともあるから、稼働中のJenkinsから取得したほうが良いわね。

ここでちょっとややこしいんだけど、エージェントと呼ばれる前はこの仕組みをスレーブと呼んでいたのね。
なので、古い資料ではこの小さなプログラムが「slave.jar」となっていたりするの。
今でも$JENKINS_URL以下の　/jnlpJars/slave.jarにアクセスするとjarファイルが取得できるわ。

中身は全く同じね。ファイル名が違うだけ。
なのでどちらでも利用はできるんだけど、今から新しく始める場合は用語にあわせてagent.jarを利用したほうが良いのかなと個人的に思うわ。

仕組みもわかったところで実際に設定していきましょう。
まずノードを定義してあげるわ。
今回はサンプルとして作成するので、Jenkinsコントローラーが動いているマシンにエージェントを作成するわね。
「Jenkinsの管理」から「ノードの管理」を選択して、新規ノードの作成を行いましょう。

ノード名には用途がわかりやすいように名前を付けるといいわ。
例えばJDKのバージョン違いのノードを作るのが目的であれば「JDK8」「JDK11」といった具合ね。
今回はそのままsampleと入れるわね。

するとこのように設定画面が表示されるわ。

このリモートFSルートにはJenkinsコントローラーが動作しているノード上のフォルダも指定もできるわ。今回は作成の検証なのでJenkinsノードにJenkins-agent\sampleというフォルダを作ってそこを指定しましょう。

各項目の後ろにある「？」ボタンを押下するとその項目の説明がでるので、うまく活用しましょう。
この設定が完了するとノードが登録が完了ね。

まだ登録しただけだからね。
さっき登場したagent.jarを動かしてあげる必要があるわ。
作成したノードをクリックするとこんな風に起動方法が説明されているのでそれに従って実行しましょう。

今回はagent.jarをダウンロードして先ほどの「リモートFSルート」に配置して、画面に記載してあるコマンドを実行してみましょう。

現在Jenkinsコントローラーと同じパソコンにsampleを立てているのでmasterと同じ値になっているけど、このようにノードの空きディスク容量のモニタリングといったこともできる様になるわ。

このようなことを繰り返し実施することでエージェントを増やしていくことができるわ。
また、一度作成した設定をコピーしてノードを作る事もできるの。

Jenkinsとしての制約は無いけど、実際にはコントローラーのノードのスペックに依存することになると思う。
ノードのメモリであったり、ネットワークだったり、実行したログはコントローラーのノードに保存されるのでディスクI/Oであったりかしらね。
実例としては500以上のオンラインノードを持つ例もあるので、必要量増やしていってみて問題が発生したら制限するという考え方でいいと思うわ。

それじゃあ次回は実際にJenkinsのジョブを作成してみようかしら。