Java/Hudson

Top / Java / Hudson

概要
ダウンロード
インストール
使ってみる
JavaDocやJUnit結果を保存する
TIPS集
- コミットに反応してビルドを実行する
関連リンク

概要 †

HudsonはJavaで実装されたContinuous Integrationのためのツールです。Subversionなどのバージョン管理システムからからソースコードをチェックアウトしてきて、ソースをコンパイルしたりJUnitのテストを実行したりなど、継続的インテグレーション開発の手助けをしてくれます。

HudsonはJbossなどのServletコンテナで稼働するwar形式で配布されています。またHudsonのwar自体にも軽量のサーブレットエンジンが同梱されていて、コマンドプロンプトから

java -jar hudoson.war

とやって実行することも可能です。

↑

ダウンロード †

http://hudson-ci.org/ にあるリンクよりダウンロード可能です。

↑

インストール †

ダウンロードしたwarについて、先のコマンド

java -jar hudoson.war

を実行するか、通常のwarファイルのようにサーブレットコンテナにデプロイすればインストールは完了です。

蓄積されるいろいろなデータファイルは、コンテナのオーナのカレント

~/.hudson/

配下に保存されるようです。

ちなみに起動するポート番号を変更するには

java -jar hudoson.war --httpPort=8888

などとオプション指定します。

↑

使ってみる †

http://localhost:8080/hudson/ へアクセスすると下記のようなトップページが表示されます。

ここからSubversionのプロジェクトとかをジョブって単位で登録していくようですね。

↑

ジョブ(プロジェクト?)を作成する †

プロジェクトに名前を付け、プロジェクトの種類を選んでＯＫとすればよいです。プロジェクトの種類はとりあえず「フリースタイル・プロジェクトのビルド」にしておきます。プロジェクトの名前は「SampleJob?」にしました。

↑

プロジェクトの環境設定を記述する１ †

引き続きプロジェクトの設定を記述していきます。

まずはここまでで

ソースコード管理システムをどれを使うか、またそのリポジトリの情報
リポジトリブラウザは何を使うか(ViewVCとかですね)、そのURLはなにか

などを指定します。ココではSubversionを選択しURLは

https://www.masatom.in/svnsamples/repoexp/trunk/HudsonSample/

リポジトリブラウザはViewSVNを選択しURLは

http://www.masatom.in/viewvc/Examples/trunk/HudsonSample/

としました。

↑

プロジェクトの環境設定を記述する２ †

引き続き

ビルドは何をするか
ビルド後にJavaDoc?を保存するか、そのパスはどこか
JUnitの結果集計は保存するか、
ビルド等に失敗したらメールするか、

などの設定があります。

まずはビルドを設定します。「ビルド手順の追加というプルダウンがあり、そこには「シェルの実行」「Mavenの呼び出し」「Antの呼び出し」「Windowsのバッチコマンドの呼び出し」から選択することができます。

ココではAntを使用することにしました。AntのBuild.xmlはあらかじめ今回のビルド対象であるSubversionのHudsonSample?プロジェクト直下に入れておきます。「Antの呼び出し」を指定すると、Antのどのターゲットを実行するかを指定するボックスが表示されますので、「javac junit jar javadoc」とスペース区切りで指定しておきます。

ビルドで使用しているbuild.xmlはビルド用ファイルより参照することができます。コンパイルやjarの生成、JUnitの実行、JavaDoc?の生成など、様々な実行コマンドはほとんどAntタスクを使用しているのがわかると思います。Hudsonはそれらを定期的・継続的に実行して結果を保存してくれるツールって感じですね。

↑