refer to this site --> this is very good solution about
the SVN and Mantis

http://www.ichiayi.com/wikipage/tech/svnmantis

Subversion 與 Mantis 整合作法 [蔡宗融個人網站]

This is refer to this site :
http://www.ichiayi.com/wiki/tech/
蔡宗融先生的網站資料，
十分感謝蔡先生所細心留下的記錄資料，(SVN,Mastis,ViewCVS這三篇)
均是對於軟體管理工程上有莫大助益的實用方法。

Subversion 與 Mantis 整合作法

1 目標

當 Mantis 有張貼一個新的 Issue 時,

與這個 Issue 相關的 Subversion 更動紀錄

可以自動回寫至 Mantis 這個 Issue 內的 Bug 筆記內.

要達成這個目標，

主要是撰寫一個 svn2mantis.pl

整合 Subversion 內的 hook 與 Mantis 內的 checkin.php 來達成，

可參考以下概念圖:

SVN client commit
-->SVN Server & svn hook
-->SVN2Mantis.pl
-->Mantis Server & checkin.php --> DB store

2 相關環境

Mantis 與 Subversion 都安裝在相同的主機上或 Subversion 主機可以透過 ssh 不需輸入密碼方式登入 Mantis 主機
Mantis 版本為 1.0.7 安裝在 /var/www/html/mantis
Subversion 版本為 1.4.3-1

3 設定程序

3.1 Mantis 建立特殊整合 user

建立 svnbot 這個特殊的 userid
存取權限設定為開發者 (如果有多個專案, 每個專案都要授與 svnbot 這個權限)

3.2 設定 Mantis 的參數檔

vi /var/www/html/mantis/config_inc.php

:
:
      #Source Control
      $g_source_control_account = 'svnbot';
      $g_source_control_regexp = '/\b(?:bug|issue|mantis)\s*[#]{0,1}(\d+)\b/i';
      $g_source_control_set_status_to = RESOLVED;
      $g_source_control_set_resolution_to = FIXED;
      $g_source_control_fixed_regexp = '/\bfix(?:ed|es)\s+(?:bug|issue|mantis)?\s*[#]{0,1}(\d+)\b/i';
:

設定 svnbot 為這個整合的 mantis 內特殊 user
只要 SubVersion 內的紀錄出現 bug 或 issue 或 mantis #編號表示整合 Mantis 內的 Issue # Bug 筆記
只要 SubVersion 內的紀錄出現 fixed 或 fixes + bug 或 issue 或 mantis #編號表示整合 Mantis 內的 Issue # Bug 筆記外, 更會將 issue 狀態改成已修正解決

3.3 測試整合 Mantis

直接執行以下的命令, 可以在 mantis 內的 Issue#2 新增 Bug 筆記

php /var/www/html/mantis/core/checkin.php <<< "Test issue #2 by svnbot."

直接執行以下的命令, 可以在 mantis 內的 Issue#2 新增 Bug 筆記以及將問題狀態更改為以解決

php /var/www/html/mantis/core/checkin.php <<< "Test fixed issue #2 by svnbot."

如果這個步驟沒有正確在 Mantis 內出現新增的 Bug 筆記, 可能是這個專案並沒有給 svnbot 這個特殊使用者權限

3.4 Mantis 與 SVN 安裝在相同主機

3.4.1 寫一段整合 Mantis 的 script

vi /var/www/svn2mantis.pl

 1: #!/usr/bin/perl
 2: #
 3: # 上午 11:15 2007年6月22日
 4: # Jonathan Tsai
 5: # Ver 1.10
 6: #
 7: # 自動將 svn 訊息寫入 mantis 紀錄內
 8: #
 9: # 參考 http://www.ichiayi.com/trywiki/tech/svnmantis 的說明方式
