禪道于2.2版本內(nèi)置了svn集成功能，把禪道和用戶代碼進行有效關聯(lián)，方便用戶查看。這篇文章將給大家講述如何配置禪道集成svn。
相關下載：禪道2.2官方源代碼
一、subversion集成機制說明
subversion集成的基本機制是：分析提交代碼時的注釋 => 得出相應的story, task, bugID => 寫入到禪道的數(shù)據(jù)庫。
實現(xiàn)上述功能有兩個方案，一個方案是采用svn自帶的鉤子機制，當有代碼提交的時候，觸發(fā)一個鉤子腳本，然后分析注釋，得出相應的bug, story或者task的id號，然后調(diào)用禪道的api，將相關的記錄寫入數(shù)據(jù)庫。還有一個方案是通過svn客戶端軟件的log命令，來獲得所有的提交記錄，然后分析，得出相應的id，寫入數(shù)據(jù)庫。
上述兩個方案各有各自的優(yōu)缺點，我們最終是選擇了第二個方案。因為第二個方案調(diào)試比較好調(diào)試，部署也相對方便，同時可以解析之前的所有記錄，有比較好的靈活性。
二、在禪道所在機器上面部署svn命令行客戶端。
svn命令行客戶端是指subversion自帶的svn命令。windows下面是svn.exe，linux下面是沒有后綴的svn。
禪道所在的機器可以和subversion機器分開，不在一臺機器上面。
- 如果是linux機器，需要安裝svn的客戶端。rhel,centos可以用yum安裝subversion, debian下面可以用apt-get install.
- 如果最新下載的windows一鍵安裝包2.2版本，里面已經(jīng)內(nèi)置了svn.exe的客戶端。
- 如果是之前版本的一鍵安裝包，可以下載上文所說的svn客戶端包。解壓縮到zentao的目錄。在usr/local/下面可以找到silksvn就對了
- 如果在windows下面自己安裝，可以考慮下載silksvn的客戶端軟件，安裝。
三、配置禪道關于subversion的參數(shù)
3.1 代碼位置
1、一鍵安裝包：zentao/home/zentao/module/svn/config.php
2、源碼包：zentao包位置/module/svn/config.php
注意，您可以直接修改上述的config.php文件，但建議您將改動保存到svn/ext/config/svn.php中。這樣將來我們升級，就不會覆蓋您的配置文件。
3.2 配置內(nèi)容
關于subversion參數(shù)的設置，一共有下面幾個概念：
1. svn客戶端命令的位置。
2. 庫(repo): 可以配置多個庫。
3. 庫的用戶名和參數(shù)。
下面讓我們用實際的例子來說明。
3.2.1 如下圖，找到圖中紅框標志的位置
3.2.2 修改代碼
寫法如下面例子所示
$config->svn->client 這個是用來存儲svn客戶端執(zhí)行文件svn.exe路徑的，源碼包用戶需自行下載svn客戶端（也可下載svn包，解壓后 upgrade\usr\local 目錄下 silksvn 文件夾為svn客戶端，將其部署到禪道所在環(huán)境中）；
$config->svn->repos[$i]['path'] 這個是用來存儲svn代碼路徑的；
$config->svn->repos[$i]['username'] 這個是用來存儲svn登錄用戶名的； 如果不需要登錄，可以保持為空。
$config->svn->repos[$i]['password'] 這個是用來存儲svn登錄密碼的。
3.3 配置多個庫
3.3.1 同上，在同一個文件里找到如下代碼
3.3.2 修改代碼
①將代碼中的“/*”和”*/“刪除，其余修改同上，注意：$i ++ 不可修改。
②如果還有svn庫，復制此段代碼，進行同樣的配置即可。
四、代碼提交注釋格式：
開發(fā)者在提交svn的時候，需要在備注里面注明此次修改相關的需求，或者任務，或者bug的id。比如下面的格式：
bug#123,234, 1234，也可以是bug:123,234 1234，id列表之間，用逗號和空格都可以。
story#123 task#123
bug, story, task是必須標注的。:)
五. 執(zhí)行svn同步命令
5.1 通用的執(zhí)行方式
5.1.1 打開命令行，進入zentao目錄的bin目錄。windows的一鍵安裝包是在home/zentao/bin目錄下面 。
5.1.2 執(zhí)行php ztcli http://禪道的訪問路徑/svn-run.html 或者 ?m=svn&f=svn 這里面的訪問路徑根據(jù)實際的進行修改。比如：
php ztcli http://pms.zentao.net/svn-run.html PATH_INFO方式。
php ztcli http://pms.zentao.net/?m=svn&f=run GET方式。
這其中的php，需要換成php或者php.exe所在的路徑。
5.2 一鍵安裝包
windows一鍵安裝包版本我們做了一些方便的修改，可以在bin目錄下面，直接執(zhí)行syncsvn.bat命令即可。(2.2版本內(nèi)置，之前的一鍵安裝包需要下載我們的svn客戶端包)
5.3 程序運行的效果圖:
5.4 查看相應的bug:
六、部署定時任務
上述命令部署好之后，將該命令加入定時任務就好了。比如可以5分鐘執(zhí)行一次。
windows下面使用計劃任務，linux下面使用crontab。
主要注意的是，在部署計劃任務的時候，svn同步命令需要在bin目錄下面。因此需要先cd到bin所在的目錄。比如
cd c:/zentao/home/zentao/bin; syncsvn.bat
cd /home/www/zentao/bin; php ztcli http://xxxx/svn-run.html