Version 13 (modified by roadrunner, 6 years ago) (diff)

Trying with image name with underscores instead of camelcase

Hudson Trac Integration Plugin


Integrate Hudson build results into the Trac timeline and (optionally) provide a navbar menu to link to the Hudson instance.

This plugin works very similar to the LuntbuildTracIntegration plugin and the Trac Continuum plugin. The build results are obtained from the Hudson remote API.

Screenshot of timeline with a couple hudson builds, the "Hudson Builds" checkbox, and the "Builds" menu item


As with all plugins, you must enable it explicitly, either via Trac's UI (Admin -> General -> Plugins) or by directly editing the trac.ini:

hudsontrac.* = enabled

There are 8 options you can configure in your trac.ini under the section [hudson] (if you have the IniAdminPlugin installed they will show up on the Trac Admin page under hudson):

The url of the top-level hudson page if you want to display all jobs in the timeline, or a job or module url if you want only display builds from a single job or module. Examples: http://localhost/hudson/ (for builds from all jobs), http://localhost/hudson/job/build_foo/ (for builds from the build_foo job only). The default is http://localhost/hudson/.
The username to use when accessing hudson; leave empty if no authentication is needed. Default is empty.
The password to use when accessing hudson; leave empty if no authentication is needed. Default is empty.
If set to true then display the builds of individual modules in the timeline too; otherwise only builds of jobs are displayed. Default is false.
The url of the hudson page to link to from the trac mainnav; if empty, no entry is created in the mainnav. Example: /hudson/. The default is /hudson/.
If set to true then open the above hudson page in a new tab (or window) instead of in the current tab/window. Not used if main_page is not set. Default is false.
Display a green ball instead of the standard blue one for successful builds. Default is false.
Whether to display the build descriptions for each build instead of the canned "Build finished successfully" etc messages. Default is true.

Example trac.ini (not necessary if using the defaults):

job_url = http://localhost/hudson/job/build_foo/
main_page = /hudson/job/build_foo/
alternate_success_icon = true

Lastly, make sure you assign users the BUILD_VIEW permission in order for them to be able to see the builds in the timeline.

Bugs/Feature Requests

Existing bugs and feature requests for HudsonTracPlugin are here.

If you have any issues, create a new ticket.

Download and Source

Download the [download:hudsontracplugin zipped source], check out using Subversion, or browse the source with Trac.

Upgrade Notes

If you are upgrading from version 0.2 of this plugin (pre r6683) then you will need to make the following changes:

  • the feed_url option has been replaced by the job_url option; the latter points to the top-level hudson page or to a job page, not an RSS feed anymore.
  • the display_subprojects has been renamed display_modules
  • you must assign users the BUILD_VIEW permission in order for them to see the builds
  • The python-feedparser library is no longer required.

Recent Changes

14253 by rjollos on 2014-11-12 08:22:59
Removed print statement.
14252 by rjollos on 2014-11-12 08:12:51
Fixed error in [14251]. Remove target attribute when display_in_new_tab is False. Refs #12036.
14251 by rjollos on 2014-11-12 08:01:31
Return an instance of the Element class from get_navigation_items to support modifying the item through Trac's [mainnav] section. Fixes #12036.


Author: roadrunner

Attachments (5)

Download all attachments as: .zip