`

Windows下SVN使用手册

 
阅读更多

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使用手册

    ### SVN使用手册知识点详解 #### 一、安装说明 **Subversion (SVN)** 是一款广泛应用的版本控制系统,尤其在软件开发领域中占有重要地位。本文档将详细讲解如何在Windows环境下安装配置SVN服务器及客户端,并进行...

    Windows下安装SVN服务器

    Windows环境下安装SVN服务器的知识点主要包括以下几个方面: ...根据本文档提供的信息,操作人员可以完成Windows环境下SVN服务器的安装和配置,进一步学习和掌握SVN的基本使用技巧,从而有效地进行版本控制管理。

    SVN使用手册大全(史上最全)-pdf版.pdf

    - **使用方式**:所有SVN命令通过Windows资源管理器的右键菜单执行。 ##### 2. 迁出配置库内容 - **步骤**: 1. 在本地硬盘创建文件夹,如“SVN”,并在其中创建空子文件夹。 2. 鼠标右键选择“SVN Checkout”。 ...

    Windows SVN使用,Tortoise SVN 1.6 使用手册

    Windows下的SVN使用说明: 包括 各阶段中svn的使用方法介绍.doc TortoiseSVN-1.6.2-zh_CN.pdf(手册,中文) TortoiseSVN_en.chm(手册,英文) 用TortoiseSVN V1.6.2管理你的个人代码.pdf

    SVN使用手册word打印版

    SVN使用手册word打印版 本手册是关于SVN(Subversion)的使用手册,旨在帮助初学者快速了解SVN的基本原理和使用方法。通过阅读本手册,读者可以学习如何使用SVN实现版本控制,了解基本的菜单操作,并且结合...

    SVN使用手册中文版快速入门

    在Windows XP下,Subversion服务器有时候看起来发送损坏的数据。 跟踪Subversion客户端和Apache服务器通话最好的方法是什么? 我刚刚编译了二进制分发版本,当我尝试检出Subversion,我得到一个“Unrecognized URL...

    Windows下svn初级使用手册

    ### Windows下svn初级...通过以上步骤,你可以轻松地在Windows环境下使用Subversion进行版本控制管理。无论是初始化项目、获取最新版本、修改文档、查看历史存档还是创建新的文件,Subversion都能为你提供强大的支持。

    SVN使用手册大全(史上最全)1

    本手册将详细介绍SVN的基本操作,包括修改访问密码、客户端安装与使用,以及日常开发中的各种维护工作。 1. 修改 SVN 访问密码 在多人协作的项目中,确保代码库的安全性至关重要。如果需要修改SVN服务器的访问密码...

    pb源码管理SVN使用手册

    PB源码管理SVN使用手册主要介绍了一种替代传统Visual SourceSafe(VSS)的源代码管理系统——Subversion(SVN),并提供了使用SVN管理PowerBuilder(PB)源码的详细步骤。以下是相关知识点的详细说明: 1. **Subversion...

    SVN使用手册(PPT版)

    本篇SVN使用手册详细介绍了如何使用客户端TortoiseSVN进行一系列操作,包括安装、建立项目版本库、使用流程以及解决常见问题。 **第一章 客户端TortoiseSVN安装** 安装TortoiseSVN时,用户可以通过双击下载的安装...

    SVN使用手册200809.ppt

    TortoiseSVN是一款直观的SVN客户端,与Windows资源管理器集成,提供了图形化的操作界面,简化了SVN命令的使用。例如,通过右键菜单可以进行导入、导出、更新、提交、添加/删除等操作。 5. **操作流程**: - **...

    SVN命令使用手册.doc

    本手册主要介绍SVN的一些基础命令,帮助用户理解和掌握如何有效地使用SVN进行代码管理和协作。 1. **创建SVN仓库(Repository)** 使用`svnadmin create`命令可以创建一个新的SVN仓库。例如,在Windows环境下,...

    Tortoise SVN 使用手册

    《Tortoise SVN 使用手册》全面解析 Tortoise SVN是一款强大的版本控制系统客户端,它以图形化界面的形式集成在Windows操作系统中,使得Subversion(SVN)的使用变得更加直观和便捷。本手册将深入探讨Tortoise SVN...

    SVN使用手册(Tortoise)

    【SVN使用手册(Tortoise)】:SVN(Subversion)是一款版本控制系统,而TortoiseSVN是其在Windows环境下的一款图形化客户端。本文档主要针对开发人员,指导如何利用TortoiseSVN进行版本控制操作。 **一、基本操作** ...

    Tortoise SVN使用手册

    ### Tortoise SVN 使用手册知识点详解 #### 一、版本控制概览 **版本控制**是一项重要的软件工程实践,主要用于管理项目开发过程中多个开发者对同一文件的编辑与协作。通过版本控制系统,开发团队能够确保文件的...

    SVN管理手册-中文

    "TortoiseSVN.pdf"是TortoiseSVN的用户手册,TortoiseSVN是一款Windows下的SVN客户端,它提供了图形化的界面,使得用户可以方便地进行版本控制操作。该手册会涵盖如何安装TortoiseSVN,创建版本库,检出、提交、更新...

    Eclipse下SVN使用操作手册

    ### Eclipse下SVN使用操作全解析 在Java开发领域,特别是在大中型项目中,团队协作几乎是不可避免的。为了确保代码的一致性与版本管理,使用版本控制系统如SVN(Subversion)成为了一种标准实践。本文将详细介绍...

Global site tag (gtag.js) - Google Analytics