SVN配置详解

windows系统使我们经常使用的操作系统怎么才能使用我们现在经常使用的操作系统不变的情况下继续我们的SVN之旅，我们在综合了好动种方法的同时感觉这些内容非常贴近我们SVN在Windows种的应用与配置.

1.下载文件，

下载最新版本subversion,我这里选择svn-1.4.5-setup.exe

下载 "Subversion Windows Service" 软件包

下载 TortoiseSVN shell integration utility

2.安装Subversion 服务器

由于我下载的是setup.exe版本,安装程序安装后会自动设置系统变量.如果你下载的是zip版就需要手动设置系统变量.

setup.exe版直接安装就可以了.安装到D:/Program Files/Subversion

首先创建SVN储存库(repository)

svnadmin create F:/svn/

repository创建完毕后会在目录下生成若干个文件和文件夹，dav目录是提供给Apache与mod_dav_svn使用的目录，让它们存储内部数据；db目录就是所有版本控制的数据文件；hooks目录放置hook脚本文件的目录；locks用来放置Subversion文件库锁定数据的目录，用来追踪存取文件库的客户端；format文件是一个文本文件，里面只放了一个整数，表示当前文件库配置的版本号；

3.配置SVN服务器

（这个位置就是在你建储存库的地方F:/svn）

打开/conf/目录，打开svnserve.conf找到一下两句：

# [general]

# password-db = passwd

# anon-access = none

# auth-access = write

去之每行开头的#，其中第二行是指定身份验证的文件名，即passwd文件.anon-access = none 是匿名用户不能访问，必须要有用户名和密码。（注意：问题就出在这，一定要注意格式去掉注释后要顶格不能有空）

同样打开passwd文件，将

# [users]

# harry = harryssecret

# sally = sallyssecret

       格式为“用户名 = 密码”，如可插入一行：admin = admin888，即为系统添加一个用户名为admin，密码为admin888的用户

4.运行SVN服务器

运行SVN服务

在命令行执行

svnserve --daemon --root F:/svn

服务启动，--daemon可简写为-d，--root可简写为-r，可以建立一个批处理文件并放在windows启动组中便于开机就运行SVN服务（注意：这是临时打开的服务，命令执行后不能关闭窗口）

用后台服务的方式可以设置开机自动执行。

D:/Program Files/Subversion/bin>sc create svnservice binpath= "d:/Program Files/

Subversion/bin/svnserve.exe --service -r F:/SVN"

就可以用net svnservice stop 或者start来启动服务了 也可以在Sevices.msc来启动了。

5、用客户端访问

格式：svn://服务器IP

 

需要注意，SVN服务器是区分大小写的

常见问题FAQ

---------------------------------------------------------------------------------------------------------

1. 监听端口变更

Subversion有两种不同的配置方式，一种基于它自带的轻量级服务器svnserve，一种基于非常流行的Web服务器Apache。

根据不同的配置方式，Subversion使用不同的端口对外提供服务。

基于svnserve的，默认端口为3690，

基于Apache的，默认端口为Apache的默认端口80。

有时候，我们会因为防火墙或其它原因，需要修改这些默认端口。

下面根据不同的配置讲讲如何改变这些默认端口。

1、通过svnserve -d -r d:\svn来提供服务 （假设d:\svn为你的版本库所在目录）

为svnserve 加上--listen-port参数，比如svnserve -d -r d:\svn --listen-port 81

2、通过Apache来提供服务

在httpd.conf中，查找Listen 80，将80修改为你想要的端口

2. 多版本库配置

      首先其实svnserve -d -r path中的path并不一定要指向一个版本库,我们多版本库管理的时候可以建一个svnroot目录(名字自取,习惯上用这个比较明了),而且这一点也关系到了版本库目录下的conf目录中的配置文件的设置.多库管理的时候我们通常把conf 文件中的authz和passwd文件移到svnroot下,然后把conf中的svnserve.conf文件中的
