Project

General

Profile

Hudson En » History » Version 14

Toshiyuki Ando, 02/20/2010 12:59 AM

1 1 Toshiyuki Ando
h1. Hudson Plugin
2
3 7 Toshiyuki Ando
{{>toc}}
4
5 1 Toshiyuki Ando
h2. How to get
6
7 13 Toshiyuki Ando
Latest version is 1.0.2
8 1 Toshiyuki Ando
9
* "repository":http://r-labs.googlecode.com/svn/trunk/plugins/redmine_hudson/
10 13 Toshiyuki Ando
* "download":http://r-labs.googlecode.com/files/redmine_hudson-1.0.2.zip
11 1 Toshiyuki Ando
12
h2. What's hudson?
13
14
Huson is application for Continuous Integration.
15
Easy install configuration, and good ui.
16
17
More detail "Meet Hudson":http://wiki.hudson-ci.org/display/HUDSON/Meet+Hudson
18
19
h2. Features
20
21
h3. Show Job List
22
23
* Name, Description, Latest Build ( Build number, Result, Date ) and health report.
24 11 Toshiyuki Ando
* You can find jobs built today.
25 10 Toshiyuki Ando
* You can change description visibility dynamically.
26 1 Toshiyuki Ando
* Provide a link to Hudson, if plugin found keyword in Health Report.
27 10 Toshiyuki Ando
* Bulid number linked to build result page.
28 13 Toshiyuki Ando
* Download artifacts.
29 1 Toshiyuki Ando
* Click clock-icon, request hudson to build.
30 10 Toshiyuki Ando
* Mr. hudson appears. ( sorry, not emotional )
31 1 Toshiyuki Ando
32 13 Toshiyuki Ando
!redmine_hudson_index_1_0_2_en_small.png!
33 1 Toshiyuki Ando
34
h3. Show Build History
35
36
click note icon, show build history
37
38 10 Toshiyuki Ando
* build number, result, date.
39
* Bulid number linked to build result page.
40
* Console icon linked to console page.
41 1 Toshiyuki Ando
42
h3. Show build history on activity.
43
44 10 Toshiyuki Ando
* jobname, build number, test-result(only number of items) and changesets.
45 1 Toshiyuki Ando
46
!redmine_hudson_show_build_history_on_activity.png!
47
48
h3. Show build result on issue.
49 8 Toshiyuki Ando
50 1 Toshiyuki Ando
* job-name, build-number, result and built date and time. when Hudson builds revisions associated issues.
51
52
!redmine_hudson_show_build_result_on_issue.png!
53
54 13 Toshiyuki Ando
h3. Search issues related particular build
55
56
You can search issues related job and build using filter.
57
Plugin chases issues by taking following step.
58
 Hudson Job -> Hudson Build -> Related Changeset -> Revision -> Issue
