项目开发平台搭建：svn+trac(FOR LINUX)-UML软件工程组织-火龙果软件

UML软件工程组织

项目开发平台搭建：svn+trac(FOR LINUX)

2008-04-11 来源：Merovingian.cublog.cn

一、安装软件

在linux下常用的安装方式是使用rpm包，我们选用yum（或者apt-get）工具来解决包之间的依赖关系，具体如何用法，这里不再赘述，不懂得问一下Mr. Google或者百度先生吧。如果你觉得自己用tar包，编译安装的方式比较爽，你也可以试一下，不过不推荐哟，别人帮你做好了，干吗还要费那个劲。我这里给出一个自动化的脚本，可能里面某些软件在你机器上的配置找不到，那么需要你到网上查一下，把相应仓库的地址加入到yum的配置文件当中。

#!/bin/bash

# install python
yum -y install python.i386 python-devel.i386 python-lxml.i386 python-sqlite.i386 python-clearsilver.i386 swig.i386 python-setuptools.noarch

# install subversion
yum -y install subversion.i386 subversion-devel.i386

# install clearsilver
yum -y install clearsilver.i386 clearsilver-devel.i386

# install sqlite
yum -y install clearsilver.i386 clearsilver-devel.i386
　

# install LAMP
yum -y install httpd.i386 mod_auth_mysql.i386 mod_dav_svn.i386 mod_log_sql.i386 mod_authz_ldap.i386 mod_python.i386 mod_ssl.i386
　

yum -y install MySQL-python.i386 mysql.i386 mysql-devel.i386 mysql-server.i386

yum -y install php-xml.i386 php.i386 mod_suphp.i386 php-devel.i386 php-ldap.i386 p-readline.i386
　

# install optional
yum -y install enscript.i386
　

# install trac
yum -y install trac.noarch

# install mantis
yum -y install mantis.noarch

上述软件安装完成之后，默认情况下trac被安装在/usr/share/trac下，其他应该在/bin或者/usr/bin目录下。

软件安装完成之后，下面就开始我们的平台搭建。我们要建立两个工程projectA和projectB，使用WEB界面进行管理。

二、搭建平台

创建subversion仓库并配置subversion

假定仓库的地址为 /work/repos，我们进行如下的操作：

#svnadmin create --fs-type fsfs /work/repos/projectA
#svnadmin create --fs-type fsfs /work/repos/projectB

经过上面两步，我们已经创建了两个仓库，下面是要对它进行一些设定了，主要就是访问权限之类的以及服务运行方式。关于subversion的用法，可以到其站点或者svn中国上找本文档看看。　

权限的设置

主要设置 /work/repos/ProjectA/conf/下面的passwd和authz文件，具体如何设置请查看svn的帮助。

服务运行方式

subversion有三种运行方式，本地，svnsever，以及同apache整合，我们要使用的是最后一种方式，后面会具体介绍如何配置。

创建trac环境并对其进行配置

接下来我们要创建trac的环境，假定我们安装到/work/trac-env/目录下，使用如下命令：

#trac-admin /work/trac-env/projectA initenv
#trac-admin /work/trac-env/projectB initenv

在执行上述命令的时候会问你svn仓库的地址，告诉它在/work/repos/projectA，/work/repos/ProjectB下面就是了，如果你弄错了也没有关系，因为可以手动配置的，而且很简单哪。配置文件放在了conf/trac.ini下，具体配置选项的意义和用法，这里也不讲，参考其主页上的说明。　

配置apache

我们的主要精力放在了如何把subversion以及trac和apache结合起来，提供一个web管理界面上，所以这部分是我们的重头戏。

如果按照我们上面的脚本的安装方式，在安装完成后，在/etc/httpd/conf.d/目录下面应该有subversion.conf和trac.conf两个文件，我们分别配置他们就行了，二者没有必然的联系。

首先来配置subversion

主要是配置 /etc/httpd/conf.d/subversion.conf

LoadModule dav_svn_module     modules/mod_dav_svn.so
LoadModule authz_svn_module   modules/mod_authz_svn.so
#上面两行用于家在模块
<Location /repos>
   DAV svn