password-db = passwd 
authz-db = authz
改成
password-db =http://www.cnblogs.com/passwd 
authz-db = http://www.cnblogs.com/authz

或改成

password-db = ..\..\passwd 

authz-db =..\..\authz

然后设置authz的时候把
# [repository:/baz/fuz]
# @harry_and_sally = rw
# * = r
的#去掉,repository改成对应的库名称,后面的路径改成库内对应的路径,比如库中根目录则用/表示,[库名字:/]这种格式写,说道这里有很多人写了这配置之后再用设置好的帐号去登录会出现认证失败的问题,这个问题网上我找了很多资料,没发现说的到位的,所以我这特别强调下,其实这个错误不是设置错误而是登录时的URL错了,比例本机的访问,list命令应该这样
svn list svn://127.0.0.1/库名字
而不是svn list svn://127.0.0.1
虽然你前面设置帐号的时候指定了这个帐号是登录到哪个库的,但是svnserve似乎不管你这个.
还有一个细节问题就是在windows下把svn作为service启动时的启动命令要注意的地方,
sc create svnservice binpath= "\"D:\Program Files\Subversion\bin\svnserve.exe\" --service -r E:\svnroot" displayname= "SVNService" depend= Tcpip 
命令中每个等号前面不能有空格,而等号后面必须有空格,不然命令是不会被执行的,也不会报错. 

3. 多版本库配置问题

