通常搭建CVS服务器都是在Linux/Unix平台上,但是在Windows平台上,凭借数目庞大的Open Source软件,我们也同样可以搭建一个适用于项目组的CVS服务器,并且还可以为其添加源代码跟踪功能。
一、需要的软件
1、CVSNT
CVSNT是目前在Windows平台上构建CVS服务器最方便的工具,操作简单,以Windows服务程序的形式运行。目前CVSNT已被移植到其它平台如Linux上。
选用版本:2.0.58d。
选用这个版本而不是最新的2.5.x的原因是2.5.x改变了History文件的格式,影响了我们后面介绍的CVSTracNT的运行。当然,如果你不使用CVSTracNT,选用2.5.x也没有问题,其操作与2.0.58d基本相同,也十分的简单。
下载地址:http://www.cvsnt.org
2、CVSTracNT
CVSTracNT是一个基于Web的CVS源代码跟踪工具。使用CVSTracNT,你可以跟踪源代码的变更,提交任务单,创建里程碑,并通过Web的方式查看、比较源代码文件。对于CVS系统本身来说,是一个非常有益的补充。
选用版本:1.1.5 Build20050703多国语言版。
这个版本由cnpack项目组的成员进行了汉化,并添加了许多实用的工具。具体的内容可以参考其中文网站。
下载地址:http://www.cnvcl.org
3、ViewCVS
ViewCVS是一个用Python语言编写的CVS Web界面。有了它,你可以通过浏览器查阅源代码,进行版本比较。相对于CVSTracNT自带的Web界面来说,ViewCVS更加有亲和力,功能也比较完善。大名鼎鼎的SourceForge的Web界面就是使用ViewCVS搭建的。
还有另外一个CVS的Web界面CVSWeb,用Perl语言开发。
选用版本:1.0 dev r6。
最新的版本,没什么好说的。
下载地址:http://russ.hn.org/viewcvs/
4、Python
让ViewCVS运行起来,必不可少的就是Python。
选用版本:2.4.1。其它2.4.x版本应该也可以,但注意和ViewCVS的版本要搭配。
5、PyWin32
Python语言的Win32扩展。
选用版本:2.04 for Py 2.4。
下载地址:http://pywin32.sourceforge.net
6、Apache HTTP Server
ViewCVS可以在IIS和Apache服务器上运行,考虑再三,最后选择的Apache。虽然配置起来有些麻烦(其实也不麻烦),但考虑到Apache是开源项目,不会有法律问题,呵呵。
选用版本:2.0.54。
下载地址:http://apache.justdn.org/
7、MySQL
ViewCVS提供了查询功能,使用的是MySQL数据库。
选用版本:3.23.42-nt。
不要使用4.x版本的MySQL,与ViewCVS兼容不太好。
二、安装
1、安装CVSNT
直接运行CVSNT安装包。安装结束后,打开Service Control Panel,配置你的CVS仓库。点击Repositories选项页,添加你的仓库地址就可以了,不需要重新启动CVS服务器。
2、安装CVSTracNT
直接运行CVSTracNT安装包。感谢CNPack的程序员,如果按照CVSTracNT网页上的安装介绍,一定会郁闷死。安装结束后运行CVSTrac配置程序,程序启动后会自动搜索CVS仓库,将其添加到CVSTrac数据库。选中数据库,点击浏览按钮,你的浏览器应该打开并显示CVSTrac的页面了。
CVSTracNT的使用及配置参考http://www.cnpack.org上的介绍。
3、安装Python及PyWin32
运行安装包即可。
4、安装Apache HTTP Server
运行安装包即可。如果在安装过程中没有选择让Apache自动运行,那么可以通过开始菜单运行Apache。
5、安装MySQL
运行安装包即可。
6、安装ViewCVS
最麻烦的地方到了。
首先,将ViewCVS解压缩到一个目录中,然后在该目录的命令行中,运行python viewcvs-install。安装结束后,编辑viewcvs.conf文件,修改cvs_roots项为你的CVS仓库路径,修改default_root项为默认的CVS仓库,还可以修改邮件地址项。
然后拷贝web\cvs\viewcvs.cgi到你的Apache cgi-bin目录中。
运行Apache,在浏览器中输入http://localhost/cgi-bin/viewcvs.cgi,看看你的ViewCVS是不是运行顺利?
现在我们要为ViewCVS添加查询功能了。
运行MySQL的管理程序mysql,进入MySQL命令行模式,添加一个用户viewcvs,并赋予其读写的权力。退出。在命令行下运行python cvsbdadmin CREATE,根据提示输入数据库名,用户名和密码,数据库自动创建。
编辑viewcvs.conf文件,修改cvsdb块下的enabled选项值为1,去除后面各项前的注释符,修改各项的值为前面设置的值。
拷贝web\cgi\query.cgi到Apache cgi-bin目录下。
在浏览器中运行http://localhost/cgi-bin/query.cgi,看看结果……
失败了,系统提示Python错误。根据错误信息查到,错误处在dbi.py文件中。在dbi.py中有这样一行:datetime.tuple()。查阅Python文档,发现datetime对象没有tuple方法,只有timetuple方法,更改之后,运行正常。
三、总结
以上的搭配方案适用于中小项目组,因为CVSNT本身在应对大项目时有一些效率问题。如果你想用CVS管理上万个源文件,那么用Linux平台搭建CVS服务器是更合适的选择。
无论如何,CVSTracNT都是你不该错过的好东西,当项目逐渐膨胀起来后,让CVSTracNT来管理一些机械的事情是一个好选择。
ViewCVS并不是必要的,但是比之CVSTracNT自带的Web界面,ViewCVS要更舒服一些,某些功能也更清晰(比如版本比较)。让你的上级通过ViewCVS来浏览你的工作情况也许是个好选择,你不需要在Trac中为他保留一个会扰乱正常工作程序的位置。
总得来说ViewCVS的查询功能并不是太方便,使用起来比较繁琐,结论是不用也罢。安装MySQL等等的繁琐工作也就不需要了。
我最遗憾的是,因为时间的关系,并没有建立SSL连接方式。从安全的角度来说,SSL也许是必不可少的,除非你的访问者都值得信任。
最后还要说的是,CVS虽然比较流行,但并不是源代码管理的唯一选择。在你作出决定之前,不妨先看看这篇文章:http://better-scm.berlios.de/comparison/comparison.html。