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的同步。