SVN与bugzilla整合

一、Linux下subversion安装配置

1、安装subversion及配置

建议用户以 root 身份登陆系统，进行安装配置

安装 subversion

系统共分为：
SubVersion ，从 [url]http://subversion.tigris.org/[/url] 下载，是实现服务系统的软件。

 

1） 安装 apache 服务器时所需的配置

./configure 时所需要增加的选项

�C prefix=/usr/local/apache

�C mandir=/usr/share/man

�Cenable-dav �Cenable-so

�C enable - dav �C fs

以便 svn 的安装及配置

然后输入 make & make install 进行安装

 

2） 安装 subversion

下载包 subversion- 1.4.6 .tar.gz

网址如下 :  [url]http://subversion.tigris.org/downloads/subversion-[/url] 1.4.6 .tar.gz

安装之前进行配置

./configure --with-apxs=/usr/local/apaceh/bin/apxs

         --prefix=/usr/local/subvertsion

         --with-apr=/usr/local/apache

         --with-apr-util=/usr/local/apache

  配置之后进行安装 ,#make install&install

 

3 ）建立新目录 /home/svn/repos , 作为 Repository 的主目录 . 使用创建工作区域 , 对该目录进行初始化
   #svnadmin create /home/svn/repos
该目录下产生版本控制需要的数据库结构。

 

4 ）创建 svn 服务器的工作根目录

 #svnserve -d �Cr /home/svn/repos

  就可以创建以 /home/svn/repos 为工作根目录的 svn 服务器。

 

5 ）检查服务是否正常

#ps �Cef | grep svnserve

如果显示 svn 登录信息，则启动 svn 服务器成功。

2、安装SVN+Apache

(1)首先，SVN模块加载上，修改Apache的配置文件httpd.conf：

LoadModule dav_svn_module /usr/local/apache/modules/mod_dav_svn.so

LoadModule authz_svn_module /usr/local/apache/modules/mod_authz_svn.so

 

然后配置仓库：

<Location "/home/svn/repos">
DAV svn
SVNParentPath /home

</Location>

 

然后，配置验证方式：

这里使用 Apache 的验证方式：

 

htpasswd -cm /home/svn/svn-auth-file [email protected]

然后，会提示输入密码，这里就加入了一个用户了。

 

然后修改配置：

<Location "/home/svn/repos">

 DAV svn

 SVNParentPath /home/svn

 AuthType Basic

 AuthName "Subversion repository"

 AuthUserFile /home/svn/svn-auth-file

 Require valid-user

 AuthzSVNAccessFile /home/svn/svn-access-file

</Location>

 

(2) 编辑 svn-access-file 文件

下面，就要写这个 svn-access-file 文件了，它是用来控制用户访问仓库的权限的，我们把说明写在后面

[repos:/]           // 这表示，仓库 repos 的根目录下的访问权限

[email protected]=rw        // repos 仓库 [email protected] 用户具有读和写权限

#[/]           // 这个表示在所有仓库的根目录下

#* = r           // 这个表示对所有的用户都具有读权限

#[groups]           // 这个表示群组设置

#repos-developers = [email protected],user1      // 这个表示某群组里的成员

#[repos:/]        

#@repos-developers = rw     // 如果在前面加上 @ 符号，则表示这是个群组权限设置

将这个设置完成后。重启 Apache ，就可以通过浏览器下进行浏览 [url]http://192.168.1.222/repos[/url]

(3) 连接到仓库的方法URL

[url]http://192.168.1.222/repos[/url]，采用了Apache 作为服务器的话就可以以这种形式访问，权限由Apache 设置。

svn://192.168.1.222/repos，采用了svnserve 作为服务器的话那么就可以采用这种形式访问，它是一种基于TCP/IP 的访问方式。权限由仓库的配置文件设置。

二、在svn中利用mod_auth_mysql使用bugzilla帐号

Svn 使用 apache 的权限机制 , 意味着为每一个用户创建用户号和密码 , 使用 htpasswd

配置 apache 使用 bugzilla 用户表格来鉴别用户 , 需使用 apache 模块 ”mod_auth_mysql”

 

Bugzilla 在 profiles 表中存储用户数据，用户 id 存在 login_name 列中，密码存在 cryptpassword 列中。密码使用命令 crypt 来加密，全随意创建一个密码。

Profiles 表格中还有一列名为 "disabledtext" ，如果这个域不为空，那么用户就是无效的，所以要设置 svn 的进入权限。

１、    下载mod_auth_mysql  

使用 #yum install mod_auth_mysql 　　此处存在一个路径问题

此处自动在 /etc/httpd/conf.d/ 文件夹中创建 auth_mysql.conf

该文件是在这行命令下下载的

LoadModule mysql_auth_module /usr/local/mysql/lib/mysql/.libs/mod_auth_mysql.so

重新修改 apache 配置文件 httpd.conf

在其中加入

#Subversion

LoadModule dav_svn_module /usr/local/apache/modules/mod_dav_svn.so

LoadModule authz_svn_module /usr/local/apache/modules/mod_authz_svn.so

LoadModule mysql_auth_module /usr/local/mysql/lib/mysql/.libs/mod_auth_mysql.so

<Location "/home/svn/repos">

 DAV svn

 SVNParentPath /home/svn

 AuthType Basic

 AuthName "Subversion repository"

 AuthUserFile /home/svn/svn-auth-file

 Require valid-user

 AuthzSVNAccessFile /home/svn /svn-access-file

 

AuthMySQLHost localhost

AuthMySQLUser bugs

AuthMySQLPassword 123

AuthMySQLDB bugs

AuthMySQLUserTable profiles

AuthMySQLNameField login_name

AuthMySQLPasswordField cryptpassword

