SVN服务端客户端tSVN详细使用手册.docx
- 文档编号:5009462
- 上传时间:2022-12-12
- 格式:DOCX
- 页数:26
- 大小:1.10MB
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的同三步。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- SVN 服务端 客户端 tSVN 详细 使用手册
![提示](https://static.bdocx.com/images/bang_tan.gif)