59
Hudson Build and Related Changeset are too much, so plugin limits number of Builds and Changesets per each Hudson Job.
60
You can change limit settings on settings/plugin/redmine_hudson.
61
62 10 Toshiyuki Ando
h3. rake task 'redmine_hudson:fetch'
63 1 Toshiyuki Ando
64 10 Toshiyuki Ando
You can get build results using rake task 'redmine_hudson:fetch'.
65 1 Toshiyuki Ando
If you use rake task, please uncheck 'AutoFetch' setting.
66
You can change 'AutoFetch' setting on settings/plugin/redmine_hudson.
67
68 13 Toshiyuki Ando
h3. Clean up stored data
69
70
You can delete old data ( builds, changesets, test results ).
71
Settings are like Hudson.
72
73
* rotate days ( 1day = keep today's data )
74
* rotate nums
75
76 10 Toshiyuki Ando
h3. Settings for each projects
77 6 Toshiyuki Ando
78 10 Toshiyuki Ando
* Hudson url (can use https)
79 1 Toshiyuki Ando
* auth user, password ( 0.1.1 higher )
80 10 Toshiyuki Ando
* can stop plugin getting test results and changesets. (Getting test results and changesets needs a good amount of time.)
81 1 Toshiyuki Ando
* choose job
82 10 Toshiyuki Ando
* compact mode ( show only job name and latest build)
83 1 Toshiyuki Ando
* keyword and url for health report
84
85 13 Toshiyuki Ando
!redmine_hudson_settings_1_0_2_en_small.png!
86 10 Toshiyuki Ando
87
h3. Settings for plugins (all projects)
88
89 1 Toshiyuki Ando
Go  Administration -> Plugins -> 'Redmine Hudson Plugin' Configure.
90
91
* You can choose format to write job description. HTML or Textile.
92 10 Toshiyuki Ando
* AutoFetch Mode. Plugin fetches information from Hudson during action 'index'.
93 13 Toshiyuki Ando
* Number of Builds per each Hudson Job. ( for search issues )
94
* Number of Changesets per each Hudson Job. ( for search issues )
95 10 Toshiyuki Ando
96 13 Toshiyuki Ando
!redmine_hudson_global_settings_1_0_2_en.png!
97 10 Toshiyuki Ando
98 14 Toshiyuki Ando
h2. Support Language
99 1 Toshiyuki Ando
100
* Japanese
101
* English
102
* Deutsch
103 3 Toshiyuki Ando
Thanks! "Jens Goldhammer":http://www.redmine.org/account/show/4080 , "Florian Bartels":http://www.redmine.org/account/show/6169 
104
* Magyar
105 1 Toshiyuki Ando
Thanks! "Péter Major":http://www.redmine.org/account/show/6179
106
* Spanish
107
Thanks! juancayetano.delgado
108 11 Toshiyuki Ando
109
h2. Install Instructions
110
111
h3. Install plugin
112
113
# Copy the plugin into the vendor/plugins directory
114
# Migrate plugin: rake db:migrate_plugins RAILS_ENV=production
115
# Start Redmine
116
117
h3. Enable plugin on project
118
119
# Move to Project settings
120
# Click 'Modules'
121
# Check the box 'Hudson', and save.
122
123
h3. Edit Hudson settings
124
125
# Click 'Hudson' tab on the menu
126
# Click 'Settings' in sidebar
127
# Edit settings ( url, job... )
128
129
h3. View jobs
130
131
# Click 'Hudson' tab on the menu (In first time, it takes long time)
132 1 Toshiyuki Ando
133 10 Toshiyuki Ando
h2. Important reminder 
134 6 Toshiyuki Ando
135 10 Toshiyuki Ando
h3. Hudson
136
137 6 Toshiyuki Ando
Recommend Hudson 1.313
138
If you use old version of Hudson, plugin may not get test results and changesets.
139
Plugin store build information, if plugin can't get test results or changesets.
140
But, If plugin fail, never get test results, changesets again.
141
142 10 Toshiyuki Ando
h3. Using IE8
143
144
Please use Compatibility View in IE8.
145
146
h3. Exclusive Control
147
148 6 Toshiyuki Ando
Plugin has no exclusive control, so plugin doesn't work when redmine works on multi-process.
149 10 Toshiyuki Ando
Hopefully i fix it.
150 1 Toshiyuki Ando
151
h3. Something is wrong with plugin
152
153
you should try to delete data from database.
154
Use 'delete history' button in setting page.
155 13 Toshiyuki Ando
156
h2. Changelog
157
158
h3. 1.0.2
159
160
* ##198 (Feature) You can download artifacts.
161
* ##266 (Feature) Clean up stored data.
162
* ##267 (Feature) Search issues related particular build.
163
* ##235 (Defect) Hudson icon does not display in activitiy view with IE
164
* ##273 (Defect) Internal error occures when hudson has no response.
165
* ##276 (Defect) Translation missing occures on redmine0.9.x or trunk
166
* ##284 (Defect) When saving the settings for a project, get the exception.
167
* ##286 (Defect) Can't get changeset information.
168
* ##288 (Defect) Can't show build results on issue redmine0.9.x or trunk
169
* ##291 (Defect) db:migrate_plugins failed on PostgreSQL
170
171
h3. 1.0.1.1
172
173
* ##244 "rake db:migrate_plugins" doesn't work without rcov
174
* ##242 Build job and Build history doesn't work on Redmine 0.8.7
175
176
h3. 1.0.1
177
178
* ##228 Install Instructions
179
* ##225 You never can check off 'Show Compact'
180
* ##224 You can find jobs built today
181
* ##219 Can't get RSS on activity page, when check 'Hudson' box
182
* ##218 Anonymous can't see acitivity
183
* ##212 Plugin can't show latest build result
184
185
h3. 1.0.0
186
187
* You can get build results using rake task 'redmine_hudson:fetch'
188
* Choose format to write job description HTML or Textile
189
* You can also change description visibility dynamically
190
191
h3. 0.1.6
192
193
* Health report settings comes in useful.
194
195
h3. 0.1.5
196
197
* Show build result on issue. Use Hudson icons.
198
199
h3. 0.1.4
200
201
* Show build history on activity. Save infomation on database.
202
203
h3. 0.1.3
204
205
* Fixed BasicAuth bug.
206
207
h3. 0.1.2
208
209
* Fixed https-connection bug.
210
211
h3. 0.1.1
212
213
* Support basic-authentication and https-connection.
214
215
h3. 0.1.0
216
217
* First release
218
219
h2. Contact info
220
221
* Website  -> r-labs[http://www.r-labs.org/]
222
* Email    -> couger@kt.rim.or.jp