[[PageOutline(2-5,Contents,pullout)]] = Teamcity integration plugin = == Description == This is an integration plugin for Continuous Integration and Build Server [http://www.jetbrains.com/teamcity/ Teamcity]. == Bugs/Feature Requests == Existing bugs and feature requests for TeamcityPluginIntegration are [report:9?COMPONENT=TeamcityPluginIntegration here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=TeamcityPluginIntegration&owner=siniy new ticket]. == Download == Download the zipped source from [download:teamcitypluginintegration here]. == Source == You can check out TeamcityPluginIntegration from [http://trac-hacks.org/svn/teamcitypluginintegration here] using Subversion, or [source:teamcitypluginintegration browse the source] with Trac. == Example == This plugin provides 'build' events from Teamcity server to Trac timeline and creates control buttons and progressbars for selected teamcity builds. == Installation == 1. Install the `lxml` package (`sudo apt-get install python-lxml` on Ubuntu). 1. Add a special user in you teamcity installation for this Trac plugin 1. Get latest version from svn: {{{ #!sh svn co http://trac-hacks.org/svn/teamcitypluginintegration }}} 1. Build egg-file and put it to Trac plugins dir: {{{ #!sh python setup.py bdist_egg cp dist/TeamCityPlugin-X.X-pyX.X.egg /path/to/trac/instance/plugins/ }}} 1. Edit Trac config.ini, enable plugin: {{{ #!ini [components] teamcity.* = enabled }}} 1. Add permissions to users allowed to build and/or configure plugin. There are two trac permissions: TEAMCITY_BUILD (allows to view /trac-instance/builds page and run builds) and TEAMCITY_ADMIN (allows to edit plugin settings). {{{ #!sh trac-admin /path/to/trac/instance permission add authenticated TEAMCITY_BUILD }}} 1. Edit plugin settings. All plugin settings are stored in config.ini, so you can add a new section to config.ini or go to trac-instance/admin/teamcity/builds and fill the web-form. Settings: {{{ #!ini [teamcity] base_url = http://: # base url to TC server, WITHOUT trailing slash username = trac password = trac1 # TC credentials which plugin will use to access TC server cache_dir = /tmp/teamcity_cache # Plugin will cache here build logs from teamcity builds = bt1,bt2 # a list of buildTypeId from TC to follow limit = 10080 # Number of minutes for timeline. # Plugin will add events to timeline for builds which are newer then now()-limit }}} All of described settings you can add to Trac config.ini directly or via admin iface. == Recent Changes == [[ChangeLog(teamcitypluginintegration, 3)]] == Author/Contributors == '''Author:''' [wiki:siniy] [[BR]] '''Maintainer:''' [wiki:siniy] [[BR]] '''License:''' [http://en.wikipedia.org/wiki/Public_Domain Public Domain]