SVN服务端客户端tSVN详细使用手册.docx

1、SVN服务端客户端tSVN详细使用手册SVN （Subversion+tortoiseSVN）使用手册编写：高健 MSN：hhjtu524 日期：2011-3-28SVN服务搭建 2下载相关软件 2安装 2SVN服务器信息 3SVN服务基本信息 3SVN单工程管理 3创建版本库 3服务启动 6SVN工程导入 7SVN客户端使用 9工程下载 9文件对比 11文件更新 12文件提交 14新增文件 16删除文件 18SVN注册和删除服务 20服务注册 20服务卸载 21SVN多工程管理 21SVN的备份说明 22完全备份 23增量备份 24同步版本库 25 导读：本文包括了服务搭建、工程管理和客户端

2、使用（针对windows平台）等方面。请注意SVN注册服务、SVN多工程管理（权限配置）、SVN备份说明等章节。SVN服务搭建下载相关软件服务端Subversion官网：http:/subversion.tigris.org/ or http:/subversion.apache.org/ 下载地址：win32svn 客户端tortoiseSVN官网：http:/tortoisesvn.tigris.org/ or 下载地址：安装 服务端是以 .msi后缀名的安装文件，安装过程就不详细介绍了，按照它的提示一步步操作即可，如下图：实际安装路径是C:Program FilesSubversion。

3、TortoiseSVN 客户端安装如下图：客户端的安装完成后会提示系统需要重启。SVN服务器信息 服务器类型：虚拟服务器 win2003系统 服务器地址：10.88.19.67 账户名：administrator 密码：123456SVN服务基本信息 安装目录：C:Program FilesSubversion 版本库根目录：C:svnroot（在该目录下建立工程文件夹）SVN单工程管理 创建版本库在C:svnroot下建立空文件夹project1，然后打开命令窗口， 键入 svnadmin create C:svnroottest1 回车，会在 目录 C:svnrootproject1文件夹

4、下相应的文件，目录结构如下图：也可使用客户端工具（服务器本地客户端）：新建文件夹 C:svnrootproject2(文件夹下必须是空的)，在该文件夹下右击选中TortoiseSVN，如下图：以客户端建立的工程文件结构与使用命令建立完全一致，如下图：目录创建完成后，修改配置文件对版本库进行配置如下：修改配置文件（以下创建以project1为例） 在C:svnrootproject1conf 目录下会看到 svnserver.conf、passwd和authz三个文件，其中svnserve.conf是服务总的配置文件，配置访问方式、鉴权等，passwd是账号配置文件，authz是组和访问权限配置

5、文件，目录结构如下图：对svnserve.conf文修改，具体如下图： 这段配置文件的基本含义为： anon-access = read 匿名用户的权限，文件中为read表示拥有只读权限 auth-access = write 验证通过用户的权限 ，文件中为write表示拥有写的权限 权限包括none、read、write三个值可选，none没有权限，写包含了读权限 去掉#注释时，前面不要有空格 password-db = passwd密码数据存放到passwd文件中 authz-db = authz 表示版本库中访问路径的规则，即谁只能访问哪个目录下的文件，其他目录下的文件无法访问。 对pa

6、sswd 文件中的配置：如:michael=michael表示用户名为michael，密码为michael，具体实例如下图：Authz文件是访问权限配置，具体设置访问权限，其中可以给用户划分用户组，如下图：服务启动 基本命令如下图：运行命令：svnserve -d -r C:svnrootproject1 即可使用SVN对project1工程服务。默认端口是3690,如果这个端口号已经被占用，则可以通过选项 -listen-port=端口号。SVN工程导入推荐使用客户端进行导入（可在服务器本地操作，或客户机操作），选择要导入的工程所在的文件夹，鼠标右键菜单如下图：这里的用户名是在配置文件里配置

7、的，针对project1有r和w权限的账号。正确输入账户名和密码即可导入文件，效果如下图：SVN客户端使用工程下载首先在客户机建立空文件夹D:testtest8，鼠标右键工程下载成功如下图。文件对比当本地文件修改后，图标提示会出现红叹号，如下图：鼠标右键菜单如图：可以看出本地文件与服务器端的版本的差异性。文件更新当本地文件修改后，图标提示会出现红叹号，如下图：如果需要更新鼠标右键菜单如下图：当本地缺少文件时，直接在文件夹进行update就可同步服务器端的文件到本地，如下图例：文件提交双击文件，可进行对比如下图：确定即可提交，如下图：提交成功。当多个人同时修改一个文件时（可能会出现文件冲突，这时

8、请先更新，再提交），如下图：新增文件当有新增文件时，如下图：鼠标右键菜单如下图：文件状态会变化，如下图：右键菜单如下图：再进行提交，如下图：提交成功，如下图：删除文件在文件上鼠标右键菜单如下图：文件会改变状态如下图：进行提交如下图：删除成功。SVN注册和删除服务服务注册安装程序还不能把自己安装成windows服务，需要自己进行手动安装，方法如下： 打开命令窗口，执行如下命令：Sc create svnserve binPath= C:Program FilesSubversionbinsvnserve.exe -service -r C:svnrootproject1 displayname=

