Integrate With Trac

Version 10 by Steve Luo
on Jun 05, 2010 20:38.


compared with
Version 11 by Steve Luo
on Jun 05, 2010 20:46.


Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 3 changes. View first change.

 The integration features:
 * Hyperlink the Trac ticket id in commit messages to corresponding JIRA pages
 * Generate an issues report from commit messages
 * Progress/update the issues from commit messages
 * Release a milestone of a project in Trac
 * Create an issue to Trac based on a customized step condition
  
 This page will describe how to integrate Trac in QuickBuild.
  
 *On This Page*
  
 {toc:class=pagetoc|style=disc|indent=20px|maxLevel=3}
  
 {info}
 Supported Trac version should be 0.11 or higher.
 {info}
  
 h3. Simple Integration
 To enable the integration:
  
 # *Install and enable XML RPC plugin for Trac.* This plugin and its installation guide can be found at below link:
  http://trac-hacks.org/wiki/XmlRpcPlugin
 # *Configure Trac Server on configuration settings tab.*
  !trac-settings.png!
  Below lists the descriptions of these properties:
  ||Property||Description||
  |Server URL|Defines the server url. you can test it by adding "/rpc", for example, if the server url is: http://localhost/trac/project, open below url in your browser: http://localhost/trac/project/rpc, and if the "Remote Procedure Call (RPC)" page can be displayed correctly, the url is correct. |
  |User Name|The user should have TICKET_VIEW permission. If you want to update issues from QuickBuild, the user should also have TICKET_MODIFY permission.|
  |Ticket Pattern|Defines the ticket pattern which will be used to extract the ticket id from commit messages. The ticket pattern here uses [Java regular expression|http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html] to match the ticket ids. By default, below pattern will match #123 or ticket:123.
  {code}
  (?<!\:)(?:#|ticket:)\d+
  {code}
  |
  
 That is it! Now, QuickBuild can hyperlink the ticket in your commit messages:
  After doing these, the issues keys mentioned in commit messages will be hyperlinked:
  
 !changes.png!
  
and generate a ticket report in your build tab:
  and a ticket report will be displayed in Build tab:
  
 !issues.png!
  
 you can also find all related issues from a specified version and view the changes for an issue:
 !issues-history.png!
  
 After configured the Trac server in the configuration settings, below steps are available to add in your build workflow:
 * Update Issue Step
 * Release Version Step
 * Create Issue Step
  
 !trac-steps.png!