Windows下SVN使用手册
一、下载
首先,请登录SVN官网http://subversion.tigris.org/ 下载服务端和客户端安装包。
可以根据你的需求,下载相应的发行版。如VisualSVN,其服务端是免费的,它提供了一个界面管理器,实现可视化配置管理,然而客户端却是收费的。
VisualSVN Server下载:http://www.visualsvn.com/server/download/
对于大多数只进行源码版本控制的用户来说,TortoiseSVN无疑是首选。
TortoiseSVN下载:http://tortoisesvn.tigris.org/
如果不嫌麻烦的话,建议使用Apatch2.x手动配置版本,你可以到该网址下载
http://subversion.tigris.org/getting.html#windows
二、安装运行
将下载的 svn-win32-1.5.4.zip 解压到如“D:SVN”,生成bin,iconv,licenses,share等子目录,在bin下提供了很多命令行工具,如svnserve.exe、svnadmin.exe、svn.exe,使用--help可以获取帮助。
启动服务器:svnserve --daemon --root "E:svnRoot"
--root "E:svnRoot" 指定仓库根目录,服务器默认使用3690端口。
注册为服务:sc create SVNService binpath= ""D:svnbinsvnserve.exe" --service --root D:svnRoot" displayname= "SVNService" depend= Tcpip
注意这里 "D:svnbinsvnserve.exe" ,当path中含有空格时,需要"path"包含起来。另外命令中每个等号前面不能有空格,而等号后面必须有空格,不然命令是不会被执行的,也不会报错。
客户端的安装比较简单,运行TortoiseSVN-1.5.5.14361-win32-svn-1.5.4.msi,安装后重启计算机即可。
三、建立版本库
运行Subversion服务器需要首先要建立一个版本库(Repository),可以看作服务器上存放数据的数据库,有两种方法可以建立版本库:
1、 命令行方法:在命令行模式下,运行svnadmin create d:svnRootvwas,即可在d盘下创建一个版本库vwas。通常我们选用该方法。注意:版本库必须创建到根目录d:svnRoot,否则无法查找。(因为subversion对版本库采用子目录管理方法)
2、 界面操作方法:在d:svnRoot目录下,右键,选择TortoiseSVN下的“在此创建文件库”,文件库类型选择默认的“本地文件系统(FSFS)”,这样就会在该目录下创建一个版本库。(需要在服务器上安装TortoiseSVN)
repository创建完毕后会在目录下生成若干个文件和文件夹,dav目录是提供给Apache与mod_dav_svn使用的目录,让它们存储内部 数据;db目录就是所有版本控制的数据文件;hooks目录放置hook脚本文件的目录;locks用来放置Subversion文件库锁定数据的目录, 用来追踪存取文件库的客户端;format文件是一个文本文件,里面只放了一个整数,表示当前文件库配置的版本号;
四、配置权限
注意:subversion修改配置后无须重启服务。
进入版本库如d:svnRootvwasconf,有三个配置文件svnserve.conf、passwd、authz,修改时必须去掉#和前面的空格,否则会报错,=号两边允许空格。
svnserve.conf文件内容如下:(svnserve默认使用这些配置)
[general]
# anon-access = read (这两句是总纲,控制匿名用户的权限,既使authz中使用 * = rw 也无法打破,实际应用中这里可能设置为none,禁止匿名用户进行任何访问)
# auth-access = write
# password-db = passwd
# authz-db = authz
# realm = My First Repository
各参数定义如下:
anon-access:定义非授权用户的访问权限,有三种方式:none、read、write,设置为none限制访问,read为只读,write为具有读写权限,默认为read。
auth-access:定义授权用户的访问权限,有三种方式:none、read、write,设置为none限制访问,read为只读,write为具有读写权限,默认为write。
password-db:定义保存用户名和密码的文件名称,这里为passwd,和该文件位于同一目录。
authz-db:定义保存授权信息的文件名称,这里为authz,和该文件位于同一目录。
realm:定义客户端连接是的“认证命名空间”,Subversion会在认证提示里显示,并且作为凭证缓存的关键字。
subversion按版本目录来进行管理,只有在根目录下存在版本库目录,版本库才有效,如必须存在d:svnRootvwas,svn list svn://localhost/vwas才能执行成功。版本库conf下必须存在svnserve.conf,为了方便的进行多库管理,可以让所有版本库共用统一的用户和权限文件。
password-db = ../../passwd 将passwd放到svnRoot根目录,统一管理所有用户
authz-db = ../../authz
passwd文件内容如下:
[users]
# harry = harryssecret
# sally = sallyssecret
这里定义了两个用户harry和sally,用户密码分别是harryssecret和sallyssecret。同样,我们还可以定义自己的用户名和密码。如下面添加guest用户,密码空
guest =
authz文件内容如下:
[groups]
# harry_and_sally = harry,sally
# [/foo/bar]
# harry = rw
# * =
# [repository:/baz/fuz]
# @harry_and_sally = rw
# * = r
这里定义了组harry_and_sally,组在引用时需要@组名,*表示所有用户,包括匿名用户。使用组的好处是,往往在实际应用中,同一个仓库或目录并不只是一个用户访问,通常我们将用户编成dev开发组、test测试组、man管理组,doc文档组,分别进行权限分配,如
[vwas:/]
* =
[vwas:/doc]
@man = rw
@doc = rw
@dev = r
@test = r
[vwas:/srv]
@dev = rw
@test = r
[vwas:/test]
@test = rw
subversion按照[仓库名:目录]的格式进行权限分析,忽略仓库名时,如[/]表示对所有的版本库生效。由于设计subversion的大佬们习惯linux,到了windows下,他们仍然使用"/"来标识子目录。
尤其需要注意的是:
子目录继承父目录的访问权限,如果指定了管理员对根目录具有读写权限,则管理员对子目录也具有读写权限。
权限规则没有优先级,采用 “|” “&“的方式进行。
但是,如果在子目录中设置* = 来割断对父目录权限的继承,则子目录中必须设置管理员权限为rw,下面这种设置是有问题的:
[arm:/]
qianxin = rw
[arm:/diary/shanghai]
dai = rw
gongyu = rw
* = (这句表示割断除dai和gongyu以外所有用户的权限)
四、客户端使用
通常使用TortoiseSVN客户端,它是作为一个系统插件存在的。
导入版本库:在本地创建欲导入的目录,使用右键checkout菜单项,在URL of repository中输入如“svn://127.0.0.1/vwas“,确定之后输入用户名和密码即可完成导入。
其它操作请查TortoiseSVN使用手册。
命令行列举版本库: svn list svn://127.0.0.1/vwas
五、SVN命令行
创建新的版本库
svnadmin create /path/to/repository
svnadmin是有用的subversion系统管理命令,使用svnadmin help查看在线帮助
信息。
添加新的项目(import new project)
svn import project file:///repository_name/project -m "Comment"
svn import project http://yourhost/svn_dir/repository_name/project -m "Comment"
检出(checkout)项目
svn checkout file:///repository_name/project/trunk project
svn checkout http://yourhost/svn_dir/repository_name/project/trunk project
列出仓库中的项目(list)
svn list --verbose file:///repository_name/project
svn list --verbose http://host/svn_dir/repository_name/project
状态查询(status)
svn status
给出新文件,已经改变的文件和被删除的文件列表;
添加文件或目录(add)
svn add
删除文件或目录(delete)
svn delete
svn delete http://yourhost/svn_dir/repository/project_dir
提交(commit)
svn commit http://yourhost/svn_dir/repository/project_dir
更新(update)
svn update
更新仓库中的文件到本地。
标签和特殊版本项目
使用copy命令
svn copy http://yourhost/repos/project/trunk http://yourhost/repos/project/tags/1.0.0
用于创建某个特定版本的快照(snapshot);
svn list http://yourhost/repos/project/tags/1.0.0
六、版本库备份(这里引用了rocksun的《谈谈Subversion的备份》)
1. 完全备份
最常见和简单的备份就是直接使用拷贝命令,将版本库目录拷贝到备份目录上就可以了。但是,这样不是很安全的方式。因为如果在拷贝时版本库发生变化,将会造成备份的结果不够准确,失去备份的作用。为此Subversion提供了“svnadmin hotcopy”命令,可以防止这种问题。
如果要把vwas备份到d:svnrootbak目录下,只需要运行:
svnadmin hotcopy d:svnrootvwas d:svnrootbakvwas
但是我们作为配置管理员,必须想办法优化这个过程,如果我们这个目录下有许多版本库,需要为每个版本库写这样一条语句备份。为此我写了下面的脚本,实现备份一个目录下的所有版本库。我们在D:SVNROOT下创建了两个文件,第一个是simpleBackup.bat:
echo off
rem Subversion的安装目录
set SVN_HOME="D:Subversion"
rem 所有版本库的父目录
set SVN_ROOT=D:svnroot
rem 备份的目录
set BACKUP_SVN_ROOT=D:svnrootbak
@echo 正在备份版本库%1......
@%SVN_HOME%binsvnadmin hotcopy %SVN_ROOT%%1 %BACKUP_DIRECTORY%%2
@echo 版本库%1成功备份到了%2!
这个文件仅仅是对“svnadmin hotcopy”的包装,第二个是backup.bat:
echo off
rem Subversion的安装目录
set SVN_HOME="D:Subversion"
rem 所有版本库的父目录
set SVN_ROOT=D:svnroot
rem 备份的目录
set BACKUP_SVN_ROOT=D:svnrootbak
set BACKUP_DIRECTORY=%BACKUP_SVN_ROOT%%date:~0,10%
if exist %BACKUP_DIRECTORY% goto checkBack
echo 建立备份目录%BACKUP_DIRECTORY%>>%SVN_ROOT%backup.log
mkdir %BACKUP_DIRECTORY%
rem 验证目录是否为版本库,如果是则取出名称备份
for /r %SVN_ROOT% %%I in (.) do @if exist "%%Iconfsvnserve.conf" %SVN_ROOT%simpleBackup.bat "%%~fI" %%~nI
goto end
:checkBack
echo 备份目录%BACKUP_DIRECTORY%已经存在,请清空。
goto end
:end
在使用的时候,只需要修改backup.bat开头的三个路径,将两个脚本拷贝到“SVN_ROOT”下就可以了。根据以上的配置,你只需要运行backup.bat,就可以把“SVN_ROOT”下的版本库都备份到“BACKUP_SVN_ROOT”里,并且存放在备份所在日的目录里,例如“D:svnrootbak2006-10-22”。
虽然这部分工作很简单,可是必须有人定时地去执行这个操作(例如每周一凌晨)。为了避免发生遗忘的情况,我们可以将这个操作加入到系统的at任务当中去。例如还是上面的环境,为了安装at任务,我们运行:
at 1:00 /every:M D:svnrootbackup.bat
这样在每周一凌晨1:00都会执行这个备份过程。当然备份在本机也是不安全的,你也许需要上传到别的机器,这个就要靠你自己去实现了。
2. 增量备份
尽管完全备份非常简单,但也是有代价的。当版本库非常巨大时,经常进行完全备份是不现实,也是不必要的。但是一旦版本库在备份之间发生问题,该怎么办呢?这里我们就用到了增量备份。
增量备份通常要与完全备份结合使用,就像Oracle数据库的归档日志,记录着每次Subversion提交的变化,然后在需要恢复时能够回到最新的可用状态。在我们这个例子中我们使用的是svnadmin dump命令进行增量的备份。使用方法是:
svnadmin dump project1 --revision 15 --incremental > dumpfile2
上面的命令实现了对修订版本15进行增量的备份,其中的输出文件dumpfile2只保存了修订版本15更改的内容。
为了记录每次提交的结果,我们需要使用一项Subversion的特性——钩子(hook)。
hooks目录里存放的就是钩子脚本。我们在此处只使用post-commit钩子,这个钩子会在每次提交之后执行。为了实现我们的备份功能,我们在hooks下建立一个文件post-commit.bat,内容如下:
echo off
set SVN_HOME="C:Program FilesSubversion"
set SVN_ROOT=D:svnroot
set UNIX_SVN_ROOT=D:/svnroot
set DELTA_BACKUP_SVN_ROOT=D:svnrootbakdelta
set LOG_FILE=%1backup.log
echo backup revision %2 >> %LOG_FILE%
for /r %SVN_ROOT% %%I in (.) do if D:/svnroot/%%~nI == %1 %SVN_ROOT%%%~nIhooksdeltaBackup.bat %%~nI %2 (这里没有看懂,请高手指点?)
goto end
:end
通过这个脚本,可以实现D:svnroot下的版本库提交时自动增量备份到D:svnrootbakdelta(确定这个目录存在),其中使用的deltaBackup.bat其实可以放在任何地方,只是对脚本的svnadmin dump的包装,内容如下:
@echo 正在备份版本库%2......
%SVN_HOME%binsvnadmin dump %SVN_ROOT%%1 --incremental --revision %2 >> %DELTA_BACKUP_SVN_ROOT%%1.dump
@echo 版本库%2成功备份到了%1!
以上两个脚本可以直接拷贝到project2的hooks目录下,不需要修改就可以实现project2的自动备份。
以上的操作已经OK了,现在需要做的是将完全备份和增量备份结合起来,也就是在完全备份后清理增量备份的结果,使之只保存完全备份后的结果。
当果真出现版本库的故障,就要求我们实现版本库的恢复操作了。这时要使用svnadmin load命令,同时也需要上次的完全备份。例如要把上次完全备份backuprepo,和之后的增量备份dumpfile:
svnadmin load backuprepo < dumpfile
最后的结果可以下载svnroot.rar,将之解压缩到d:下,然后修改几个bat文件的SVN_HOME就可以使用了。
3. 版本库同步
Subversion 1.4增加了同步机制,可以实现一个版本库同另一个版本库的同步(但好像只是单向的),我们可以用来实现版本库的备份或镜像。
3.1 对目标库初始化
svnsync init svn://localhost/project2 svn://localhost/project1
其中project2是目标的版本库,而project1是源版本库。其中的目标版本库必须为空,而且必须允许修订版本属性的修改,也就是在目标的版本库的hooks目录里添加一个文件pre-revprop-change.bat,内容为空即可。
3.2 同步project2到project1
svnsync sync svn://localhost/project2
这时候你update一下你的project2的一个工作拷贝,就会发现有了project1的所有内容。如果project1又有提交,这时候project2的版本库无法看到最新的变化,还需要再运行一遍sync操作,这样才能将最新的变化同步。需要注意的是,目标版本库只能做成只读的,如果目标版本库发生了变更,则无法继续同步了。
3.3 同步历史属性的修改
因为同步不会更新对历史属性的修改,所以svnsync还有子命令copy-revprops,可以同步某个版本的属性。
3.4 钩子自动同步
希望在每次提交时同步,则需要在源版本库增加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的同步。
分享到:
相关推荐
### SVN使用手册知识点详解 #### 一、安装说明 **Subversion (SVN)** 是一款广泛应用的版本控制系统,尤其在软件开发领域中占有重要地位。本文档将详细讲解如何在Windows环境下安装配置SVN服务器及客户端,并进行...
Windows环境下安装SVN服务器的知识点主要包括以下几个方面: ...根据本文档提供的信息,操作人员可以完成Windows环境下SVN服务器的安装和配置,进一步学习和掌握SVN的基本使用技巧,从而有效地进行版本控制管理。
- **使用方式**:所有SVN命令通过Windows资源管理器的右键菜单执行。 ##### 2. 迁出配置库内容 - **步骤**: 1. 在本地硬盘创建文件夹,如“SVN”,并在其中创建空子文件夹。 2. 鼠标右键选择“SVN Checkout”。 ...
Windows下的SVN使用说明: 包括 各阶段中svn的使用方法介绍.doc TortoiseSVN-1.6.2-zh_CN.pdf(手册,中文) TortoiseSVN_en.chm(手册,英文) 用TortoiseSVN V1.6.2管理你的个人代码.pdf
SVN使用手册word打印版 本手册是关于SVN(Subversion)的使用手册,旨在帮助初学者快速了解SVN的基本原理和使用方法。通过阅读本手册,读者可以学习如何使用SVN实现版本控制,了解基本的菜单操作,并且结合...
在Windows XP下,Subversion服务器有时候看起来发送损坏的数据。 跟踪Subversion客户端和Apache服务器通话最好的方法是什么? 我刚刚编译了二进制分发版本,当我尝试检出Subversion,我得到一个“Unrecognized URL...
### Windows下svn初级...通过以上步骤,你可以轻松地在Windows环境下使用Subversion进行版本控制管理。无论是初始化项目、获取最新版本、修改文档、查看历史存档还是创建新的文件,Subversion都能为你提供强大的支持。
### SVN命令使用手册详解 #### 一、SVN简介与重要性 Subversion,简称SVN,是一款开源的版本控制系统,广泛应用于软件开发项目中,用于管理代码版本、协同开发和文档控制。SVN通过存储代码的历史版本,使得开发者...
本手册将详细介绍SVN的基本操作,包括修改访问密码、客户端安装与使用,以及日常开发中的各种维护工作。 1. 修改 SVN 访问密码 在多人协作的项目中,确保代码库的安全性至关重要。如果需要修改SVN服务器的访问密码...
PB源码管理SVN使用手册主要介绍了一种替代传统Visual SourceSafe(VSS)的源代码管理系统——Subversion(SVN),并提供了使用SVN管理PowerBuilder(PB)源码的详细步骤。以下是相关知识点的详细说明: 1. **Subversion...
本篇SVN使用手册详细介绍了如何使用客户端TortoiseSVN进行一系列操作,包括安装、建立项目版本库、使用流程以及解决常见问题。 **第一章 客户端TortoiseSVN安装** 安装TortoiseSVN时,用户可以通过双击下载的安装...
TortoiseSVN是一款直观的SVN客户端,与Windows资源管理器集成,提供了图形化的操作界面,简化了SVN命令的使用。例如,通过右键菜单可以进行导入、导出、更新、提交、添加/删除等操作。 5. **操作流程**: - **...
本手册主要介绍SVN的一些基础命令,帮助用户理解和掌握如何有效地使用SVN进行代码管理和协作。 1. **创建SVN仓库(Repository)** 使用`svnadmin create`命令可以创建一个新的SVN仓库。例如,在Windows环境下,...
《Tortoise SVN 使用手册》全面解析 Tortoise SVN是一款强大的版本控制系统客户端,它以图形化界面的形式集成在Windows操作系统中,使得Subversion(SVN)的使用变得更加直观和便捷。本手册将深入探讨Tortoise SVN...
【SVN使用手册(Tortoise)】:SVN(Subversion)是一款版本控制系统,而TortoiseSVN是其在Windows环境下的一款图形化客户端。本文档主要针对开发人员,指导如何利用TortoiseSVN进行版本控制操作。 **一、基本操作** ...
### Tortoise SVN 使用手册知识点详解 #### 一、版本控制概览 **版本控制**是一项重要的软件工程实践,主要用于管理项目开发过程中多个开发者对同一文件的编辑与协作。通过版本控制系统,开发团队能够确保文件的...
"TortoiseSVN.pdf"是TortoiseSVN的用户手册,TortoiseSVN是一款Windows下的SVN客户端,它提供了图形化的界面,使得用户可以方便地进行版本控制操作。该手册会涵盖如何安装TortoiseSVN,创建版本库,检出、提交、更新...
### Eclipse下SVN使用操作全解析 在Java开发领域,特别是在大中型项目中,团队协作几乎是不可避免的。为了确保代码的一致性与版本管理,使用版本控制系统如SVN(Subversion)成为了一种标准实践。本文将详细介绍...