| 29 | == Installation == |
| 30 | |
| 31 | 0. Add special user in you teamcity installation for this Trac plugin |
| 32 | 1. Get latest version from svn: |
| 33 | {{{ |
| 34 | svn co http://trac-hacks.org/svn/teamcitypluginintegration |
| 35 | }}} |
| 36 | 2. Build egg-file and put it to Trac plugins dir: |
| 37 | {{{ |
| 38 | python setup.py bdist_egg |
| 39 | cp dist/TeamCityPlugin-X.X-pyX.X.egg /path/to/trac/instance/plugins/ |
| 40 | }}} |
| 41 | 3. Edit Trac config.ini, enable plugin: |
| 42 | {{{ |
| 43 | [components] |
| 44 | teamcity.* = enabled |
| 45 | }}} |
| 46 | 4. Add permissions to users allowed to build and/or configure plugin. There are two trac permissions: |
| 47 | TEAMCITY_BUILD (allows to view /trac-instance/builds page and run builds) and TEAMCITY_ADMIN (allows to edit plugin settings). |
| 48 | from console: |
| 49 | {{{ |
| 50 | trac-admin /path/to/trac/instance permission add authenticated TEAMCITY_BUILD |
| 51 | }}} |
| 52 | 5. Edit plugin settings. |
| 53 | All plugin settings are stored in config.ini, so you can add a new section to |
| 54 | config.ini or go to trac-instance/admin/ and edit them via admin interface. |
| 55 | |
| 56 | Settings: |
| 57 | {{{ |
| 58 | [teamcity] |
| 59 | base_url = http://<you_ci_server>:<port> # base url to TC server, WITHOUT trailing slash |
| 60 | username = trac |
| 61 | password = trac1 # TC credentials which plugin will use to access TC server |
| 62 | cache_dir = /tmp/teamcity_cache # Plugin will cache here build logs from teamcity |
| 63 | builds = bt1,bt2 # a list of buildTypeId from TC to follow |
| 64 | limit = 10080 # Number of minutes for timeline. |
| 65 | # Plugin will add events to timeline for builds which are newer then now()-limit |
| 66 | }}} |
| 67 | All of described settings you can add to Trac config.ini directly or via admin iface. |
| 68 | |