r-labs

h1. Hudson プラグイン

Sorry, English page is [[Hudson_En|here]] .

{{>toc}}

h2. 入手方法

最新バージョンは 1.0.2 です。

* "リポジトリから":http://r-labs.googlecode.com/svn/trunk/plugins/redmine_hudson/

* "ダウンロード":http://r-labs.googlecode.com/files/redmine_hudson-1.0.2.zip

h2. Hudson って何？

継続ビルドのためのアプリケーションです。

簡単インストール、設定、親切なUIが特徴です。（他にも良い点は沢山ありますよ！）

詳しくは "Meet Hudson":http://wiki.hudson-ci.org/display/HUDSON/Meet+Hudson

作者の川口さんが書かれた紹介記事もあります。 "Hudsonを使ったアジャイルな開発入門":http://gihyo.jp/dev/feature/01/hudson/0001

Hudson側にも "Redmine用プラグイン":http://d.hatena.ne.jp/gaooh/20090308/1236509572 があります。

h2. どんなことができるの？

h3. ジョブを表示することができます。

* 名前、説明、最新のビルド結果（番号と結果と日時）、ヘルスレポートを表示します。

* 今日ビルドされたジョブが分かります。

* 説明は表示／非表示をその場で切り替えることができます。

* ヘルスレポートで指定したキーワードを見つけると、Hudsonへのリンクを作成します。

* ビルド番号はビルド結果のページにリンクされています。

* ビルドの成果物（アーティファクト）をダウンロードできます。

* 時計アイコンをクリックすると、ジョブをビルドすることができます。

* ハドソンさん？が登場します。（残念ながら怒ったハドソンさんはでてきません）

!redmine_hudson_index_1_0_2_ja_small.png!

h3. ビルド履歴を表示することができます。

* ノートアイコンをクリックすると、ビルド履歴が表示されます。

* ビルド履歴には、ビルド番号、日時、コンソールアイコンが表示されます。

* ビルド番号からビルド結果へ、コンソールアイコンからコンソール出力へ移動できます

h3. ビルド履歴を活動ページに表示します。

ジョブの名前／ビルド番号に加え、テスト結果(件数)と、変更点(チェンジセット)が表示できます。

!redmine_hudson_show_build_history_on_activity_ja.png!

h3. ビルド結果をチケットに表示します。

関連したリビジョンがHudsonでビルドされると、ジョブの名前、ビルド番号、結果と日時を表示します。

!redmine_hudson_show_build_result_on_issue_ja.png!

h3. ジョブやビルドに関連するチケットを検索することができます

カスタムフィールドのように、ジョブやビルドに関連するチケットを検索することができます。

指定されたジョブやビルドから関連するリビジョンを探し出し、コミットログで関連づけたチケットを検索します。

プラグインは、ジョブ -> ビルド -> チェンジセット -> リビジョン -> チケット の順に追跡を行います。

ビルドやチェンジセットは非常に数が多くなるので、ジョブ毎に追跡するビルドの数や、チェンジセットの数を制限しました。

ビルドやチェンジセットの上限は、設定ページで変更することができます。

管理 -> プラグイン -> Redmine Hudson Plugin にある 設定のリンクから設定ページに移動してください。

h3. rake タスクを使ってHudsonの情報を取得することができます。

redmine_hudson:fetch タスクを使ってください。

rake タスクを使って情報を取得する場合は、必ず 自動取得モード（後述します）を OFF にしてください。

h3. 必要のなくなったビルド情報を削除することができます

ジョブごとに保持する期間や件数をカスタマイズすることができます。

h3. プロジェクト毎に設定ができます

* ハドソンのURL (httpsも一応使えます)

* ハドソンにアクセス際利用する認証用のユーザ名とパスワード

* テスト結果とチェンジセットを取得しないように (テスト結果とチェンジセットを取得すると結構時間がかかるので)

* 表示するジョブ

* コンパクトモード (ジョブの名前と最新のビルド結果のみ表示します)

* ヘルスレポートの設定（キーワードと、リンク先のURL）

!redmine_hudson_settings_1_0_2_ja_small.png!

h3. プラグイン全体の設定ができます

管理 -> プラグイン -> Redmine Hudson Plugin にある 設定のリンクから設定ページに移動してください。

* ジョブの説明で利用する書式（HTMLで書く、Textileで書くのいずれかを選ぶことができます）