AuthMySQLUserCondition disabledtext=""

</Location>

 

/usr/local/apache/bin/axps �Cc �CL /usr/local/mysql/lib/mysql �CI /usr/local/mysql/include/mysql �Clmsqlclient �Clm lz /usr/local/mysql/lib/mod_auth_mysql.c

２、WebSVN: Subversion仓库浏览授权

下载地址为WebSVN ([url]http://websvn.tigris.org/[/url])

将WebSVN设置为apache可以访问的目录, 在httpd.conf文件中加入WebSVN中, 包括mod_auth_mysql在bugzilla中的授权,并且在WebSVN中编辑文件”include/config.inc”, 如下:

 

$config->parentPath(“/path/to/svn/repositories”)

$config->userAuthenticationFile(“/path/to/svn/accessffile”)

 

在wsvn.php文件中配置如下：

$localwebsvnhttp = "/websvn";

$localwebsvnreal = "/var/www/websvn";

 

修改config.inc文件

$config->setTemplatePath(“$localwebsvnreal/templates/BlueGrey/”)

在WebSVN文件夹中加入文件”.htaccess”来确保用户不能浏览到配置文件,或者他们没有权限访问的其他权限。

３、使用BugTraq和scmbug将subversion与bugzilla整合

现在subversion与bugzilla可以共享帐户并且WebSVN允许授权用户浏览数据仓库,需使用bugtraq特性与TortoiseSVN工具和scmbug整合服务

(1)Bugtraq

Bugtraq是运用标准方式与svn客户端整合，以及第三方bug跟踪系统。

Bugtraq:message

1.      提交时这个设置为客户端提供一个bug_id

2.      Bug_id加在提交日志信息中需使用指定格式

将”bugtraq:message”设置为”Issue:%BUGID%”,这个域是如何指定bug_id在哪个位置插入，

 

Bugtraq:url

将此物性设置为[url]http://my.server.com/bugzilla/show_bug.cgi?id=%BUGID%[/url]指定一种格式来创建URL。用来为客户端创建一个超链接来链接bug跟踪系统。

 

属性设置如下：

---------

name  : bugtraq:url
      

value : (string)

此项值为bug跟踪工具，URL字符串必须包含"%BUGID%"

---------

name  : bugtraq:warnifnoissue

value : "true"/"yes" or "false"/"no"

若值设置为"true"，那么客户端就会警告用户是否版本文本框为空。

---------

基本整合的属性设置：

---------

name  : bugtraq:label

value : (string)

此项值是客户端用来作为GUI标签来描述文本框来显示用户需要在什么位置添入版本号。如果没有设置此值的话，就会默认，如"Bug-ID / Issue-Number :"。设置标签的字符长度为20-25以下。

---------

---------

name  : bugtraq:message

value : (string)

如果设置此项属性，那么客户端应该显示在提交窗口的文本框中。

此项属性的字符是客户端用来为日志信息创建一个额外的行。字符必须包含"%BUGID%"在用户提交日志之前来代替版本号。客户端将加入生成的字符作为日志中的新的一行，用户输入：

logmessage + "\n" + resultstring。

如果bugtraq:append设置为"false"，那么日志就被定义为resultstring + "\n" + logmessage，the log message 定义为resultstring + "\n" + logmessage

客户端必须确认字符不是多行的，如果输入多于一行的版本号，客户端必须确认在逗号之前没有空格字符。并且整个版本号必须是平衡的。

注意：

---------

name  : bugtraq:number

value : "true"/"yes" or "false"/"no"

如果此属性设置为 "false", 那么客户端就允许在文本框中输入任意符号。只有逗号','例外，用来分隔多版本。

客户端必须说明文件框是空的时候，如没有给出版本号，那么所有的提交都会分配到一个版本号上。

注意：如果设置属性bugtraq:logregex，且该属性设置为false，那么客户端必须使用regex使创建后的字符填加到日志后来检验bug ID是否有效。

---------

---------

name  : bugtraq:append

value : "true"/"yes" or "false"/"no"

如果设置为"false"，那么bugtraq:message部分插入日志的最顶端，若设置为"yes"或者不设置的话，该部分就自动附加在底端。

---------

其他属性的配置：

---------

name  : bugtraq:logregex
       

value : (string)
       

此属性包含一个或两个标准表达式，并用新的一行区分。如果只设置一个表达式，那么空的bug　ID的必须与组中的regex字符匹配。如：[Ii]ssue #?(\d+)

如果两个表达式均设置，那么第一个表达式用来查找与bug ID相关或者包含不止bug　ID

的字符，例如"Issue #123" 或 "resolves issue 123"

 

(2)Scmbug

Scmbug连接软件目录管理SCM和bug跟踪系统，在bug跟踪方面支持bugzilla和Mantis

下载地址：[url]http://www.mkgnu.net/?q=scmbug[/url]

SCMBUG_RELEASE_0-23-4.tar.gz

解包进行安装，安装路径为/usr/local/scmbug，在scmbug文件夹中更改文件daemon.conf，添加bugzilla的位置的所在位置/usr/local/apache/htdocs/bugzilla

安装Glue，scmbug自带一个命令行工具名为“scmbug_install_glue”来安装此模块。之后，需更改glue.conf文件指明svn仓库的位置/home/svn/repos

最主要的是必须修改文件glue.conf中标准表达式来解析bugID，由于设置bugtraq:message" = "Issue: %BUGID%"

设置为：

bugid_regex => ‘.*Issue:\s*(.*?)$’,

bugid_split_regex => ‘,\s+#|\s+#|,|\s+’,

log_regex => ‘^(([^\r\n]|[\r\n])*)Issue:.*$’

修改presence_of_bug_ids属性为optional，否则没有bug_id不能提交申请。