SVN服务端客户端tSVN详细使用手册.docx
《SVN服务端客户端tSVN详细使用手册.docx》由会员分享，可在线阅读，更多相关《SVN服务端客户端tSVN详细使用手册.docx（26页珍藏版）》请在冰豆网上搜索。
SVN服务端客户端tSVN详细使用手册
SVN（Subversion+tortoiseSVN）使用手册
编写：
高健MSN：
hhjtu524@日期：
2011-3-28
SVN服务搭建2
下载相关软件2
安装2
SVN服务器信息3
SVN服务基本信息3
SVN单工程管理3
创建版本库3
服务启动6
SVN工程导入7
SVN客户端使用9
工程下载9
文件对比11
文件更新12
文件提交14
新增文件16
删除文件18
SVN注册和删除服务20
服务注册20
服务卸载21
SVN多工程管理21
SVN的备份说明22
完全备份23
增量备份24
同步版本库25
导读：
本文包括了服务搭建、工程管理和客户端使用（针对windows平台）等方面。
请注意SVN注册服务、SVN多工程管理（权限配置）、SVN备份说明等章节。
SVN服务搭建
下载相关软件
服务端Subversion
官网：
http:
//subversion.tigris.org/orhttp:
//subversion.apache.org/
下载地址：
win32svn
客户端tortoiseSVN
官网：
http:
//tortoisesvn.tigris.org/or
下载地址：
安装
服务端是以.msi后缀名的安装文件，安装过程就不详细介绍了，按照它的提示一步步操作即可，如下图：
实际安装路径是C:
\ProgramFiles\Subversion。
TortoiseSVN客户端安装如下图：
客户端的安装完成后会提示系统需要重启。
SVN服务器信息
服务器类型：
虚拟服务器win2003系统
服务器地址：
10.88.19.67
账户名：
administrator
密码：
123456
SVN服务基本信息
安装目录：
C:
\ProgramFiles\Subversion
版本库根目录：
C:
\svnroot（在该目录下建立工程文件夹）
SVN单工程管理
创建版本库
在C:
\svnroot\下建立空文件夹project1，然后打开命令窗口，键入svnadmincreateC:
\svnroot\test1回车，会在目录C:
\svnroot\project1文件夹下相应的文件，目录结构如下图：
也可使用客户端工具（服务器本地客户端）：
新建文件夹C:
\svnroot\project2（文件夹下必须是空的），在该文件夹下右击选中TortoiseSVN，如下图：
以客户端建立的工程文件结构与使用命令建立完全一致，如下图：
目录创建完成后，修改配置文件对版本库进行配置如下：
修改配置文件（以下创建以project1为例）
在C:
\svnroot\project1\conf\目录下会看到svnserver.conf、passwd和authz三个文件，其中svnserve.conf是服务总的配置文件，配置访问方式、鉴权等，passwd是账号配置文件，authz是组和访问权限配置文件，目录结构如下图：
对svnserve.conf文修改，具体如下图：
这段配置文件的基本含义为：
anon-access=read匿名用户的权限，文件中为read表示拥有只读权限
auth-access=write验证通过用户的权限，文件中为write表示拥有写的权限
权限包括none、read、write三个值可选，none没有权限，写包含了读权限
去掉#注释时，前面不要有空格
password-db=passwd密码数据存放到passwd文件中
authz-db=authz表示版本库中访问路径的规则，即谁只能访问哪个目录下的文件，其他目录下的文件无法访问。
对passwd文件中的配置：
如:
michael=michael表示用户名为michael，密码为michael，具体实例如下图：
Authz文件是访问权限配置，具体设置访问权限，其中可以给用户划分用户组，如下图：
服务启动
基本命令如下图：
运行命令：
svnserve-d-rC:
\svnroot\project1即可使用SVN对project1工程服务。
默认端口是3690,如果这个端口号已经被占用，则可以通过选项--listen-port=端口号。
SVN工程导入
推荐使用客户端进行导入（可在服务器本地操作，或客户机操作），选择要导入的工程所在的文件夹，鼠标右键菜单如下图：
这里的用户名是在配置文件里配置的，针对project1有r和w权限的账号。
正确输入账户名和密码即可导入文件，效果如下图：
SVN客户端使用
工程下载
首先在客户机建立空文件夹D:
\test\test8，鼠标右键
工程下载成功如下图。
文件对比
当本地文件修改后，图标提示会出现红叹号，如下图：
鼠标右键菜单如图：
可以看出本地文件与服务器端的版本的差异性。
文件更新
当本地文件修改后，图标提示会出现红叹号，如下图：
如果需要更新鼠标右键菜单如下图：
当本地缺少文件时，直接在文件夹进行update就可同步服务器端的文件到本地，如下图例：
文件提交
双击文件，可进行对比如下图：
确定即可提交，如下图：
提交成功。
当多个人同时修改一个文件时（可能会出现文件冲突，这时请先更新，再提交），如下图：
新增文件
当有新增文件时，如下图：
鼠标右键菜单如下图：
文件状态会变化，如下图：
右键菜单如下图：
再进行提交，如下图：
提交成功，如下图：
删除文件
在文件上鼠标右键菜单如下图：
文件会改变状态如下图：
进行提交如下图：
删除成功。
SVN注册和删除服务
服务注册
安装程序还不能把自己安装成windows服务，需要自己进行手动安装，方法如下：
打开命令窗口，执行如下命令：
SccreatesvnservebinPath="\"C:
\ProgramFiles\Subversion\bin\svnserve.exe\"--service-rC:
\svnroot\project1"displayname="subversion"depend=Tcpipstart=auto
执行成功会显示：
[SC]CreateService成功
会在windows的服务中看到刚创建的，如下图：
命令的简单解释：
sc是windows自带的服务配置程序，参数binPath表示svnserve可执行文件的安装路径，由于路径中的"ProgramFiles"带有空格，因此整个路径需要用双引号引起来。
而双引号本身是个特殊字符，需要进行转移，因此在路径前后的两个双引号都需要写成\"--service参数表示以windows服务的形式运行，-r/--root指明svnrepository的位置，service参数与root参数都作为binPath的一部分，因此与svnserve.exe的路径一起被包含在一对双引号当中，而这对双引号不需要进行转义。
displayname表示在windows服务列表中显示的名字depend=Tcpip表示svnserve服务的运行需要tcpip服务start=auto表示开机后自动运行
一定要注意：
命令的格式，如果出现下图的提示，表示命令格式出错。
其中各个选项的都应为：
“key=（空格）value”，一定要注意空格只在等号后面。
服务卸载
若要卸载svn服务，则执行scdeletesvnserve即可。
SVN多工程管理
使用svnserve管理多个工程时，为了管理的方便，应该使用相同的认证和授权文件，所以应该让所有版本库的配置文件svnserve.conf指向同一个password-db和authz-db文件。
下面是一个多版本库的目录，其中project1,project2,project3为三个工程代码，如下图：
C:
\SVNROOT下有三个目录project1、project2和project3，都已经创建了版本库，所以我们修改每个conf目录下的svnserve.conf，使三个工程中的password-db和authz-db选项指向同一个文件，分别为c:
\svnroot\authz和c:
\svnroot\passwd两个文件。
password-db=..\..\passwd
authz-db=..\...\authz
这样，C:
\SVNROOT\passwd和C:
\SVNROOT\authz就控制了所有版本库的svnserve访问。
另外在后面的操作中要关闭匿名访问，应该去掉“anon-access=none”前的“#”号，保证只有认证用户可以访问。
Passwd是账号密码配置信息：
[users]
gaojian=gaojian
wucj01=wucj01
wangyj03=wangyj03
xiaopz=xiaopz
panzx01=panzx01
dengyp=dengyp
liugj=liugjj
tiandy=tiandy
Authz文件的事例如下：
[groups]建立用户组
admin=gaojian,wucj01,wangyj03
dev=panzx01,xiaopz,dengyp
guest=liugj,tiandy
[/]
*=r对于根路径所有人有读权限
@admin=rwadmin组有读写权限
[project1:
/]
*=r
@admin=rw
@dev=rw
[project2:
/]
@admin=rw
@dev=rdev组只有读权限
[project3:
/]
gaojian=rwgaojian账号有读写权限
wucj01=rwucj01读权限
xiaopz=rxiaopz读权限
配置完成后重新启动服务即可实现，统一管理多个版本库。
SVN的备份说明
版本控制最关键的一件事是保证数据的安全性，不能因为磁盘损坏，程序故障造成版本库无可挽回的错误，为此必须制定较完备的备份策略。
在Subversion中，我们有三种备份方式：
完全备份，增量备份和同步版本库。
完全备份
最常见和简单的备份就是直接使用拷贝命令，将版本库目录拷贝到备份目录上，就可以了。
但是这样不是很安全的方式，因为如果在拷贝时版本库发生变化，将会造成备份的结果不够准确，失去备份的作用，为此Subversion提供了“svnadminhotcopy”命令，可以防止这种问题。
如果要把project1备份到d:
\svnrootbak目录下，只需要运行：
svnadminhotcopyc:
\svnroot\project1d:
\svnrootbak\project1
如果我们这个目录下有许多版本库，需要为每个版本库写这样一条语句备份，为此我写了下面的脚本，实现备份一个目录下的所有版本库。
我们在C:
\SVNROOT下创建了两个文件，simpleBackup.bat：
@echo正在备份版本库%1......
@%SVN_HOME%\bin\svnadminhotcopy%1%BACKUP_DIRECTORY%\%2
@echo版本库%1成功备份到了%2！
这个文件仅仅是对“svnadminhotcopy”的包装，然后是backup.bat：
echooff
remSubversion的安装目录
setSVN_HOME="C:
\ProgramFiles\Subversion"
rem所有版本库的父目录
setSVN_ROOT=C:
\svnroot
rem备份的目录
setBACKUP_SVN_ROOT=D:
\svnrootbak
setBACKUP_DIRECTORY=%BACKUP_SVN_ROOT%\%date:
~0,10%
ifexist%BACKUP_DIRECTORY%gotocheckBack
echo建立备份目录%BACKUP_DIRECTORY%>>%SVN_ROOT%/backup.log
mkdir%BACKUP_DIRECTORY%
rem验证目录是否为版本库，如果是则取出名称备份
for/r%SVN_ROOT%%%Iin（.）do@ifexist"%%I\conf\svnserve.conf"%SVN_ROOT%\simpleBackup.bat"%%~fI"%%~nI
gotoend
:
checkBack
echo备份目录%BACKUP_DIRECTORY%已经存在，请清空。
gotoend
:
end
在使用的时候，只需要修改backup.bat开头的三个路径，将两个脚本拷贝到“SVN_ROOT”下就可以了。
根据以上的配置，你只需要运行backup.bat，就可以把“SVN_ROOT”下的版本库都备份到“BACKUP_SVN_ROOT”里，并且存放在备份所在日的目录里，例如：
“D:
\svnrootbak\2006-10-22”。
虽然这部分工作很简单，可是必须有人定时地去执行这个操作（例如每周一凌晨），为了避免发生遗忘的情况，我们可以将这个操作加入到系统的at任务当中去，例如还是上面的环境，为了安装at任务，我们运行：
at1:
00/every:
MD:
\svnroot\backup.bat
这样在每周一凌晨1:
00都会执行这个备份过程。
当然备份在本机也是不安全的，你也许需要上传到别的机器，这个就要靠你自己去实现了。
增量备份
尽管完全备份非常简单，但是也是有代价的，当版本库非常巨大时，经常进行完全备份是不现实的，也并不必要，但是一旦版本库在备份之间发生问题，该如何呢，这里我们就用到了增量备份。
增量备份通常要与完全备份结合使用，就像oracle数据库的归档日志，记录着每次Subversion提交的变化，然后在需要恢复时能够回到最新的可用状态。
在我们这个例子中我们使用的是，svnadmindump命令进行增量的备份。
svnadmindumpproject1--revision15--incremental>dumpfile2
上面的命令实现了对修订版本15进行增量的备份，其中的输出文件dumpfile2只保存了修订版本15更改的内容。
为了记录每次提交的结果，我们需要使用一项Subversion的特性--钩子（hook），看看我们的project1目录：
其中的hooks目录里存放的就是钩子脚本，我们在此处只使用post-commit钩子，这个钩子会在每次提交之后执行，为了实现我们的备份功能，我们在hooks下建立一个文件post-commit.bat，内容如下：
echooff
setSVN_HOME="C:
\ProgramFiles\Subversion"
setSVN_ROOT=C:
\svnroot
setUNIX_SVN_ROOT=D:
/svnroot
setDELTA_BACKUP_SVN_ROOT=D:
\svnrootbak\delta
setLOG_FILE=%1\backup.log
echobackuprevision%2>>%LOG_FILE%
for/r%SVN_ROOT%%%Iin（.）doifD:
/svnroot/%%~nI==%1%SVN_ROOT%\%%~nI\hooks\deltaBackup.bat%%~nI%2
gotoend
:
end
通过这个脚本，可以实现C:
\svnroot下的版本库提交时自动增量备份到D:
\svnrootbak\delta（确定这个目录存在），其中使用的deltaBackup.bat其实可以放在任何地方，只是对脚本的svnadmindump的包装，内容如下：
@echo正在备份版本库%2......
%SVN_HOME%\bin\svnadmindump%SVN_ROOT%\%1--incremental--revision%2>>%DELTA_BACKUP_SVN_ROOT%\%1.dump
@echo版本库%2成功备份到了%3！
以上两个脚本可以直接拷贝到project2的hooks目录下，不需要修改就可以实现project2的自动备份。
以上的操作已经OK了，现在需要做的是将完全备份和增量备份结合起来，也就是在完全备份后清理增量备份的结果，使之只保存完全备份后的结果。
当果真出现版本库的故障，就要求我们实现版本库的恢复操作了，这是用要使用svnadminload命令，同时也需要上次的完全备份例如要把上次完全备份backuprepo，和之后的增量备份dumpfile：
svnadminloadbackuprepo最后的结果，可以下载svnroot.rar，将之解压缩到d:
\下，然后修改几个bat文件的SVN_HOME就可以使用了。
同步版本库
Subversion1.4增加了同步机制，可以实现一个版本库同另一个版本库的同步（但好像只是单向的），我们可以用来实现版本库的备份或镜像。
对目标库初始化
svnsyncinitsvn:
//localhost/project2svn:
//localhost/project1
其中project2是目标的版本库，而project1是源版本库。
其中的目标版本库必须为空，而且必须允许修订版本属性的修改，也就是在目标的版本库的hooks目录里添加一个文件pre-revprop-change.bat，内容为空即可。
同步project2到project1
svnsyncsyncsvn:
//localhost/project2
这时候你update一下你的project2的一个工作拷贝，就会发现有了project1的所有内容。
如果project1又有提交，这时候project2的版本库无法看到最新的变化，还需要再运行一遍sync操作，这样才能将最新的变化同步。
需要注意的是，目标版本库只能做成只读的，如果目标版本库发生了变更，则无法继续同步了。
同步历史属性的修改
因为同步不会更新对历史属性的修改，所以svnsync还有子命令copy-revprops，可以同步某个版本的属性。
钩子自动同步
希望在每次提交时同步，则需要在源版本库增加post-commit脚本，内容如下：
echooff
setSVN_HOME="D:
\Subversion"
%SVN_HOME%\bin\svnsyncsync --non-interactivesvn:
//localhost/project2
把以上内容存放为post-commit.bat，然后放到版本库project1下的hooks目录下，这样project1每次提交，都会引起project2的同三步。
升级会员 