CVS使用手册
内容摘要:
CVS是一个C/S系统,多个开发人员通过一个中心版本控制系统来记录文件版本,从而达到保证文件同步的目的。工作模式如下:
CVS服务器(文件版本库)
/ | (版 本 同 步)
/ | 开发者1 开发者2 开发者3
作为一般开发人员挑选2,6看就可以了,CVS的管理员则更需要懂的更多一些,{zh1}还简单介绍了一些Windows下的cvs客户端使用,CVS远程用户认证的选择及与BUG跟踪系统等开发环境的集成问题。
CVS环境初始化:CVS环境的搭建 管理员
CVS的日常使用:日常开发中最常用的CVS命令, 开发人员 管理员
CVS的分支开发:项目按照不同进度和目标并发进行 管理员
CVS的用户认证:通过SSH的远程用户认证,安全,简单 管理员
CVSWEB:CVS的WEB访问界面大大提高代码版本比较的效率 管理员
CVS TAG:将$Id$ 加入代码注释中,方便开发过程的跟踪开发人员
CVS vs VSS: CVS和Virsual SourceSafe的比较 开发人员 管理员
WinCVS: 通过SSH认证的WinCVS认证设置
基于CVSTrac的小组开发环境搭建:通过CVSTrac实现web界面的CVS用户管理,集成的BUG跟踪和WIKI交流
CVS中的用户权限管理:基于系统用户的CVS权限管理和基于CVSROOT/passwd的虚拟用户管理
一个系统20%的功能往往能够满足80%的需求,CVS也不例外,以下是CVS最常用的功能,可能还不到它全部命令选项的20%,作为一般开发人员平时会用cvs update和cvs commit就够了,更多的需求在实际应用过程中自然会出现,不时回头看看相关文档经常有意外的收获。
CVS环境初始化环境设置:指定CVS库的路径CVSROOT
tcsh
setenv CVSROOT /path/to/cvsroot
bash
CVSROOT=/path/to/cvsroot ; export CVSROOT
后面还提到远程CVS服务器的设置:
CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
初始化:CVS版本库的初始化。
cvs init
一个项目的首次导入
cvs import -m "write some comments here" project_name vendor_tag release_tag
执行后:会将所有源文件及目录导入到/path/to/cvsroot/project_name目录下
vender_tag: 开发商标记
release_tag: 版本发布标记
项目导出:将代码从CVS库里导出
cvs checkout project_name
cvs 将创建project_name目录,并将{zx1}版本的源代码导出到相应目录中。这个checkout和Virvual SourceSafe中的check out不是一个概念,相对于Virvual SourceSafe的check out是cvs update, check in是cvs commit。
CVS的日常使用
注意:{dy}次导出以后,就不是通过cvs checkout来同步文件了,而是要进入刚才cvs checkout project_name导出的project_name目录下进行具体文件的版本同步(添加,修改,删除)操作。
将文件同步到{zx1}的版本
cvs update
不制定文件名,cvs将同步所有子目录下的文件,也可以制定某个文件名/目录进行同步
cvs update file_name
{zh0}每天开始工作前或将自己的工作导入到CVS库里前都要做一次,并养成“先同步 后修改”的习惯,和Virvual SourceSafe不同,CVS里没有文件锁定的概念,所有的冲突是在commit之前解决,如果你修改过程中,有其他人修改并commit到了CVS 库中,CVS会通知你文件冲突,并自动将冲突部分用
>>>>>>
content on cvs server
<<<<<<
content in your file
>>>>>>
标记出来,由你确认冲突内容的取舍。
版本冲突一般是在多个人修改一个文件造成的,但这种项目管理上的问题不应该指望由CVS来解决。
确认修改写入到CVS库里
cvs commit -m "write some comments here" file_name
注意:CVS的很多动作都是通过cvs commit进行{zh1}确认并修改的,{zh0}每次只修改一个文件。在确认的前,还需要用户填写修改注释,以帮助其他开发人员了解修改的原因。如果不用写-m "comments"而直接确认`cvs commit file_name` 的话,cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。
注释的质量很重要:所以不仅必须要写,而且必须写一些比较有意义的内容:以方便其他开发人员能够很好的理解
不好的注释,很难让其他的开发人员快速的理解:比如: -m "bug fixed" 甚至 -m ""
好的注释,甚至可以用中文: -m "在用户注册过程中加入了Email地址校验"
修改某个版本注释:每次只确认一个文件到CVS库里是一个很好的习惯,但难免有时候忘了指定文件名,把多个文件以同样注释commit到CVS库里了,以下命令可以允许你修改某个文件某个版本的注释:
cvs admin -m 1.3:"write some comments here" file_name
添加文件
创建好新文件后,比如:touch new_file
cvs add new_file
注意:对于图片,Word文档等非纯文本的项目,需要使用cvs add -kb选项按2进制文件方式导入(k表示扩展选项,b表示binary),否则有可能出现文件被破坏的情况
比如:
cvs add -kb new_file.gif
cvs add -kb readme.doc
如果关键词替换属性在首次导入时设置错了怎么办?
cvs admin -kkv new_file.css
然后确认修改并注释
cvs ci -m "write some comments here"
删除文件
将某个源文件物理删除后,比如:rm file_name
cvs rm file_name
然后确认修改并注释
cvs ci -m "write some comments here"
以上面前2步合并的方法为:
cvs rm -f file_name
cvs ci -m "why delete file"
注意:很多cvs命令都有缩写形式:commit=>ci; update=>up; checkout=>co/get; remove=>rm;
添加目录
cvs add dir_name
查看修改历史
cvs log file_name
cvs history file_name
查看当前文件不同版本的区别
cvs diff -r1.3 -r1.5 file_name
查看当前文件(可能已经修改了)和库中相应文件的区别
cvs diff file_name
cvs的web界面提供了更方便的定位文件修改和比较版本区别的方法,具体安装设置请看后面的cvsweb使用
正确的通过CVS恢复旧版本的方法:
如果用cvs update -r1.2 file.name
这个命令是给file.name加一个STICK TAG: "1.2" ,虽然你的本意只是想将它恢复到1.2版本
正确的恢复版本的方法是:cvs update -p -r1.2 file_name >file_name
如果不小心已经加成STICK TAG的话:用cvs update -A 解决
移动文件/文件重命名
cvs里没有cvs move或cvs rename,因为这两个操作是可以由先cvs remove old_file_name,然后cvs add new_file_name实现的。
删除/移动目录
最方便的方法是让管理员直接移动,删除CVSROOT里相应目录(因为CVS一个项目下的子目录都是独立的,移动到$CVSROOT目录下都可以作为新的独立项目:好比一颗树,其实砍下任意一枝都能独立存活),对目录进行了修改后,要求其开发人员重新导出项目cvs checkout project_name 或者用cvs update -dP同步。
项目发布导出不带CVS目录的源文件
做开发的时候你可能注意到了,每个开发目录下,CVS都创建了一个CVS/目录。里面有文件用于记录当前目录和CVS库之间的对应信息。但项目发布的时候你一般不希望把文件目录还带着含有CVS信息的CVS目录吧,这个一次性的导出过程使用cvs export命令,不过export只能针对一个TAG或者日期导出,比如:
cvs export -r release1 project_name
cvs export -D 20021023 project_name
cvs export -D now project_name
CVS Branch:项目多分支同步开发确认版本里程碑:多个文件各自版本号不一样,项目到一定阶段,可以给所有文件统一指定一个阶段里程碑版本号,方便以后按照这个阶段里程碑版本号导出项目,同时也是项目的多个分支开发的基础。
cvs tag release_1_0
开始一个新的里程碑:
cvs commit -r 2 标记所有文件开始进入2.x的开发
注意:CVS里的revsion和软件包的发布版本可以没有直接的关系。但所有文件使用和发布版本一致的版本号比较有助于维护。
版本分支的建立
在开发项目的2.x版本的时候发现1.x有问题,但2.x又不敢用,则从先前标记的里程碑:release_1_0导出一个分支 release_1_0_patch
cvs rtag -b -r release_1_0 release_1_0_patch proj_dir
一些人先在另外一个目录下导出release_1_0_patch这个分支:解决1.0中的紧急问题,
cvs checkout -r release_1_0_patch
而其他人员仍旧在项目的主干分支2.x上开发
在release_1_0_patch上修正错误后,标记一个1.0的错误修正版本号
cvs tag release_1_0_patch_1
如果2.0认为这些错误修改在2.0里也需要,也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中:
cvs update -j release_1_0_patch_1
CVS的远程认证通过SSH远程访问CVS使用cvs本身基于pserver的远程认证很麻烦,需要定义服务器和用户组,用户名,设置密码等,
常见的登陆格式如下:
cvs -d :pserver:cvs_user_name@cvs.server.address:/path/to/cvsroot login
例子:
cvs -d :pserver:cvs@samba.org:/cvsroot login
不是很安全,因此一般是作为匿名只读CVS访问的方式。从安全考虑,通过系统本地帐号认证并通过SSH传输是比较好的办法,通过在客户机的 /etc/profile里设置一下内容:
CVSROOT=:ext:$USER@cvs.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
所有客户机所有本地用户都可以映射到CVS服务器相应同名帐号了。
比如:
CVS服务器是192.168.0.3,上面CVSROOT路径是/home/cvsroot,另外一台开发客户机是192.168.0.4,如果 tom在2台机器上都有同名的帐号,那么从192.168.0.4上设置了:
export CVSROOT=:ext:tom@192.168.0.3:/home/cvsroot
export CVS_RSH=ssh
tom就可以直接在192.168.0.4上对192.168.0.3的cvsroot进行访问了(如果有权限的话)
cvs checkout project_name
cd project_name
cvs update
...
cvs commit
如果CVS所在服务器的SSH端口不在缺省的22,或者和客户端与CVS服务器端SSH缺省端口不一致,有时候设置了:
:ext:$USER@test.server.address#port:/path/to/cvsroot
仍然不行,比如有以下错误信息:
ssh: test.server.address#port: Name or service not known
cvs [checkout aborted]: end of file from server (consult above messages if any)
解决的方法是做一个脚本指定端口转向(不能使用alias,会出找不到文件错误):
创建一个/usr/bin/ssh_cvs文件,假设远程服务器的SSH端口是非缺省端口:34567
#!/bin/sh
/usr/bin/ssh -p 34567 "$@"
然后:chmod +x /usr/bin/ssh_cvs
并CVS_RSH=ssh_cvs; export CVS_RSH
注意:port是指相应服务器SSH的端口,不是指cvs专用的pserver的端口
CVSWEB:提高文件浏览效率CVSWEB就是CVS的WEB界面,可以大大提高程序员定位修改的效率:
使用的样例可以看:http://www.freebsd.org/cgi/cvsweb.cgi
CVSWEB的下载:CVSWEB从最初的版本已经演化出很多功能界面更丰富的版本,这个是我个人感觉安装设置比较方便的:
原先在:http://www.spaghetti-code.de/software/linux/cvsweb/,但目前已经删除,目前仍可以在本站下载CVSWEB,其实最近2年FreeBSD的CVSWeb项目已经有了更好的发展吧,而当初没有用FreeBSD那个版本主要就是因为没有彩色的文件Diff功能。
下载解包:
tar zxf cvsweb.tgz
把配置文件cvsweb.conf放到安全的地方(比如和apache的配置放在同一个目录下),
修改:cvsweb.cgi让CGI找到配置文件:
$config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';
转到/path/to/apache/conf下并修改cvsweb.conf:
修改CVSROOT路径设置:
%CVSROOT = (
'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT
);
缺省不显示已经删除的文档:
"hideattic" => "1",#<==缺省不显示已经删除的文档
在配置文件cvsweb.conf中还可以定制页头的描述信息,你可以修改$long_intro成你需要的文字
CVSWEB可不能随便开放给所有用户,因此需要使用WEB用户认证:
先生成 passwd:
/path/to/apache/bin/htpasswd -c cvsweb.passwd user
修改httpd.conf: 增加
<Directory "/path/to/apache/cgi-bin/cvsweb/">
AuthName "CVS Authorization"
AuthType Basic
AuthUserFile /path/to/cvsweb.passwd
require valid-user
</Directory>
CVS TAGS: $Id: cvs_card.html,v 1.5 2003/03/09 08:41:46 chedong Exp $将$Id: cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $ 加在程序文件开头的注释里是一个很好的习惯,cvs能够自动解释更新其中的内容成:file_name version time user_name 的格式,比如:cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong Exp,可以这些信息了解文件的{zh1}修改人和修改时间
几个常用的缺省文件:
default.php
<?php
/*
* Copyright (c) 2002 Company Name.
* $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $
*/
?>
====================================
Default.java: 注意文件头一般注释用 /* 开始 JAVADOC注释用 /** 开始的区别
/*
* Copyright (c) 2002 MyCompany Name.
* $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $
*/
package com.mycompany;
import java.;
/**
* comments here
*/
public class Default {
/**
* Comments here
* @param
* @return
*/
public toString() {
}
}
====================================
default.pl:
#!/usr/bin/perl -w
# Copyright (c) 2002 Company Name.
# $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $
# file comments here
use strict;
CVS vs VSS
CVS没有文件锁定模式,VSS在check out同时,同时记录了文件被导出者锁定。
CVS的update和commit, VSS是get_lastest_version和check in
对应VSS的check out/undo check out的CVS里是edit和unedit
在CVS中,标记自动更新功能缺省是打开的,这样也带来一个潜在的问题,就是不用-kb方式添加binary文件的话在cvs自动更新时可能会导致文件失效。
$Header: /home/cvsroot/tech/cvs_card.html,v 1.5 2003/03/09 08:41:46 chedong Exp $ $Date: 2003/11/09 07:57:11 $这样的标记在Virsual SourceSafe中称之为Keyword Explaination,缺省是关闭的,需要通过OPITION打开,并指定需要进行源文件关键词扫描的文件类型:*.txt,*.java, *.html...
对于Virsual SourceSafe和CVS都通用的TAG有:
$Header: /home/cvsroot/tech/cvs_card.html,v 1.5 2003/03/09 08:41:46 chedong Exp $
$Author: chedong $
$Date: 2003/11/09 07:57:11 $
$Revision: 1.9 $
我建议尽量使用通用的关键词保证代码在CVS和VSS都能方便的跟踪。
WinCVS下载:
cvs Windows客户端:目前稳定版本为1.2
http://cvsgui.sourceforge.net
ssh Windows客户端
http://www.networksimplicity.com/openssh/
安装好以上2个软件以后:
WinCVS客户端的admin==>preference设置
1 在general选单里
设置CVSROOT: username@192.168.0.123:/home/cvsroot
设置Authorization: 选择SSH server
2 Port选单里
钩上:check for alternate rsh name
并设置ssh.exe的路径,缺省是装在 C:\Program Files\NetworkSimplicity\ssh\ssh.exe
然后就可以使用WinCVS进行cvs操作了,所有操作都会跳出命令行窗口要求你输入服务器端的认证密码。
当然,如果你觉得这样很烦的话,还有一个办法就是生成一个没有密码的公钥/私钥对,并设置CVS使用基于公钥/私钥的SSH认证(在general 选单里)。
可以选择的diff工具:examdiff
下载:
http://www.prestosoft.com/examdiff/examdiff.htm
还是在WinCVS菜单admin==>preference的WinCVS选单里
选上:Externel diff program
并设置diff工具的路径,比如:C:\Program Files\ed16i\ExamDiff.exe
在对文件进行版本diff时,{dy}次需要将窗口右下角的use externel diff选上。
基于CVSTrac的小组开发环境搭建作为一个小组级的开发环境,版本控制系统和BUG跟踪系统等都涉及到用户认证部分。如何方便的将这些系统集成起来是一个非常困难的事情,毕竟我们不能指望 Linux下有像Source Offsite那样集成度很高的版本控制/BUG跟踪集成系统。
我个人是很反对使用pserver模式的远程用户认证的,但如果大部分组员使用WINDOWS客户端进行开发的话,总体来说使用 CVSROOT/passwd认证还是很难避免的,但CVS本身用户的管理比较麻烦。本来我打算自己用perl写一个管理界面的,直到我发现了 CVSTrac:一个基于WEB界面的BUG跟踪系统,它外挂在CVS系统上的BUG跟踪系统,其中就包括了WEB界面的CVSROOT/passwd文件的管理,甚至还集成了WIKIWIKI讨论组功能。
这里首先说一下CVS的pserver模式下的用户认证,CVS的用户认证服务是基于inetd中的:
cvspserver stream tcp nowait apache /usr/bin/cvs cvs --allow-root=/home/cvsroot pserver
一般在2401端口(这个端口号很好记:49的平方)
CVS用户数据库是基于CVSROOT/passwd文件,文件格式:
[username]:[crypt_password]:[mapping_system_user]
由于密码都用的是UNIX标准的CRYPT加密,这个passwd文件的格式基本上是apache的htpasswd格式的扩展(比APACHE的 PASSWD文件多一个系统用户映射字段),所以这个文件最简单的方法可以用
apache/bin/htpasswd -b myname mypassword
创建。注意:通过htpasswd创建出来的文件会没有映射系统用户的字段
例如:
new:geBvosup/zKl2
setup:aISQuNAAoY3qw
test:hwEpz/BX.rEDU
映射系统用户的目的在于:你可以创建一个专门的CVS服务帐号,比如用apache的运行用户apache,并将/home/cvsroot目录下的所有权限赋予这个用户,然后在passwd文件里创建不同的开发用户帐号,但开发用户帐号{zh1}的文件读写权限都映射为apache用户,在SSH模式下多个系统开发用户需要在同一个组中才可以相互读写CVS库中的文件。
进一步的,你可以将用户分别映射到apache这个系统用户上。
new:geBvosup/zKl2:apache
setup:aISQuNAAoY3qw:apache
test:hwEpz/BX.rEDU:apache
CVSTrac很好的解决了CVSROOT/passwd的管理问题,而且包含了BUG跟踪报告系统和集成WIKIWIKI交流功能等,使用的 CGI方式的安装,并且基于GNU Public License:
在inetd里加入cvspserver服务:
cvspserver stream tcp nowait apache /usr/bin/cvs cvs --allow-root=/home/cvsroot pserver
xietd的配置文件:%cat cvspserver
service cvspserver
{
disable = no
socket_type = stream
wait = no
user = apache
server = /usr/bin/cvs
server_args = -f --allow-root=/home/cvsroot pserver
log_on_failure += USERID
}
注意:这里的用户设置成apache目的是和/home/cvsroot的所有用户一致,并且必须让这个这个用户对/home/cvsroot/下的 CVSROOT/passwd和cvstrac初始化生成的myproj.db有读取权限。
安装过程
下载:可以从http://www.cvstrac.org 下载
我用的是已经在Linux上编译好的应用程序包:cvstrac-1.1.2.bin.gz,
%gzip -d cvstrac-1.1.2.bin.gz
%chmod +x cvstrac-1.1.2.bin
#mv cvstarc-1.1.1.bin /usr/bin/cvstrac
如果是从源代码编译:
从 http://www.sqlite.org/download.html 下载SQLITE的rpm包:
rpm -i sqlite-devel-2.8.6-1.i386.rpm
从 ftp://ftp.cvstrac.org/cvstrac/ 下载软件包
解包,假设解包到/home/chedong/cvstrac-1.1.2下,并规划将cvstrac安装到/usr/local/bin目录下, cd /home/chedong/cvstrac-1.1.2 编辑linux-gcc.mk:
修改:
SRCDIR = /home/chedong/cvstrac-1.1.2
INSTALLDIR = /usr/local/bin
然后
mv linux-gcc.mk Makefile
make
#make install
初始化cvstrac数据库:假设数据库名是 myproj
在已经装好的CVS服务器上(CVS库这时候应该已经是初始化好了,比如:cvs init初始化在/home/cvsroot里),运行一下
%cvstrac init /home/cvsroot myproj
运行后,/home/cvsroot里会有一个的myproj.db库,使用CVSTRAC服务,/home/cvsroot/myproj.db /home/cvsroot/CVSROOT/readers /home/cvsroot/CVSROOT/writers /home/cvsroot/CVSROOT/passwd这几个文件对于web服务的运行用户应该是可写的,在RedHat8上,缺省就有一个叫 apache用户和一个apache组,所以在httpd.conf文件中设置了用apache用户运行web服务:
User apache
Group apache,
然后设置属于apache用户和apache组
#chown -R apache:apache /home/cvsroot
-rw-r--r-- 1 apache apache 55296 Jan 5 19:40 myproj.db
drwxrwxr-x 3 apache apache 4096 Oct 24 13:04 CVSROOT/
drwxrwxr-x 2 apache apache 4096 Aug 30 19:47 some_proj/
此外还在/home/cvsroot/CVSROOT中设置了:
chmod 664 readers writers passwd
在apche/cgi-bin目录中创建脚本cvstrac:
#!/bin/sh
/usr/bin/cvstrac cgi /home/cvsroot
设置脚本可执行:
chmod +x /home/apache/cgi-bin/cvstrac
从 http://cvs.server.address/cgi-bin/cvstrac/myproj 进入管理界面
缺省登录名:setup 密码 setup
对于一般用户可以从:
http://cvs.server.address/cgi-bin/cvstrac/myproj
在setup中重新设置了CVSROOT的路径后,/home/cvsroot
如果是初次使用需要在/home/cvsroot/CVSROOT下创建passwd, readers, writers文件
touch passwd readers writers
然后设置属于apache用户,
chown apache.apache passwd readers writers
这样使用setup用户创建新用户后会同步更新CVSROOT/passwd下的帐号
修改登录密码,进行BUG报告等,
更多使用细节可以在使用中慢慢了解。
对于前面提到的WinCVS在perference里设置:
CVSROOT栏输入:username@ip.address.of.cvs:/home/cvsroot
Authenitication选择:use passwd file on server side
就可以了从服务器上进行CVS操作了。
CVS的用户权限管理
CVS的权限管理分2种策略:
基于系统文件权限的系统用户管理:适合多个在Linux上使用系统帐号的开发人员进行开发。
基于CVSROOT/passwd的虚拟用户管理:适合多个在Windows平台上的开发人员将帐号映射成系统帐号使用。 为什么使用apache/apache用户?首先RedHat8中缺省就有了,而且使用这个用户可以方便通过cvstrac进行WEB管理。
chown -R apache.apache /home/cvsroot
chmod 775 /home/cvsroot
Linux上通过ssh连接CVS服务器的多个开发人员:通过都属于apache组实现文件的共享读写
开发人员有开发服务器上的系统帐号:sysuser1 sysuser2,设置让他们都属于apache组,因为通过cvs新导入的项目都是对组开放的:664权限的,这样无论那个系统用户导入的项目文件,只要文件的组宿主是apache,所有其他同组系统开发用户就都可以读写;基于ssh远程认证的也是一样。
apache(system group)
/ | sysuser1 sysuser2 sysuser3
Windows上通过cvspserver连接CVS服务器的多个开发人员:通过在passwd文件种映射成 apache用户实现文件的共享读写
他们的帐号通过CVSROOT/passwd和readers writers这几个文件管理;通过cvstrac设置所有虚拟用户都映射到apache用户上即可。
apache(system user)
/ | windev1 windev2 windev3
利用cvs + (WinCVS/cvsweb/cvstrac),构成了一个相对完善的跨平台工作组开发版本控制环境。
相关资源:
CVS HOME:
http://www.cvshome.org
CVS FAQ:
http://www.loria.fr/~molli/cvs-index.html
相关网站:
http://directory.google.com/Top/Computers/Software/Configuration_Management/Tools/Concurrent_Versions_System/
CVS--并行版本系统
http://www.soforge.com/cvsdoc/zh_CN/book1.html
CVS 免费书:
http://cvsbook.red-bean.com/
CVS 命令的速查卡片:
http://www.refcards.com/about/cvs.html
WinCVS:
http://cvsgui.sourceforge.net/
CVSTrac: A Web-Based Bug And Patch-Set Tracking System For CVS
http://www.cvstrac.org
StatCVS:基于CVS的代码统计工具:按代码量,按开发者的统计表等
http://sourceforge.net/projects/statcvs
如何在WEB开发中规划CVS上:在Google上查 "cvs web development"
http://ccm.redhat.com/bboard-archive/cvs_for_web_development/index.html
一些集成了CVS的IDE环境:
Eclipse
Magic C++
==========
CVS使用FAQ
从我对近段时间接到的CVS支持和维护情况来看,大家在使用CVS时出现的问题主要是由于以下原因引起:
§ 用户的工作拷贝信息与CVS库中信息不一致,因此,千万不要手工修改工作拷贝中CVS目录下相关文件,如:Entries、Root等(除非你是CVS高手:));
§ CVS命令使用错误,也即你的意图跟你实际使用的CVS命令所带来的结果不一致,根源还是对CVS使用不熟悉。
基于上述原因,对大家在使用CVS过程可能会遇到的问题及疑惑作一总结和分析,形成FAQ如下:
(1). 检出工作拷贝时如何使用自定义目录名来替换出库时库中带出的目录名?
答:在checkout时加上-d选项,后跟自定义目录名即可。如:$cvs co –d swt dev/swt,将在本地生成目录swt存放工作拷贝内容,而不是dev/swt。
(2). 如何查看某个文件是否已入库,或是否在出库后进行了修改,或是否需要跟库中内容合并?
答:使用cvs status –v filename命令,其中Status后面的值反映了该文件的状态:
§ Update-to-date:{zx1},该状态表示开发者的工作拷贝中的文件与CVS库中同一文件对应的记录的{zx1}版本一致;
§ Locally modified:做过本地(工作拷贝修改),但还没有在服务器端做修改;
§ Locally added:已经在本地(工作拷贝)添加,但还没有在服务器端做添加;
§ Locally removed:已经在本地(工作拷贝)删除,但还没有在服务器端删除;
§ Needs checkout:需要(在客户端)检出(更新的版本);
§ Needs patch:需要补丁;该状态与“needs checkout”状态其实是一回事,只不过“needs patch”出现于文件很大,而做的改动又很小的情况;
§ Needs merge:需要合并,这是“needs checkout”与“locally modified”的叠加;
§ File had conflicts on merge:文件在合并中发生冲突,与“locally modified”相似,但是文件在上一次cvs update操作的时候产生了冲突;
§ Unknown:CVS对这个文件一无所知。
(3). 如果我不能确定自己提交形成新的版本是否会覆盖别人已提交的修改时怎么办?
答:在此种情况下,先执行update,再执行commit,绝不会引起任何问题。有可能作update时CVS会自动把别人修改且已提交的内容合并到你本地工作文件中,所以在commit前要检查一下合并后的内容。
(4). 如何查看文件的修改历史及修改作者信息?
答:当想查看该文件提交版本次数及每次提交作者和说明信息使用如下命令:$cvs log filename。
(5). 有时因为提交的版本有错或其它原因,如何将版本回退到旧的正确版本上去?
答:首先执行;$cvs update –j current_revision –j old_revision filename (将两个版本之间的差异补到当前版本上,相当于减去了从到old_revision到current_revision的变化,old_revision是你要恢复的版本,current_revision是你提交错误的版本);然后执行:$cvs commit –m “reverted to revision old_revision” filenam (此时文件是更新过的,进行提交,形成{zx1}版本);{zh1}:$cvs diff –r old_revision filename (查看现在与旧版本的差异,已经xx相同)。
(6). 在提交时如果日志信息错了,该怎么办?
答:你不用提交新的版本,可用cvs admin命令来修改日志信息,如:$cvs admin –m1.5:”new log info” a.h,注意格式,m后跟版本号,版本号后跟冒号,冒号后跟用双引号括起来的注释。
(7). 在打标签之前应注意什么事项?
答:在给版本打标签之前,应仔细检查你所有的修改是否已提交,否则标签不能反映你{zx1}的修改。
(8). 为什么登录老是不成功?
答:用户在登录过程中可能会出现下列情况导致不能登录:
§ 提示“cvs login: No CVSROOT specified! Please use the `-d' option”,原因在于你没有设置CVSROOT这个环境变量;
§ 提示“cvs login: warning: failed to open /home/cvstest/.cvspass for reading: No such file or directory”,原因是没有在操作系统用户目录下设置.cvspass文件;
§ 提示“yang_evegreen: no such user”,原因在于CVS用户不存在;
§ 提示“cvs login: authorization failed: server localhost rejected access to /cvstest for user yang_evergreen”,原因在于CVS用户密码错误。
(9). 当根据标签取库中文件时,怎样把库中的空目录checkout出来?
答:由于标签是打在每个文件上的,因此根据标签从CVS库中拿东西时默认是不把空目录带出来,因此需要在checkout之后进行update –d操作,如:$cvs co –r B-IT-1 emu_unx;$cvs update –d emu_unix。
(10). 如何在分支和主干之间进行切换?
答:在建立分支后进行BUG修复时经常要在分支和主干之间进行切换,切换的方法是:
§ 由主干切换到分支:$cvs update –r BRANCH_NAME filename/dirname;
§ 由分支切换到主干:$cvs update –r HEAD filename/dirname;或$cvs update –A。
(11). 为什么要解除附着性标签?
答:有些CVS操作会为工作拷贝加上“附着性标签(Sticky Tag)”,特别是根据标签检出工作拷贝时。如果附着性标签为分支标签,则修改后提交不成问题,若不是,则该工作拷贝被“冻结”,因此,先要去掉附着性标签,这样修改后才能提交。去掉附着性标签的办法为:$cvs update –A filename/dirname,该命令在去掉附着性标签的同时把文件更新为最近的主干版本。
(12). 什么时候应用二进制方式添加文件?
答:二进制文件和文本文件在CVS库中保存方式有很大区别,文本文件方式是保留版本之间的差异,而二进制方式是每个版本提交时都会保留所有内容。因此,一般来说,除文本类型文件外,其它类型文件都应以二进制方式添加,如:可执行程序文件、lib库文件、压缩包等。
==========
CVS工作流程
在一台服务器上建立一个源代码库,库里可以存放许多不同项目的源程序。由源代码库管理员统一管理这些源程序。每个用户在使用源代码库之前,首先要把源代码库里的项目文件下载到本地,然后用户可以在本地任意修改,{zh1}用CVS命令进行提交,由 CVS源代码库统一管理修改。这样,就好象只有一个人在修改文件一样,既避免了冲突,又可以做到跟踪文件变化等。
CVS常用术语
Revision (修订版本)--文件历史记录中的被开发者提交的变化。一个修订版本就是一个时常变化的项目的 snapshot (瞬态图)。
Repository (源代码库)--CVS 存储所有修订版本历史记录的地方。每个项目都有自己的一个确定的源代码库。
Working copy (工作拷贝)--开发者对文件作出修改时文件所在的拷贝。
Check out (检验)--从源代码库中申请一份工作拷贝。该工作拷贝反映的是取出时项目的瞬时状态。当开发者对拷贝作出修改时,必须运用 commit (提交)和 update (更新) 命令来 “发布”变化和查看其他开发者所作的修改。
Commit (提交)--将工作拷贝中的变化输入中央源代码库。
Log message (日志信息)--提交修订版本的时候,附带描述变化的注解。通过查阅记录信息,人们可以获得一个当前项目进程的总结。
Update (更新)--从源代码库中取出别人的修改数据,将其输入自己的工作拷贝,并显示自己的工作拷贝是否有未提交的修改。注意,不要和 commit (提交)混淆,更新和提交是一对互补的指令。记住: Update 将使工作拷贝和源代码库拷贝保持同步更新。
Conflicts (冲突)--俩个开发者对同一个区域所作的变化都提交给主版本时出现的情况,在 CVS 觉察并指出这个冲突后,开发者必须解决该冲突。
=========
CVS 迁移到另一台机器
原来安装在一台Fedora上的CVS,CVS已经运行了一段时间有1.7GB的数据,因故需要转移到另一台电脑上,
新的机器上安装了RH Enterprise 4,下载源码编译安装,
配置CVS为一个服务,测试添加一个工程,修改源码,更新,确认可以工作之后开始迁移.
1.用户和组迁移,
把/etc/passwd /etc/shadow /etc/group三个文件拷贝过来就可以了,
拷过来之前当然要把原来的文件先备份一下,
拷完之后重启动一下机器,看看这些用户是否已经生效了,如果用户需要登录的话还需要把home目录也拷贝过来并设置好权限,
2.cvsroot文件夹迁移,用scp把整个文件夹拷贝过来,
先要把cvsroot文件夹中的内容全部删除,然后再拷贝过来.
scp -r source_server:/cvsroot /cvsroot
拷贝完之后一看文件夹的属性都不对了,只有一个个工程按原来所属的用户及组把它们都改过来.
3.修改IP地址,
把原机器的地址改成另一个,再把新的机器的地址改过去,再用自己的工程测试一下,应当没有问题了.
==========
CVS迁移 之 CVS 2 CVS 记录
安装CVS:
1. apt-get install cvsd
设置 Repositories to serve:
默认为: /demo:/myrepos
分号隔开每个目录,目录必需以/开头
直接回车,使用默认配置:
安装完后自动执行:/usr/sbin/cvsd -f /etc/cvsd/cvsd.conf
但用 /etc/init.d/cvsd status 看却是" cvsd stopped"
控制台:
/etc/init.d/cvsd
* Usage: /etc/init.d/cvsd {start|stop|restart|force-reload|status}
修改配置: /etc/cvsd/cvsd.conf
添加:Repos /myporject
把原有的移过到RootJail目录(默认为/var/lib/cvsd,大部分配置以这个为根目录):
mv /web/cvsroot /var/lib/cvsd/myporject
# 更改权限(安装时添加了cvsd用户):
chown cvsd:cvsd /web/cvsroot -R
重启服务:/etc/init.d/cvsd restart
(用 /etc/init.d/cvsd status 看还是stopped,可能是BUG)
在客户端连接,已经可以连上,提示输入密码。
# 修改密码:
修改配置(/var/lib/cvsd/myporject/CVSROOT/config),使用虚用户,先允许写入:
chmod +w /var/lib/cvsd/myporject/CVSROOT/config
#然后添加以下几行(注:不能有任何多余空格):
SystemAuth=no
PamAuth=no
LockDir=/tmp/myporject
# 创建LockDir 目录(相对于RootJail的路径):
mkdir /var/lib/cvsd/tmp/myporject
# 添加虚用户(已存在则更改密码):
cvsd-passwd /var/lib/cvsd/myporject crazysoul
# 本地登录测试:
cvs -d :pserver:crazysoul@localhost:/myporject login
# 失败:
cvs [login aborted]: unrecognized auth response from localhost: cvs [pserver aborted]: /myporject: no s/var/lib/cvsd/myporjectuch repository
root@myporject:# /etc/init.d/cvsd stop
# 停止cvsd:
/etc/init.d/cvsd stop
* Stopping cvs pserver chroot wrapper cvsd
No cvsd found running; none killed.
...fail!
# 强制关闭:
killall cvsd
# 再启动:
/etc/init.d/cvsd start
# 查看状态:
/etc/init.d/cvsd status
* cvsd running
# 再次登录,成功:
cvs login: CVS password file /root/.cvspass does not exist - creating a new file
# 但远程checkout时出现失败:
cvs [checkout aborted]: cvsroot: no such system user
# 反复测试,删除旧的配置目录(这样暴力操作不知有没其他后遗症)再重新初始化就可以了:
rm /var/lib/cvsd/myporject/CVSROOT -rf
# 重新初始化,生成CVSROOT 目录,然后从"修改密码"步骤开始:
cvs -d /var/lib/cvsd/myporject init
chown -R cvsd:cvsd /var/lib/cvsd/myporject
# 更改密码后checkout 成功
备注:
原本项目的仓库路径为:/home/cvsroot
现在改成:/myproject
一时找不到批量修改本地目录中的CVS/Root 配置的方法,只好把服务器中的仓库目录改为原来的对应的位置:
mkdir /var/lib/cvsd/home
mv /var/lib/cvsd/myporject /var/lib/cvsd/home/cvsroot
并在/etc/cvsd/cvsd.conf 后追加:
Repos /home/cvsroot
在开发目录测试update成功。
=
# 安装SVN
apt-get install subversion
会装上 libsvn1 subversion 这个组件
添加:
su -c "svnserve -d -r /home/svnroot/repository" svnroot
到/etc/rc.local
exit 0 之前
su svnroot
cd /home/svnroot
# 建立仓库目录:
mkdir repository
# 启动svn后台服务:
svnserve -d -r /home/svnroot/repository
# 创建demo项目:
cd /home/svnroot/repository
svnadmin create demo
# 添加用户:
vi demo/conf/passwd
# 内容:
[users]
rainchen = password
# xx用户配置:
vi demo/conf/svnserve.conf
# 内容:
[general]
anon-access = none
auth-access = write
password-db = passwd
# 即马上可以在客户端远程连接 svn://www.test.com/demo
apt-get install cvs2svn
会安装 cvs2svn rcs
mkdir /usr/local/cvs2svn
进入cvs2svn 目录(转换时会产生一些日志文件):
cd /usr/local/cvs2svn
装换:
cvs2svn --svnadmin=/usr/bin/svnadmin --encoding=gb2312 --fs-type=fsfs -s /home/svnroot/repository/myporject /web/cvsroot/myporject
# 新目录:
cvs2svn --svnadmin=/usr/bin/svnadmin --encoding=gb2312 --fs-type=fsfs -s /home/svnroot/repository/myporject /var/lib/cvsd/home/cvsroot
参数说明:
--svnadmin svndadmin的路径,创建SVN档案库时需要
--encoding 所采用的编码,默认为ascii
--fs-type 档案库的类型fsfs或bdb
-s SVN档案库的位置
{zh1}一个是要转换CVS档案库的位置
中途出错,遇到德文文件名了:
Starting Subversion r57 / 1760
ERROR: Unable to convert a path 'trunk/myporject/modules/multiMenu/doc/Comment 倀endre les menus.txt' to internal encoding.
Consider rerunning with one or more '--encoding' parameters.
当换成utf-8时遇到中文文件名会出错:
cvs2svn --svnadmin=/usr/bin/svnadmin --encoding=utf-8 --fs-type=fsfs -s /home/svnroot/repository/myporject /var/lib/cvsd/home/cvsroot
报错:
Starting Subversion r4 / 1760
ERROR: Unable to convert a path 'trunk/myporject/themes/myporject/images/复件 logo-cdu.jpg' to internal encoding.
Consider rerunning with one or more '--encoding' parameters.
# 发现可以加多个encoding参数:
cvs2svn --use-cvs --svnadmin=/usr/bin/svnadmin --encoding=utf-8 --encoding=gb2312 --encoding=iso-8859-1 --fs-type=fsfs -s /home/svnroot/repository/myporject /var/lib/cvsd/home/cvsroot
若导入成功,则会在仓库里建立trunk,tags,branches几个默认目录,存放cvs对应的工作区,基线,分支。
cvs2svn Statistics:
------------------
Total CVS Files: 11791
Total CVS Revisions: 19462
Total Unique Tags: 0
Total Unique Branches: 0
CVS Repos Size in KB: 92967
Total SVN Commits: 1760
First Revision Date: Wed Sep 7 20:20:30 2005
Last Revision Date: Tue Apr 15 22:10:26 2008
------------------
Timings:
------------------
pass 1: 77 seconds
pass 2: 0 seconds
pass 3: 4 seconds
pass 4: 0 seconds
pass 5: 3 seconds
pass 6: 6 seconds
pass 7: 0 seconds
pass 8: 0 seconds
pass 9: 284 seconds
total: 376 seconds