#   SVNPath /work/repos/projectA #如果只显示一个工程，则用这个
   SVNParentPath /work/repos #显示所有工程
# 下面进行权限配置
#   # Limit write permission to list of valid users.
   <LimitExcept GET PROPFIND OPTIONS REPORT>
#      # Require SSL connection for password protection.
#      # SSLRequireSSL
#
      AuthType Basic
      AuthName "subversion repository"
      AuthUserFile /work/repos/.htpasswd #密码文件必须用htpasswd生成
      AuthzSVNAccessFile /work/repos/.authz #管理组的权限
      Require valid-user
   </LimitExcept>
</Location>

可以使用命令 #htpasswd -cm /work/repos/.htpasswd lirui来为用户lirui添加密码，建立文件/work/repos/.authz，并按照svn的格式要求配置它。　

在配置完成后，重新启动http服务：#apachectl restart

这时候就可以通过命令：svn co http://your_site_ip/repos/projectA

把projectA的源码check到本地了（前提是你有相应权限），如果具有写权限，以后可以直接通过svn commit命令提交修改结果。

再来配置trac

配置/etc/httpd/conf.d/trac.conf，下面是给出的一个蓝本

#设定目录权限，如果不设置这个，你会得到没有访问权限的错误，很烦人哟
<Directory "/usr/share/trac/htdocs">
    Order allow,deny
        Allow from all
</Directory>
#以后你就可以输入 http://your_site/trac来访问，执行的就是这个trac.cgi

ScriptAlias /trac /usr/share/trac/cgi-bin/trac.cgi

### Trac need to know where the database is located
<Location "/trac">
#       SetEnv TRAC_ENV "/work/trac-env/projectA" #如果只显示一个工程，用这个
      SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程
</Location>

### You need this to allow users to authenticate
<Location "/trac/login">
    AuthType Basic
    AuthName "trac"
    AuthUserFile /work/trac-env/trac.htpasswd #使用htpasswd生成的密码文件
    Require valid-user
</location>

ScriptAlias /trac/projectA /usr/share/trac/cgi-bin/trac.cgi

### Trac need to know where the database is located
<Location "/trac/projectA">
      SetEnv TRAC_ENV "/work/trac-env/projectA" #如果只显示一个工程，用这个
#      SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程
</Location>

### You need this to allow users to authenticate
<Location "/trac/project/Alogin">
    AuthType Basic
    AuthName "trac"
    AuthUserFile /work/trac-env/projectA/trac.htpasswd #使用htpasswd生成的密码文件
    Require valid-user
</location>

ScriptAlias /trac/projectB /usr/share/trac/cgi-bin/trac.cgi

### Trac need to know where the database is located
<Location "/trac/projectA">
       SetEnv TRAC_ENV "/work/trac-env/projectB" #如果只显示一个工程，用这个
#    SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程
</Location>

### You need this to allow users to authenticate
<Location "/trac/project/Alogin">
    AuthType Basic
    AuthName "trac"
    AuthUserFile /work/trac-env/projectB/trac.htpasswd #使用htpasswd生成的密码文件
    Require valid-user
</location>

至此，我们已经配置完了，现在在浏览器输入 http://your_site_ip/trac/projectA 就能看到一个web界面的管理系统了，好好体验一把喽。

还有一点不是很爽，有时候我们需要只输入IP就能找到我们需要的网页，比如我们输入http://your_site就得到一个页面，而不要http://your_site_ip/trac/projectA才得到。我的做法是建立文件/var/www/html/index.html，并设置其转到对应页。下面是我的一个设置：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Redirection</title>
<meta http-equiv="refresh" content="0;URL=/trac/projectA">
</head>
<body>
<h1><center>
edirecting to trac bug system ...<br>
<a href="/trac/projectA">哈哈，到这来</a>
</h1>
</body>
</html>

三、使用简介

svn 使用简介

如果你之前使用过cvs，那么你肯定也会用svn，因为它们的命令基本一样，而且常用的也就那么几个“ update， commit， status， log“等，如果没有用过，那么找本svn book来看，或者直接到 http://subverion.trigris.org 上面看它的文档吧

trac使用简介

主要讲述它的导航栏中每个项目的用途