基于svnserve的服务器，权限文件authz配置的常见问题及解答  
 最近在我用Subversion论坛(http://www.iUseSVN.com/bbs)经常有人提到这样的问题： 
为什么我的客户端没有写权限？ 
为什么我的权限没有起作用？

总结他们的配置，发现
都是用svnserve作为服务器，
都在svnserve.conf中使用了authz-db选项

原因可能如下：

1，配置authz时，没有注意svnserve启动参数-r所指定的目录。
这里有两种情况：
A:-r直接指定到版本库(称之为单库svnserve方式)
比如，有一个库project1，位于D:\svn\project1
使用以下命令启动svnserve

1. svnserve -d -r D:\svn\project1

复制代码

在这种情况下，一个svnserve只能为一个版本库工作
authz文件如果配置成下面这样就是错的，

1. [groups]
   
2. admin=user1
   
3. dev=user2
   
4. [project1:/]
   
5. @admin=rw
   
6. @doc=r

复制代码

应该配置成

1. [groups]
   
2. admin=user1
   
3. dev=user2
   
4. [/]
   
5. @admin=rw
   
6. @doc=r

复制代码

因为[project1:/]表示库project1的根目录，而按上面的启动参数，是没有库的概念的。
使用类似这样的URL：svn://192.168.0.1/　即可访问project1

B:-r指定到版本库的上级目录(称之为多库svnserve方式)
同样，有一个库project1，位于D:\svn\project1
如果使用以下命令启动svnserve

1. svnserve -d -r D:\svn

复制代码

这种情况，一个svnserve可以为多个版本库工作，
这时如果想限制指定库的指定目录，就应该指定具体的库，像这样

1. [groups]
   
2. admin=user1
   
3. dev=user2
   
4. [project1:/]
   
5. @admin=rw
   
6. @doc=r

复制代码

如果此时你还用[/]，则表示所有库的根目录，同理，[/src]表示所有库的根目录下的src目录
使用类似这样的URL：svn://192.168.0.1/project1　即可访问project1
这样的URL：svn://192.168.0.1/project2　即可访问project2

2，对中文目录进行权限控制时，没有将权限文件authz改为utf-8格式。

svn对于非英文文件名和目录名使用utf-8格式编码处理，要对中文目录进行正确控制，
应该使用无BOM的utf-8格式，如何将默认的文件转为utf-8，

我使用的是UltraEdit的菜单"ASCII to UTF-8 (Unicode Editing)"。在UltraEdit的配置中，可以设置有无BOM

下面举个例子说一下

背景假设
--------

厦门央瞬公司是一家电子元器件设备供应商，其中有个ARM部门，专门负责ARM芯片的方案设计、销售，并在北京、上海各设立了一个办事处。对于工作日志，原先采用邮件方式发给经理，但是这种方式有个缺点，那就是不具备连续性，要看以前的日志必须一封一封邮件去查看，很麻烦。于是就想到利用 Subversion， 让员工在自己电脑上编辑日志，然后利用svn传送回来，既方便员工自己编写日志，又方便对日志的归档处理，而且提交日志的时候只需要执行一下 svn commit即可，比发送邮件还要简单的多。

- svn服务器相关信息

  - 服务器地址： 192.168.0.1
  - 服务器OS： MS Windows 2000 Server Edition 中文版
  - 用于存放日志的代码库本地目录： ``D:\svn\arm``

- arm部门文档的目录结构如下::

    arm                 部门名称
    ├─diary           工作日志目录
    │  ├─headquarters    总部工作日志目录
    │  ├─beijing         北京办日志目录
    │  └─shanghai        上海办日志目录
    ├─ref             公司公共文件参考目录
    └─temp            临时文件目录

- 人员情况

  - morson，公司总经理，不习惯使用电脑，更喜欢传统的纸与笔，以及面对面的交流
  - michael，arm事业部的部门经理，没事的时候喜欢弄点儿新技术，用svn来管理日志，就是他想出来的主意
  - scofield，北京办人员，老员工，为人油滑难管
  - lincon，上海办人员，老员工，大老实人一个
  - linda，总部协调员、秘书，文笔不错，长得也不错
  - rory，单片机技术员，技术支持

- 访问权限需求分析

  - 允许总经理、部门经理读取所有文件。顺便给他们开放写权限，以便体现对他们职位的尊重，虽然对于某些文件来说，他们若拥有“写”权限其实也没什么用处
  - 除部门经理外，所有其他人员，均只能看到本办事处人员工作日志
  - 不允许匿名访问
  - ref目录只允许经理和秘书读写，对其他人只读
  - temp目录人人都可以随意读写


使用 svnserve.exe 作为 Subversion 服务器
----------------------------------------
本节描述如何利用 svnserve.exe 来作为代码库服务器端，实现上述功能。至于另外一种代码库服务器端，即利用 Apache 结合 mod_dav_svn.so 来实现的代码库服务器端，由于其对于本文叙述的内容“实现精细的目录访问权限控制”而言，与前者没有太大的区别，故而略过不提。它们二者只是在初次安装、配置方面存在一些不同，有兴趣的读者，可以参考其他文档，重新实验下述步骤。


启动 Subversion 服务
````````````````````
在服务器端，打开一个命令行窗口，用CD命令进入 Subversion 安装目录下的 bin 目录，运行如下指令::

    svnserve -d -r d:\svn

其中的 -d 参数表示 svnserve.exe 将会作为一个服务程序运行在后台，而 -r 参数表示将 ``D:\svn`` 目录指定为代码库的根目录。这样，当客户端使用类似 svn://192.168.0.1/foo 这样内容的 URL 来访问服务器时候，其所访问到的真实代码库，其实就是 ``D:\svn\foo``

用上述命令行方式启动的 svn 服务有个小缺点，就是在本试验过程中，服务器端必须要一直开着那个运行了上述命令的DOS窗口，不能关闭它。如果不想看到这个窗口，可以将 svnserve 安装成windows 的一个 services，安装方式请参考其他文章。


建立代码库
``````````
在服务器端的 ``D:\svn`` 目录下，建立一个名为 arm 的代码库，命令如下::

    D:\svn>svnadmin create arm

使用上述命令之后，如果不出问题的话，在 ``D:\svn`` 目录下就会多出一个叫做 ``arm`` 的目录，其下具备 conf、dav、hooks、locks、db 等子目录或文件，此即 **一个名为arm的代码库** 。从此，通过 ``svn://192.168.0.1/arm`` 这样的 URL，我们就可以对这个代码库进行访问了。接下来就要进入本文的正题了，也就是权限配置部分了。

其实进入 ``arm\conf`` 目录你就会发现，它下面已经存在三个写了一些帮助信息和示例的配置文件，以帮助用户尽早掌握其配置方法。这三个默认的配置文件分别是 svnserve.conf、passwd、authz 。其中后两者没有后缀，对于 windows 系统的用户来说，看起来总是有些怪异，所以在接下来的章节里面，我将它们两个都给添加了个 conf 后缀，以便管理。


编辑代码库基础配置文件
``````````````````````
在服务器端，编辑代码库的 ``arm\conf\svnserve.conf`` 文件，如下::

    [general]
    password-db = passwd.conf
    anon-access = none
    auth-access = write
    authz-db = authz.conf


管理用户帐号
````````````
在服务器端，新建 ``arm\conf\passwd.conf`` 文件，如下::

    [users]
    morson = ShowMeTheMoney
    michael = mysecretpassword
    scofield = hellolittilekiller
    lincon = asyouknows111
    rory = 8809117
    linda = IlikeWorldCup2006


建立目录访问权限控制文件
````````````````````````
在服务器端，新建 ``arm\conf\authz.conf`` 文件，内容如下::

    [groups]
    g_vip = morson
    g_manager = michael
    g_beijing = scofield
    g_shanghai = lincon
    g_headquarters = rory, linda
    g_docs = linda

    [arm:/]
    @g_manager = rw
    * = r

    [arm:/diary/headquarters]
    @g_manager = rw
    @g_headquarters = rw
    @g_vip = r
    * =

    [arm:/diary/beijing]
    @g_manager = rw
    @g_beijing = rw
    @g_vip = r
    * =

    [arm:/diary/shanghai]
    @g_manager = rw
    @g_shanghai = rw
    @g_vip = r
    * =

    [arm:/ref]
    @g_manager = rw
    @g_docs = rw
    * = r

    [arm:/temp]
    * = rw


导入代码
````````
在客户机 ``F:\temp`` 目录下，建立好前述“背景假设”一节中描述的目录结构，然后用命令 ``F:\temp>svn import arm svn://192.168.0.1/arm --username michael --password mysecretpassword`` 导入整个目录结构。

这条指令的精确意思是，将 arm 目录下面的所有东西，导入到那个名叫 arm 的代码库中去。如果你不指定源目录，则 svn 会默认将当前目录作为源目录。比如说，你处于 ``F:\temp`` 目录下的时候，直接执行 ``svn import svn://192.168.0.1/arm`` ，那么当你取出你的代码的时候，你会发现，居然多了一层名为 arm 的目录。结果，你就必须使用类似  ``svn://192.168.0.1/arm/arm`` 这样怪异的URL，才能够正确访问到你的代码们。

这一点粗看好像不是特别重要，不过联想到前述的目录授权规则，可都是按照标准的项目目录结构来设计的。突然之间，你项目的根目录之上，多出了一个名为 arm 的目录，那么我们的所有目录授权规则，基本上都要全部改过了，否则除了根目录，你永远会得到一个莫名其妙的“access denied”。由于 Subversion 在这一步骤上的界面不够人性化，因此这是初学者很容易弄混的地方之一。


测试
````
在服务器上，打开一个 DOS Prompt 窗口，输入如下指令::

    svn co svn://127.0.0.1/arm --no-auth-cache --username rory --password 8809117

我们应该得到如下目录结构::

    arm
    ├─diary
    │  └─headquarters
    ├─ref
    └─temp

然后修改ref目录下任意文件并提交，服务器将会报错“Access denied”，Bingo!