= Hudson Trac Integration Plugin = == Description == Integrate [https://hudson.dev.java.net/ 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 [http://dev.rectang.com/projects/continutrac Trac Continuum] plugin. The build results are obtained from the Hudson remote API. == Configuration == 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 under `hudson`): job_url:: 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). username:: The username to use when accessing hudson; leave empty if no authentication is needed. password:: The password to use when accessing hudson; leave empty if no authentication is needed. display_modules:: If set to `true` then display the builds of individual modules in the timeline too; otherwise only builds of jobs are displayed. main_page:: The url of the hudson page to link to from the trac mainnav; if empty, no entry is created in the mainnav. Example: `/hudson/` display_in_new_tab:: 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. alternate_success_icon:: Display a green ball instead of the standard blue one for successful builds. display_build_descriptions:: Whether to display the build descriptions for each build instead of the canned "Build finished successfully" etc messages. Furthermore, 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 [query:status!=closed&component=HudsonTracPlugin&order=priority here]. If you have any issues, create a [/newticket?component=HudsonTracPlugin&owner=roadrunner new ticket]. == Download and Source == Download the [download:hudsontracplugin zipped source], check out [/svn/hudsontracplugin using Subversion], or [source:hudsontracplugin 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 [http://www.feedparser.org/ python-feedparser] library is no longer required. == Recent Changes == [[ChangeLog(hudsontracplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:roadrunner] [[BR]] '''Contributors:'''