10: # 本 script 需配合:
11: #  1. /var/www/svn/xxxrepos/hooks/post-commit 一起使用
12: #  2.apache user 可使用 ssh 免密碼登入 Mantis 主機 <- SVN 主機與 Mantis 主機不同時需要
13: #
14: # 1.00 (2007/3/26) 第一版啟用
15: # 1.01 (2007/3/26) 增加 commit 後自動整合的說明
16: # 1.10 (2007/6/22) 增加 遠端登入 Mantis 主機功能設定
17: #
18:
19: $prgname = substr($0, rindex($0,"/")+1);
20: $ver = "1.10 (2007/6/22)";
21: # $sshcmd 設為空字串表示 SVN 與 Mantis 安裝在相同主機
22: $sshcmd = "";
23: # 否則應該輸入由 svn 主機免密碼登入 Mantis 主機的命令列
24: #$sshcmd = "/usr/bin/ssh jonathan@10.10.10.96";
25:
26: # 讀取參數資料
27: $REPOS=$ARGV[0];
28: $REV=$ARGV[1];
29:
30: # 定義外部指令
31: $svnlook = "export LANG=zh_TW.UTF-8;/usr/bin/svnlook";
32: $phpcmd = "/usr/bin/php";
33: $checkincmd = "/var/www/html/mantis/core/checkin.php";
34:
35: # 取得 svn 相關資訊
36: $auth=`$svnlook author -r $REV $REPOS`;
37: $dt=`$svnlook date -r $REV $REPOS`;
38: $changed=`$svnlook changed -r $REV $REPOS`;
39: $log=`$svnlook log -r $REV $REPOS`;
40: $msg="Changeset [".$REV."] by $auth\n$dt\n$log\n$changed";
41:
42: # 傳送至 mantis
43: if (length($sshcmd)>0) {
44:  `$sshcmd $phpcmd -q $checkincmd <<< "$msg"`;
45: }
46: else {
47:  `$phpcmd -q $checkincmd <<< "$msg"`;
48: }

3.4.2 測試執行 script

假設 servercfg 的 svn 存放在 /var/www/svn/servercfg
假設 servercfg 的 Reversion 644 訊息內容有出現 mantis #2 ← 表示整合至 Mantis Issue #2

chmod a+x /var/www/svn2mantis.pl
/var/www/svn2mantis.pl /var/www/svn/servercfg 644

這樣就可以看到 Mantis Issue #2 內新增一個 Bug 筆記, 內容如下:

Changeset [644] by jonathan

2007-03-26 11:29:55 +0800 (一, 26 3月 2007)

將 svnlook 命令前加入 LANG=zh_TW.UTF-8 來測試整合 mantis 中文訊息問題.

mantis#2

U PD-920/var/www/svn2mantis.pl

3.4.3 設定 SVN Commit 後自動執行 svn2mantis.pl

如果有多個 svn repos 就在每個 repos 內依照這步驟一一執行, 以下還是以 servercfg 的 svn repos 為例

cd /var/www/svn/servercfg cd hooks

vi post-commit

1: #!/bin/sh
2:
3: REPOS="$1"
4: REV="$2"
5:
6: /var/www/svn2mantis.pl "$REPOS" "$REV"

chown apache:apache post-commit
chmod a+x post-commit
這樣一但 commit 後, 會馬上執行這個 post-commit 的 shell script,
來執行 svn2mantis.pl 將 SVN 內的紀錄內容整合到 Mantis 的 Issue Bug 筆記內.

3.5 Mantis 與 SVN 在不同主機

3.5.1 設定在 SVN 主機可以不用密碼登入 Mantis 主機

SVN Server : 10.10.10.91
Mantis Server : 10.10.10.96
假設 svn server 是與 httpd 整合, 透過 apache 執行
先設定 SVN 主機內的 jonathan 帳號可以不用密碼以相同帳號登入 Mantis 主機
再設定 SVN 主機內的 apache 帳號可以不用密碼以 jonathan 帳號登入 Mantis 主機

3.5.1.1 SVN 主機

在 /home/jonathan/.ssh 內產生憑證與公鑰
將公鑰複製到 Mantis 主機內改命名為 10.10.10.91_authorized_keys2

su - jonathan
ssh 10.10.10.96 <- 輸入密碼確認可以登入 exit <- 回到 svn 主機 cd .ssh ssh-keygen -d <- 產生 id_dsa.pub (詢問時均 Enter 跳下不輸入任何字元) scp id_dsa.pub 10.10.10.96:/home/jonathan/.ssh/10.10.10.91_authorized_keys2

3.5.1.2 Mantis 主機

將 SVN 主機公鑰加入認證公鑰清單檔內
將認證公鑰清單檔權限設為只有自己可以讀寫

su - jonathan
cd .ssh
cat 10.10.10.91_authorized_keys2 >> authorized_keys2
chmod 600 authorized_keys2

3.5.1.3 測試由 SVN 主機免密碼登入 Mantis 主機

先使用 jonathan 帳號登入 SVN 主機
執行 ssh 10.10.10.96 就可以發現不需要密碼就可登入 Mantis 主機