9、 subversion depend= Tcpip start= auto执行成功会显示：SC CreateService 成功 会在windows的服务中看到刚创建的，如下图：命令的简单解释： sc是windows自带的服务配置程序，参数binPath表示svnserve可执行文件的安装路径，由于路径中的Program Files带有空格，因此整个路径需要用双引号引起来。而双引号本身是个特殊字符，需要进行转移，因此在路径前后的两个双引号都需要写成 -service参数表示以windows服务的形式运行，-r/-root指明svn repository的位置，service参数与root参数都

10、作为binPath的一部分，因此与svnserve.exe的路径一起被包含在一对双引号当中，而这对双引号不需要进行转义。displayname表示在windows服务列表中显示的名字depend= Tcpip 表示svnserve服务的运行需要tcpip服务start= auto表示开机后自动运行 一定要注意：命令的格式，如果出现下图的提示，表示命令格式出错。其中各个选项的都应为：“key=(空格)value”，一定要注意空格只在等号后面。服务卸载若要卸载svn服务，则执行 sc delete svnserve 即可 。SVN多工程管理使用svnserve管理多个工程时，为了管理的方便，应该使

11、用相同的认证和授权文件，所以应该让所有版本库的配置文件svnserve.conf指向同一个password-db和authz-db文件。下面是一个多版本库的目录，其中project1, project2, project3为三个工程代码，如下图：C:SVNROOT下有三个目录project1、project2和project3，都已经创建了版本库，所以我们修改每个conf目录下的svnserve.conf，使三个工程中的password-db和authz-db选项指向同一个文件，分别为c:svnrootauthz和c:svnrootpasswd两个文件。password-db = .passw

12、dauthz-db = .authz这样，C:SVNROOTpasswd和C:SVNROOTauthz就控制了所有版本库的svnserve访问。另外在后面的操作中要关闭匿名访问，应该去掉“anon-access = none”前的“#”号，保证只有认证用户可以访问。Passwd是账号密码配置信息：usersgaojian=gaojianwucj01=wucj01wangyj03=wangyj03xiaopz=xiaopzpanzx01=panzx01dengyp=dengypliugj=liugjjtiandy=tiandyAuthz文件的事例如下：groups 建立用户组admin=gaoj

