r-labs

h1. Hudson Plugin

{{>toc}}

h2. How to get

Latest version is 1.0.5

* "repository":http://r-labs.googlecode.com/svn/trunk/plugins/redmine_hudson/

* "download":http://r-labs.googlecode.com/files/redmine_hudson-1.0.5.zip

h2. What's hudson?

Huson is application for Continuous Integration.

Easy install configuration, and good ui.

More detail "Meet Hudson":http://wiki.hudson-ci.org/display/HUDSON/Meet+Hudson

h2. Features

h3. Show Job List

* Name, Description, Latest Build ( Build number, Result, Date ) and health report.

* You can find jobs built today.

* You can change description visibility dynamically.

* Provide a link to Hudson, if plugin found keyword in Health Report.

* Bulid number linked to build result page.

* Download artifacts.

* Click clock-icon, request hudson to build.

* Mr. hudson appears. ( sorry, not emotional )

!redmine_hudson_index_1_0_2_en_small.png!

h3. Show Build History

click note icon, show build history

* build number, result, date.

* Bulid number linked to build result page.

* Console icon linked to console page.

h3. Show build history on activity.

* jobname, build number, test-result(only number of items) and changesets.

!redmine_hudson_show_build_history_on_activity.png!

h3. Show build result on issue.

* job-name, build-number, result and built date and time. when Hudson builds revisions associated issues.

!redmine_hudson_show_build_result_on_issue.png!

h3. Search issues related particular build

You can search issues related job and build using filter.

Plugin chases issues by taking following step.

 Hudson Job -> Hudson Build -> Related Changeset -> Revision -> Issue

Hudson Build and Related Changeset are too much, so plugin limits number of Builds and Changesets per each Hudson Job.

You can change limit settings on settings/plugin/redmine_hudson.

h3. rake task 'redmine_hudson:fetch'

You can get build results using rake task 'redmine_hudson:fetch'.

If you use rake task, please uncheck 'AutoFetch' setting.

You can change 'AutoFetch' setting on settings/plugin/redmine_hudson.

h3. Clean up stored data

You can delete old data ( builds, changesets, test results ).

Settings are like Hudson.

* rotate days ( 1day = keep today's data )

* rotate nums

h3. Settings for each projects

* Hudson url (can use https)

User can specify url separately, for plugin access and user access.

* auth user, password ( 0.1.1 higher )

* can stop plugin getting test results and changesets. (Getting test results and changesets needs a good amount of time.)

* choose job

* compact mode ( show only job name and latest build)

* keyword and url for health report

!redmine_hudson_settings_1_0_3_en_small.png!

h3. Settings for plugins (all projects)

Go  Administration -> Plugins -> 'Redmine Hudson Plugin' Configure.

* You can choose format to write job description. HTML or Textile.

* AutoFetch Mode. Plugin fetches information from Hudson during action 'index'.

* Number of Builds per each Hudson Job. ( for search issues )

* Number of Changesets per each Hudson Job. ( for search issues )

!redmine_hudson_global_settings_1_0_2_en.png!

h2. Support Language

* Japanese

* English

* Deutsch

Thanks! "Jens Goldhammer":http://www.redmine.org/account/show/4080 , "Florian Bartels":http://www.redmine.org/account/show/6169 

* Magyar

Thanks! "Péter Major":http://www.redmine.org/account/show/6179

* Spanish

Thanks! juancayetano.delgado

* Italiano

Thanks! Marco Bazzani

* Chinese

Thanks! Billy T

h2. Install Instructions

h3. Install plugin

# Copy the plugin into the vendor/plugins directory

# Migrate plugin: rake db:migrate_plugins RAILS_ENV=production

# Start Redmine

h3. Enable plugin on project

# Move to Project settings

# Click 'Modules'

# Check the box 'Hudson', and save.

h3. Edit Hudson settings

# Click 'Hudson' tab on the menu

# Click 'Settings' in sidebar

# Edit settings ( url, job... )

h3. View jobs

# Click 'Hudson' tab on the menu (In first time, it takes long time)

h2. Important reminder 

h3. Hudson

Recommend Hudson 1.313

If you use old version of Hudson, plugin may not get test results and changesets.

Plugin store build information, if plugin can't get test results or changesets.

But, If plugin fail, never get test results, changesets again.

h3. Using IE8

Please use Compatibility View in IE8.

h3. Exclusive Control

Plugin has no exclusive control, so plugin doesn't work when redmine works on multi-process.

Hopefully i fix it.

h3. Something is wrong with plugin

you should try to delete data from database.

Use 'delete history' button in setting page.

h2. Changelog

h3. 1.0.5

* #411 (Feature) Chinese translation

* #387 (Defect) Error occurs when Hudson.Fetch fails by HudsonApiException

* #386 (Feature) Localization for permission string

h3. 1.0.4

* #367 (Defect) Error occurs when delete all history

* #366 (Defect) Fail to save if new project settings have health report settings

* #344 (Defect) Fail to save Health report settings

h3. 1.0.3.1

* #318 (Defect) some tests failed

* #316 (Defect) internal error occurres on issue page

h3. 1.0.3

* #282 (Defect) unit and feature test failed with redmine 0.9.x or trunk

* #304 (Defect) migrate_plugins failed with MySQL

* #306 (Feature) User can specify url separately, for plugin access and user access

* #314 (Feature) Italian translation

h3. 1.0.2

* #198 (Feature) You can download artifacts.

* #266 (Feature) Clean up stored data.

* #267 (Feature) Search issues related particular build.

* #235 (Defect) Hudson icon does not display in activitiy view with IE

* #273 (Defect) Internal error occures when hudson has no response.

* #276 (Defect) Translation missing occures on redmine0.9.x or trunk

* #284 (Defect) When saving the settings for a project, get the exception.

* #286 (Defect) Can't get changeset information.

* #288 (Defect) Can't show build results on issue redmine0.9.x or trunk

* #291 (Defect) db:migrate_plugins failed on PostgreSQL

h3. 1.0.1.1

* #244 "rake db:migrate_plugins" doesn't work without rcov

* #242 Build job and Build history doesn't work on Redmine 0.8.7

h3. 1.0.1

* #228 Install Instructions

* #225 You never can check off 'Show Compact'

* #224 You can find jobs built today

* #219 Can't get RSS on activity page, when check 'Hudson' box

* #218 Anonymous can't see acitivity

* #212 Plugin can't show latest build result

h3. 1.0.0

* You can get build results using rake task 'redmine_hudson:fetch'

* Choose format to write job description HTML or Textile

* You can also change description visibility dynamically

h3. 0.1.6

* Health report settings comes in useful.

h3. 0.1.5

* Show build result on issue. Use Hudson icons.

h3. 0.1.4

* Show build history on activity. Save infomation on database.

h3. 0.1.3

* Fixed BasicAuth bug.

h3. 0.1.2

* Fixed https-connection bug.

h3. 0.1.1

* Support basic-authentication and https-connection.

h3. 0.1.0

* First release

h2. Contact info

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

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