JenkinsとSSH

定期的なビルドを行うツールの1つに、Jenkins CIがある。ソースのあるリポジトリをチェックし、必要に応じてApache AntなりMaven なり実行してくれるのだが、「リポジトリにはSSHでトンネル掘ってアクセス」なんて環境だと、困ってしまう。パスワードの設定されていないキーを使えとは言うものの、実際にはなかなか難しかったりする。

一方、SSHを便利に使うツールの1つに、ssh-agentがある。ssh-addで登録されたパスフレーズを、ユーザの代わりにsshに入力してくれるのだ。
これを使えば、Jenkinsがssh経由でリポジトリにアクセスするとき、パスフレーズを自動的に入力させることが可能だ。 sshは環境変数SSH_AUTH_SOCKにセットされているソケットからパスフレーズを読みだす。また、ssh-agentが出力する内容は、環境変数SSH_AUTH_SOCKおよびSSH_AGENT_PIDをセットする形になっている。だから、

• ssh-agentの出力内容をどこかに取って置き
• Jenkinsからsshを起動する際、取っておいたssh-agentの出力を取りこんで、ssh-agentにパスフレーズの入力をしてもらう

という形にすれば、うまくいくはずだ。

まずはssh-agentの起動スクリプト。例えば、setup-jenkins-sshとする。出力内容は後で使うので、/tmp/jenkins-envに出しておく。

#!/bin/sh
PATH=$PATH:/usr/bin
export PATH
if [ "x" == "x`pgrep -u tomcat ssh-agent`" ]; then
  umask 077
  ssh-agent -s > /tmp/jenkins-env
  ssh-agent
fi

次。sshのwrapperを、以下の内容で作成する。ファイル名は、例えばjenkins-sshとする。

#!/bin/sh
. /tmp/jenkins-env
ssh $*

sshのキー関係は適切に準備する。とはいっても、~tomcat/ssh に、リポジトリにアクセスするときの秘密鍵を置いておけばよい。 これで、準備OK。最初に、sudo -u tomcat setup-jenkins-ssh として、ユーザtomcatでアクセスしたときのパスフレーズを登録しておく。
あとはjenkinsでjobを作成する。リポジトリにアクセスする部分では、CVS_RSHの設定ができるので、上記で作成したjenkins-ssh を指定すればよい。