项目开发平台搭建:svn+trac+viewvc

来源:百度文库 编辑:神马文学网 时间:2024/04/28 22:43:10
 项目开发平台搭建:svn+trac+viewvc
开发服务器环境搭建
目的:在Linux平台上搭建一个协同开发工作环境 软件:Linux 2.6 + Apache2 + PHP4.x + Mysql5.x; subversion1.3.1 + mantis1.0.2 基本思路: 使用LAMP搭建一个Web接口,便于管理 使用subversion进行版本控制 使用trac进行bug(缺陷)跟踪(也可选用mantis)。
一、安装软件
在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
#上面两行用于家在模块

DAV svn
#   SVNPath /work/repos/projectA #如果只显示一个工程,则用这个
SVNParentPath /work/repos #显示所有工程
# 下面进行权限配置
#   # Limit write permission to list of valid users.

#      # Require SSL connection for password protection.
#      # SSLRequireSSL
#
AuthType Basic
AuthName "subversion repository"
AuthUserFile /work/repos/.htpasswd  #密码文件必须用htpasswd生成
AuthzSVNAccessFile /work/repos/.authz #管理组的权限
Require valid-user


可以使用命令 #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,下面是给出的一个蓝本
#设定目录权限,如果不设置这个,你会得到没有访问权限的错误,很烦人哟

Order allow,deny
Allow from all

#以后你就可以输入 http://your_site/trac来访问,执行的就是这个trac.cgi
ScriptAlias /trac /usr/share/trac/cgi-bin/trac.cgi
### Trac need to know where the database is located

#       SetEnv TRAC_ENV "/work/trac-env/projectA" #如果只显示一个工程,用这个
SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程

### You need this to allow users to authenticate

AuthType Basic
AuthName "trac"
AuthUserFile /work/trac-env/trac.htpasswd #使用htpasswd生成的密码文件
Require valid-user

ScriptAlias /trac/projectA /usr/share/trac/cgi-bin/trac.cgi
### Trac need to know where the database is located

SetEnv TRAC_ENV "/work/trac-env/projectA" #如果只显示一个工程,用这个
#      SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程

### You need this to allow users to authenticate

AuthType Basic
AuthName "trac"
AuthUserFile /work/trac-env/projectA/trac.htpasswd #使用htpasswd生成的密码文件
Require valid-user

ScriptAlias /trac/projectB /usr/share/trac/cgi-bin/trac.cgi
### Trac need to know where the database is located

SetEnv TRAC_ENV "/work/trac-env/projectB" #如果只显示一个工程,用这个
#      SetEnv TRAC_ENV_PARENT_DIR "/work/trac-env" #显示多个工程

### You need this to allow users to authenticate

AuthType Basic
AuthName "trac"
AuthUserFile /work/trac-env/projectB/trac.htpasswd #使用htpasswd生成的密码文件
Require valid-user

至此,我们已经配置完了,现在在浏览器输入 http://your_site_ip/trac/projectA 就能看到一个web界面的管理系统了,好好体验一把喽。
还有一点不是很爽,有时候我们需要只输入IP就能找到我们需要的网页,比如我们输入http://your_site就得到一个页面,而不要http://your_site_ip/trac/projectA才得到。我的做法是建立文件/var/www/html/index.html,并设置其转到对应页。下面是我的一个设置:



Redirection




edirecting to trac bug system ...

哈哈,到这来




三、使用简介
svn 使用简介
如果你之前使用过cvs,那么你肯定也会用svn,因为它们的命令基本一样,而且常用的也就那么几个“ update, commit, status, log“等,如果没有用过,那么找本svn book来看,或者直接到 http://subverion.trigris.org 上面看它的文档吧 trac使用简介
主要讲述它的导航栏中每个项目的用途
在wiki上发布项目的各种文档,项目信息等; souce一栏可以看到工程的源码,而且可以看到详细的更改信息,语法高亮,版本记录,修改信息等,而且可以以不同颜色区分两个版本的不同,比cvs有更好的界面 使用ticket来汇报bug,可以对bug进行跟踪,可以设置邮件提醒 在roadmap一栏,对工程进度进行跟踪 可以提供Rss支持,订阅RSS,随时跟踪网站的变化
l
这里也给出另外一种选择: 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 press for options
read pause
./viewvc-install
# just press 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 =
Administered by: ASL HyperSim Team lirui
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_compress = 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好像在做这方面的努力。