13、ian,wucj01,wangyj03dev=panzx01,xiaopz,dengypguest=liugj,tiandy/*=r 对于根路径所有人有读权限admin=rw admin组有读写权限project1:/*=radmin=rwdev=rwproject2:/admin=rwdev=r dev组只有读权限project3:/gaojian=rw gaojian账号有读写权限wucj01=r wucj01读权限xiaopz=r xiaopz读权限配置完成后重新启动服务即可实现，统一管理多个版本库。SVN的备份说明版本控制最关键的一件事是保证数据的安全性，不能因为磁盘损坏，程序故障造成

14、版本库无可挽回的错误，为此必须制定较完备的备份策略。在Subversion中，我们有三种备份方式：完全备份，增量备份和同步版本库。完全备份最常见和简单的备份就是直接使用拷贝命令，将版本库目录拷贝到备份目录上，就可以了。但是这样不是很安全的方式，因为如果在拷贝时版本库发生变化，将会造成备份的结果不够准确，失去备份的作用，为此Subversion提供了“svnadmin hotcopy”命令，可以防止这种问题。如果要把project1备份到d:svnrootbak目录下，只需要运行：svnadmin hotcopy c:svnrootproject1 d:svnrootbakproject1如果我

15、们这个目录下有许多版本库，需要为每个版本库写这样一条语句备份，为此我写了下面的脚本，实现备份一个目录下的所有版本库。我们在C:SVNROOT下创建了两个文件，simpleBackup.bat： echo 正在备份版本库%1. %SVN_HOME%binsvnadmin hotcopy %1 %BACKUP_DIRECTORY%2 echo 版本库%1成功备份到了%2！这个文件仅仅是对“svnadmin hotcopy”的包装，然后是backup.bat： echo off rem Subversion的安装目录set SVN_HOME=C:ProgramFilesSubversion rem

16、所有版本库的父目录set SVN_ROOT=C:svnrootrem 备份的目录set BACKUP_SVN_ROOT=D:svnrootbakset BACKUP_DIRECTORY=%BACKUP_SVN_ROOT%date:0,10% if exist %BACKUP_DIRECTORY% goto checkBack echo 建立备份目录%BACKUP_DIRECTORY%SVN_ROOT%/backup.logmkdir %BACKUP_DIRECTORY% rem 验证目录是否为版本库，如果是则取出名称备份 for /r %SVN_ROOT% %I in (.) do if ex

17、ist %Iconfsvnserve.conf %SVN_ROOT%simpleBackup.bat %fI %nIgoto end :checkBack echo 备份目录%BACKUP_DIRECTORY%已经存在，请清空。goto end :end 在使用的时候，只需要修改backup.bat开头的三个路径，将两个脚本拷贝到“SVN_ROOT”下就可以了。根据以上的配置，你只需要运行 backup.bat，就可以把“SVN_ROOT”下的版本库都备份到“BACKUP_SVN_ROOT”里，并且存放在备份所在日的目录里，例如： “D:svnrootbak2006-10-22”。虽然这部分工

18、作很简单，可是必须有人定时地去执行这个操作（例如每周一凌晨），为了避免发生遗忘的情况，我们可以将这个操作加入到系统的at任务当中去，例如还是上面的环境，为了安装at任务，我们运行：at 1:00 /every:M D:svnrootbackup.bat 这样在每周一凌晨1:00都会执行这个备份过程。当然备份在本机也是不安全的，你也许需要上传到别的机器，这个就要靠你自己去实现了。增量备份尽管完全备份非常简单，但是也是有代价的，当版本库非常巨大时，经常进行完全备份是不现实的，也并不必要，但是一旦版本库在备份之间发生问题，该如何呢，这里我们就用到了增量备份。增量备份通常要与完全备份结合使用，就像or

19、acle数据库的归档日志，记录着每次Subversion提交的变化，然后在需要恢复时能够回到最新的可用状态。在我们这个例子中我们使用的是，svnadmin dump命令进行增量的备份。svnadmin dump project1 -revision 15 -incremental dumpfile2上面的命令实现了对修订版本15进行增量的备份，其中的输出文件dumpfile2只保存了修订版本15更改的内容。为了记录每次提交的结果，我们需要使用一项Subversion的特性-钩子（hook），看看我们的project1目录：其中的hooks目录里存放的就是钩子脚本，我们在此处只使用post-co

20、mmit钩子，这个钩子会在每次提交之后执行，为了实现我们的备份功能，我们在hooks下建立一个文件post-commit.bat，内容如下：echo offset SVN_HOME=C:Program FilesSubversionset SVN_ROOT=C:svnroot set UNIX_SVN_ROOT=D:/svnroot set DELTA_BACKUP_SVN_ROOT=D:svnrootbakdeltaset LOG_FILE=%1backup.log echo backup revision %2 %LOG_FILE% for /r %SVN_ROOT% %I in (.)

21、do if D:/svnroot/%nI = %1 %SVN_ROOT%nIhooksdeltaBackup.bat %nI %2 goto end :end通过这个脚本，可以实现C:svnroot下的版本库提交时自动增量备份到D:svnrootbakdelta（确定这个目录存在），其中使用的deltaBackup.bat其实可以放在任何地方，只是对脚本的svnadmin dump的包装，内容如下： echo 正在备份版本库%2. %SVN_HOME%binsvnadmin dump %SVN_ROOT%1 -incremental -revision %2 %DELTA_BACKUP_SVN

22、_ROOT%1.dumpecho 版本库%2成功备份到了%3！以上两个脚本可以直接拷贝到project2的hooks目录下，不需要修改就可以实现project2的自动备份。以上的操作已经OK了，现在需要做的是将完全备份和增量备份结合起来，也就是在完全备份后清理增量备份的结果，使之只保存完全备份后的结果。当果真出现版本库的故障，就要求我们实现版本库的恢复操作了，这是用要使用svnadmin load命令，同时也需要上次的完全备份例如要把上次完全备份backuprepo，和之后的增量备份dumpfile：svnadmin load backuprepo dumpfile 最后的结果，可以下载svn

23、root.rar，将之解压缩到d:下，然后修改几个bat文件的SVN_HOME就可以使用了。同步版本库Subversion 1.4增加了同步机制，可以实现一个版本库同另一个版本库的同步（但好像只是单向的），我们可以用来实现版本库的备份或镜像。对目标库初始化svnsync init svn:/localhost/project2 svn:/localhost/project1其中project2是目标的版本库，而project1是源版本库。其中的目标版本库必须为空，而且必须允许修订版本属性的修改，也就是在目标的版本库的hooks目录里添加一个文件pre-revprop-change.bat，内容

24、为空即可。同步project2到project1 svnsync sync svn:/localhost/project2这时候你update一下你的project2的一个工作拷贝，就会发现有了project1的所有内容。如果project1又有提交，这时候 project2的版本库无法看到最新的变化，还需要再运行一遍sync操作，这样才能将最新的变化同步。需要注意的是，目标版本库只能做成只读的，如果目标版本库发生了变更，则无法继续同步了。同步历史属性的修改 因为同步不会更新对历史属性的修改，所以svnsync还有子命令copy-revprops，可以同步某个版本的属性。钩子自动同步希望在每次提交时同步，则需要在源版本库增加post-commit脚本，内容如下：echo off set SVN_HOME=D:Subversion%SVN_HOME%binsvnsync sync -non-interactive svn:/localhost/project2把以上内容存放为post-commit.bat，然后放到版本库project1下的hooks目录下，这样project1每次提交，都会引起project2的同三步。