2012/05/16

Windows上のJenkinsに他のWindowsマシンのスレーブを追加した際のメモ

参考
https://wiki.jenkins-ci.org/display/JENKINS/Distributed+builds (英語)
https://wiki.jenkins-ci.org/display/JA/Distributed+builds (日本語) 
https://wiki.jenkins-ci.org/display/JENKINS/Step+by+step+guide+to+set+up+master+and+slave+machines (英語)

 上記のリンクに書いてある通りにやればいいのですが、私は引っかかってしまったのでメモしておきます。
タイトルにもありますが、今回はWindows上のJenkinsに他のWindowsマシンのスレーブを追加しました。 


Jenkinsトップページから、Jenkinsの管理 - ノードの管理 - 新規ノード作成 と進みます。
○ノード名:マシン名
○説明:(任意)
○リモートFSルート:スレーブ上のワークディレクトリ
○ラベル:Jenkins上のジョブをどのラベルが付いたノードでビルドするか選択できます。マシン名か役割名を付けておくと便利。
○用途:「このスレーブをできるだけ利用する」「このマシーンを特定ジョブ専用にする」とありますが、用途に応じて選択してください。
まずは、「WindowsサービスとしてこのWindowsスレーブを制御」を選択してみました。
(後述しますが、これでつまづいてしまいました。)
その後、管理者のユーザー名、パスワードを入力しました。 ホストはマスタからスレーブがマシン名で名前解決できなかったので、IPアドレスを記述しました。
 サービスを実行するユーザーは「Use Local System User」を選択しました。
(これがまずかったかも?)
この状態で実行してみたのですが、スレーブへの接続、ファイルの転送までは完了でき、サービスを開始するところで失敗してしまいました。
このまま調査したかったのですが、急ぎだったこともあり、保留として別の設定に切り替えました。
「WindowsサービスとしてこのWindowsスレーブを制御」ではなく、
「JNLP経由でスレーブを起動」を選択しました。
保存後、スレーブ側からこのページにアクセスし、Launchボタンを押下することで接続完了でき、スレーブ上でジョブを実行することができました。









 ■「WindowsサービスとしてこのWindowsスレーブを制御」で失敗した原因は何か
 ・「Use Local System User」ではなく、「Use Administrator account given above」を選択すればよかった?
 ・Jenkins上の設定は問題なく、スレーブマシンで何かサービスを起動するための作業が必要だった?

そのうち調査しようと思います。
もし原因をご存知であれば、共有いただけると助かります。

2012/09/25 追記
■JNLP経由でのスレーブ起動を自動化する方法
スレーブからhttp://ドメイン名/jenkins/computer/スレーブ名 へアクセスすると下記のコマンドが表示されるので、これをタスクスケジューラに登録する。

・コマンド
 javaws http://ドメイン名/jenkins/computer/スレーブ名/slave-agent.jnlp
・タスクスケジューラ
 名前:StartJenkinsSlaveAgent (任意)
 トリガー:スタートアップ時
 操作:プログラムの開始
  プログラム/スクリプト:javaws
  引数の追加:http://ドメイン名/jenkins/computer/スレーブ名/slave-agent.jnlp

登録時にAdministratorのパスワードを入力すれば完了。
このタスクを選択して右クリックからエクスポートすれば、他のスレーブが必要になった時も、xmlファイルをコンピュータ名の辺りだけ直してインポートすればOK。

エクスポート結果↓


<?xml version="1.0" encoding="UTF-16"?>
<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
  <RegistrationInfo>
    <Date>2012-09-25T22:27:15.0012502</Date>
    <Author>t-PC\t</Author>
  </RegistrationInfo>
  <Triggers>
    <BootTrigger>
      <Enabled>true</Enabled>
    </BootTrigger>
  </Triggers>
  <Principals>
    <Principal id="Author">
      <UserId>t-PC\t</UserId>
      <LogonType>Password</LogonType>
      <RunLevel>LeastPrivilege</RunLevel>
    </Principal>
  </Principals>
  <Settings>
    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
    <DisallowStartIfOnBatteries>true</DisallowStartIfOnBatteries>
    <StopIfGoingOnBatteries>true</StopIfGoingOnBatteries>
    <AllowHardTerminate>true</AllowHardTerminate>
    <StartWhenAvailable>false</StartWhenAvailable>
    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
    <IdleSettings>
      <StopOnIdleEnd>true</StopOnIdleEnd>
      <RestartOnIdle>false</RestartOnIdle>
    </IdleSettings>
    <AllowStartOnDemand>true</AllowStartOnDemand>
    <Enabled>true</Enabled>
    <Hidden>false</Hidden>
    <RunOnlyIfIdle>false</RunOnlyIfIdle>
    <WakeToRun>false</WakeToRun>
    <ExecutionTimeLimit>P3D</ExecutionTimeLimit>
    <Priority>7</Priority>
  </Settings>
  <Actions Context="Author">
    <Exec>
      <Command>javaws</Command>
      <Arguments>http://ドメイン名/jenkins/computer/スレーブ名/slave-agent.jnlp</Arguments>
    </Exec>
  </Actions>
</Task>

もしくは、Launchボタンを押下した後に表示されるウィンドウのFile→Install as Windows Serviceを選択してサービスとして登録してもOK。