[jonathan@eddev ~]$ ssh jonathan@10.10.10.96
Last login: Fri Jun 22 10:14:40 2007 from 10.10.10.91
[jonathan@tryboxap04 ~]$

3.5.1.4 設定 SVN 主機內的 apache 免密碼登入 Mantis 主機

登入 SVN 主機, 切換成 root
將上面設定的 /home/jonathan/.ssh 目錄複製到 /var/www 內就可以

su -
cd /var/www
cp -a ~jonathan/.ssh .
chown -R apache:apache .ssh

3.5.2 寫一段整合遠端 Mantis 的 script

vi /var/www/svn2mantis.pl

7: # 自動將 svn 訊息寫入 mantis 紀錄內
 8: #
 9: # 參考 http://www.ichiayi.com/trywiki/tech/svnmantis 的說明方式
10: # 本 script 需配合:
11: #  1. /var/www/svn/xxxrepos/hooks/post-commit 一起使用
12: #  2.apache user 可使用 ssh 免密碼登入 Mantis 主機 <- SVN 主機與 Mantis 主機不同時需要
13: #
14: # 1.00 (2007/3/26) 第一版啟用
15: # 1.01 (2007/3/26) 增加 commit 後自動整合的說明
16: # 1.10 (2007/6/22) 增加 遠端登入 Mantis 主機功能設定
17: #
18:
19: $prgname = substr($0, rindex($0,"/")+1);
20: $ver = "1.10 (2007/6/22)";
21: # $sshcmd 設為空字串表示 SVN 與 Mantis 安裝在相同主機
22: #$sshcmd = "";
23: # 否則應該輸入由 svn 主機免密碼登入 Mantis 主機的命令列
24: $sshcmd = "/usr/bin/ssh jonathan@10.10.10.96";
25:
26: # 讀取參數資料
27: $REPOS=$ARGV[0];
28: $REV=$ARGV[1];
29:
30: # 定義外部指令
31: $svnlook = "export LANG=zh_TW.UTF-8;/usr/bin/svnlook";
32: $phpcmd = "/usr/bin/php";
33: $checkincmd = "/var/www/html/mantis/core/checkin.php";
34:
35: # 取得 svn 相關資訊
36: $auth=`$svnlook author -r $REV $REPOS`;
37: $dt=`$svnlook date -r $REV $REPOS`;
38: $changed=`$svnlook changed -r $REV $REPOS`;
39: $log=`$svnlook log -r $REV $REPOS`;
40: $msg="Changeset [".$REV."] by $auth\n$dt\n$log\n$changed";
41:
42: # 傳送至 mantis
43: if (length($sshcmd)>0) {
44:  `$sshcmd $phpcmd -q $checkincmd <<< "$msg"`;
45: }
46: else {
47:  `$phpcmd -q $checkincmd <<< "$msg"`;
48: }

3.5.3 測試執行 script

假設 moeaprj 的 svn 存放在 /var/www/svn/moeaprj
假設 moeaprj 的 Reversion 1700 訊息內容有出現 mantis #516 ← 表示整合至 Mantis Issue #516

 chmod a+x /var/www/svn2mantis.pl
/var/www/svn2mantis.pl /var/www/svn/moeaprj 1700


這樣就可以看到 Mantis Issue #516 內新增一個 Bug 筆記, 內容如下:

Changeset [1700] by chou

2007-06-20 12:09:04 +0800 (三, 20 6月 2007)

更改發文查詢的本文含附件列印 mantis#516

U EDOC2/Source/docsrv_html/inc/templates/edrecvquery_2.inc.htm

3.5.4 設定 SVN Commit 後自動執行 svn2mantis.pl


如果有多個 svn repos 就在每個 repos 內依照這步驟一一執行, 以下還是以 moeaprj 的 svn repos 為例
cd /var/www/svn/moeaprj
cd hooks

vi post-commit
1: #!/bin/sh
2:
3: REPOS="$1"
4: REV="$2"
5:
6: /var/www/svn2mantis.pl "$REPOS" "$REV"

chown apache:apache post-commit
chmod a+x post-commit

這樣一但 commit 後, 會馬上執行這個 post-commit 的 shell script, 來執行 svn2mantis.pl 將 SVN 內的紀錄內容整合到 Mantis 的 Issue Bug 筆記內.

Hsieh-Vic-Blog

2008年2月17日星期日