在wiki上发布项目的各种文档，项目信息等；
souce一栏可以看到工程的源码，而且可以看到详细的更改信息，语法高亮，版本记录，修改信息等，而且可以以不同颜色区分两个版本的不同，比cvs有更好的界面
使用ticket来汇报bug，可以对bug进行跟踪，可以设置邮件提醒
在roadmap一栏，对工程进度进行跟踪
可以提供Rss支持，订阅RSS，随时跟踪网站的变化

这里也给出另外一种选择： svn（cvs）〔版本控制〕＋ viewVC〔web界面〕＋ mantis〔bug追踪〕，如果可能的话，我会给出这种选择的配置情况。这里有一篇讲述如何在windows下安装viewVC的 http://schnell.blogchina.com/4627119.html ，还有竹笋炒肉的mantis学习笔记http://hedong.3322.org/archives/000263.html

四 viewvc 安装手记

基本步骤如下

下载viewvc-1.0.0.tar.gz和enscript-1.6.4.tar.gz
　
将二者分解解压缩进行安装
　
拷贝安装viewvc目录下 bin/cgi/viewvc.cgi 到 /var/www/cgi-bin/viewvc.cgi
　
配置viewvc，告诉它你的源码仓库所在的位置
　
如果需要的话，还可以为apache配置scriptAlias

这里给出一个自动安装的脚本，它自动帮你完成了上面的1，2，3步的工作

#!/bin/bash

wget http://viewvc.tigris.org/files/documents/3330/31766/viewvc-1.0.0.tar.gz
wget http://www.iki.fi/mtr/genscript/enscript-1.6.4.tar.gz

tar -xf enscript-1.6.4.tar.gz
cd enscript-1.6.4
./configure
make && make install

# if success, enscript will install on /usr/local/bin /usr/local/share/enscript

tar xf viewvc-1.0.0.tar.gz
cd viewvc-1.0.0
# just divss <enter> for options
read pause
./viewvc-install

# just divss <enter> for options
echo 'install viewvc ok'
# after that viewvc will be installed in /usr/local/viewvc-1.0.0

cp /usr/local/viewvc-1.0.0/bin/cgi/viewvc.cgi /var/www/cgi-bin

echo '++++++++++++++++++++++++++++++++++++++++++++++++++'
echo '| configure /usr/local/viewvc-1.0.0/viewvc.conf |'
echo '++++++++++++++++++++++++++++++++++++++++++++++++++'

这里再给出一个viewvc的配置范例，其中主要设置的地方在 root_parents，default_root 以及有关enscript用于语法高亮的东西

root_parents = /home/svn-repos: svn,
/home/cvs-repos: cvs
default_root = hypersim
use_rcsparse = 0
address = <div>Administered by: <strong>ASL HyperSim Team</strong> <a href="mailto:lirui@ncic.ac.cn">lirui</a>
forbidden =
kv_files =
languages = en-us

[options]
root_as_url_component = 0
default_file_view = log
checkout_magic = 0
http_expiration_time = 600
generate_etags = 1
sort_by = file
sort_group_dirs = 1
hide_attic = 1
log_sort = date
diff_format = h
hide_cvsroot = 1
hr_breakable = 1
hr_funout = 0
hr_ignore_white = 1
hr_ignore_keyword_subst = 1
hr_intraline = 0
allow_annotate = 1
allow_markup = 1
allow_comdivss = 1
template_dir = templates
show_subdir_lastmod = 0
show_logs = 1
show_log_in_markup = 1
cross_copies = 1
use_localtime = 0
py2html_path = .
short_log_len = 80

#setting for syntax highlightning
use_enscript = 1
enscript_path = /usr/loca/bin
# should we add line numbers?
highlight_line_numbers = 1
# convert tabs to ## spaces (use 0 for no conversion)
highlight_convert_tabs = 4

use_php = 0
php_exe_path = php
allow_tar = 0
use_cvsgraph = 0
cvsgraph_path =
cvsgraph_conf = cvsgraph.conf
use_re_search = 0
use_pagesize = 0
limit_changes = 100

[cvsdb]
enabled = 0

其中这些都在各自的领域做的都很好，如果有一个能够把这些工具集大成者，就很好了，有个scmbug好像在做这方面的努力。