* 自動取得モード（一覧を表示する際に、最新の情報を取得します）

* ジョブごとに追跡するビルドの件数（チケットの検索で利用します）

* ジョブごとに追跡するチェンジセットの件数（チケットの検索で利用します）

!redmine_hudson_global_settings_1_0_2_ja_small.png!

h2. インストール方法

h3. プラグインをインストールする

# プラグインを vendor/plugins ディレクトリにコピーします

# コマンドを実行します 'rake db:migrate_plugins RAILS_ENV=production'

# Redmine を開始します

h3. プロジェクトでプラグインを利用する

# プロジェクトの設定ページに移動します

# 'モジュール' をクリックします

# 'Hudson' をチェックして、保存します

h3. Hudson の設定を変更します

# 'Hudson' タブをクリックします

# サイドバーにある '設定' をクリックします

# 設定を編集します（URLや、表示したいジョブを設定しましょう）

h3. ジョブを確認します

# 'Hudson' タブをクリックします（初回はかなり時間がかかるでしょう）

h2. 言語ファイル作成者（ありがとうございます）

[de.yml] Jens Goldhammer, Florian Bartels

[es.yml] juancayetano.delgado

[fr.yml] Francois-Xavier CAUVIN

[hu.yml] Péter Major

h2. 注意点

h3. Hudson について

Hudson 1.313 以降が推奨です。

バージョンが 1.313 より古い場合は、テスト結果やチェンジセットが取得できず、履歴に表示できないかもしれません。

テスト結果やチェンジセットが取得できなくても、ビルド情報だけは保存します。が、一度失敗すると二度と取得しません。

h3. IE8について

互換モードを使ってください。

h3. 排他処理について

現在、排他処理が入っていないので、Redmine が複数のサーバで動作している場合は上手く動かない場合があります。

排排他処理については、できれば何とかしたいと思っています。

h3. どうしようもなくなったら？

設定ページの履歴を削除 ボタンを使って、データベースの内容を初期化してみてください。

状況が改善するかもしれません。

h2. 変更履歴

h3. 1.0.2

* ##198 (機能) ビルド成果物（アーティファクト）がダウンロードができます

* ##266 (機能) 必要がなくなったビルド情報を削除できる

* ##267 (機能) 指定したジョブやビルドに関連するチケットを検索できる

* ##235 (バグ) IEで活動ページのHudsonアイコンが表示されない

* ##273 (バグ) Hudsonから応答がない場合に、Internalエラーが発生する

* ##276 (バグ) Redmine0.9.x または trunk で translation missing が発生する

* ##284 (バグ) プロジェクトで設定を保存すると、エラーが発生する

* ##286 (バグ) Hudsonからチェンジセットの情報を取得できない

* ##288 (バグ) Redmine0.9.0でチケットにビルド結果が表示されない

* ##291 (バグ) db:migrate_plugins が PostgreSQL で失敗する

h3. 1.0.1.1

* ##244 rcov がないと rake db:migrate_plugins が動かない

* ##242 Redmine0.8.7でジョブのビルドと履歴が動かない

h3. 1.0.1

* ##228 インストール手順を追記しました

* ##225 設定が強制的に簡単表示になってしまう

* ##224 今日ビルドしたジョブが分かる

* ##219 Hudsonの活動をRSSで取得できない

* ##218 Anonymous で活動が表示されない

* ##212 最新のビルド結果を表示できない

h3. 1.0.0

* rake タスクを使ってHudsonの情報が取得できるように。

* ジョブの説明に利用する書式が選べるように。

* ジョブの説明の表示／非表示をその場で切り替えられるように。

h3. 0.1.6

* ヘルスレポートの設定が自由にできるように。

h3. 0.1.5

* ビルド結果をチケットに表示するように. ハドソンのアイコンを使うように。

h3. 0.1.4

* ビルド履歴を活動ページに表示するように。ビルドの情報はデータベースに保存するように。

h3. 0.1.3

* Basic認証のバグを修正

h3. 0.1.2

* https接続時のバグを修正

h3. 0.1.1

* Basic認証と、httpsをサポート

h3. 0.1.0

* 最初のリリース

h2. お問い合わせ

* Website  -> r-labs[http://www.r-labs.org/]

* Email    -> couger@kt.rim.or.jp