Ubuntu上Subversion的安装和配置

环境：Ubuntu10.10

目的：可本地或通过Web访问Subversion。

SVN最常见的配置模式便是与Apache集成，这样SVN可以采用WebDev协议方式提供服务。主要的好处有：通过Apache以HTTP方式穿透防火墙，便于在互联网环境使用；提供目录的版本控制；纯2进制的文件对比方式等。

1. 安装Subversion

apt-get install subversion
apt-get install subversion-tools

2. 安装Apache

apt-get install apache2
apt-get install libapache2-svn

3. Apache和Subversion的集成

查看/etc/apache2/mods-enabled/dav_svn.load文件，有mod_dav_svn.so和mod_authz_svn.so这两个动态库说明apache已经加载了Subversion的访问控制模块。如果没有，手动添加。

编辑/etc/apache2/mods-enabled/dav_svn.conf文件，在最后加入下述内容：

<Location /svn>
DAV svn
SVNParentPath /home/svn
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /home/svn/passwd.conf
AuthzSVNAccessFile /home/svn/authz.conf
Require valid-user
</Location>

命令touch /home/svn/passwd.conf和touch /home/svn/authz.conf来创建这2个不存在的文件。

<Location /svn>　　意思是Subversion版本可用的URL是http://SubversionServerIP/svn

DAV SVN　　告诉Apache是哪个模块响应哪个URL的请求，在这里是Subversion模块

SVNParentPath /home/svn　　告诉Subversion需要查看的版本库在/home/svn之下。如果不希望为每个单独的项目都进行单独的设置，可以把所有项目都存放在统一的资源库目录，使用SVNParentPath指令来指定存放所有项目的路径。否则使用SVNPath

SVNPath　　单版本库时使用此项指明版本库的路径，但在多版本库中不要使用此项

AuthType Basic　　认证类型为基本认证，就是用户名和密码

AuthName "Subversion repository"　　认证名称，将在浏览器界面弹出一个对话框，标题为Subversion repository

AuthUserFile /home/svn/passwd.conf　　指定使用的认证密码文件，即访问版本库用户的文件，用apache的htpasswd命令生成

AuthzSVNAccessFile /home/svn/authz.conf　　设定访问版本库权限的文件

Require valid-user　　要求验证用户，即不能匿名访问。如果没有该语句，则只能第一个用户可以访问新建库

此外，SVNIndexXSLT “/svnindex.xsl”　　使用它可以在用浏览器时更好看

4. 在添加了上述内容后，必须重启Apache2 HTTP服务器

/etc/init.d/apache2 restart

5. Subversion建立版本库

mkdir /home/svn
mkdir /home/svn/repos
svnadmin create --fs-type fsfs /home/svn/repos

运行创建版本库的命令，指定数据存储为 FSFS，如果要指定为 Berkeley DB，则将 fsfs 替换为 bdb。

如果一切正常，命令执行后没有任何反馈信息而迅速返回。一个新的版本库就被创建出来。我们可以查看下版本库里有什么。

其中，conf 目录下存放了版本库的配置文件，包括用户访问控制和权限控制等内容；dav 目录是提供给 Apache 相关模块的目录，目前为空；db 目录下存放着 Subversion 所要管理的所有受版本控制的数据，不同的存储方式（Berkeley DB 或者 FSFS）下有着不同的目录结构，不过我们一般不用直接修改和查看这个目录下的内容，Subversion 的命令可以安全的操作这个目录；另外，hooks 目录存放着钩子脚本及其模版（一种版本库事件触发程序），locks 目录存放着 Subversion 版本库锁定数据，用来追踪存取文件库的客户端；format 文件是一个文本文件，里面只放了一个整数，表示当前文件库配置的版本号。

注意：库与库之间不能包含。

我们可以测试下Subversion能不能检出。

6. Subversion添加项目

管理员必须考虑的问题是，将每一个项目分别放在不同的版本库里面，还是将它们放在统一的版本库里面。统一的版本库可以让管理员更加容易的升级和备份，不过，由于访问权限控制是针对整个版本库的，所以，统一的版本库也为不同项目配置不同的访问权限带来了麻烦。所以，管理员应该根据实际情况权衡考虑。
我以统一的版本库为例，添加三个项目business，develop和project。首先在一个临时目录下，根据 Subversion 版本控制的一般布局结构，创建出三个项目的主要目录树，如下：

然后用 svn import 命令导入已有的目录树。

svn import /home/svn/tmp/ file:///home/svn/repos/ --message "init"

可以用 svn list 确认导入的项目是否正确：

svn list --verbose file:///home/svn/repos/

如果要查看最新修订版本的信息，可以使用 svnlook info 命令：

svnlook info /home/svn/repos/

还可以在命令后面接上 “--revision 版本号” 来指定某一个修订版的显示。

还可以用如下命令来显示版本库的具体树形结构，后面的 “--show-ids” 选项指定显示每一个显示元素的修改版本 ID。

svnlook tree /home/svn/repos/ --show-ids

7. Subversion添加用户

添加第一个用户，要加参数-c。以后不用加。

htpasswd -c /home/svn/passwd.conf user1

Subversion追加用户：

htpasswd /home/svn/passwd.conf user2

passwd.conf文件的生成内容是用户名加上密码的 MD5 密文。

8. Subversion分配用户权限

新添加的用户是不能访问Subversion的，还要为他分配权限。编辑/home/svn/authz.conf文件，例：

[groups]
vip = wang
admin = wangqixuan, yang
develop-manager = zhong
business-manager = shi
developer = ma, hu, zhou, cen, huang

[repos:/]
@admin = rw
* = r

[repos:/develop/01-Windows项目组/01-ARM架构]
@vip =rw
@admin = rw
@develop-manager = rw
* =
[repos:/develop/01-Windows项目组/02-X86架构]
@vip =rw
@admin = rw
@develop-manager = rw
zhou = rw
hu =rw
ma = r
* =

[repos:/develop/02-Linux项目组/01-ARM架构]
@vip =rw
@admin = rw
@develop-manager = rw
cen = r
huang = r
* = 

[repos:/develop/02-Linux项目组/02-X86架构]
@vip =rw
@admin = rw
@develop-manager = rw
cen = r
huang = r
* =

[repos:/develop/个人目录]
@vip =rw
@admin = rw
@develop-manager = rw
@developer = rw
* = 

其中* = 表示其它所有用户都没有任何权限。@表示用户组，*表示所有用户，[/]表示全部目录。注意顶格写。UTF-8格式才能配置SVN权限，Linux下默认是UTF-8，Windows下有转换工具，比如Eclipse->Edit->最后一项。一般针对最末梢文件设置权限。

特别注意：权限分配时，不能写成cen, huang =r，这样提交时会出现错误：svn Commit failed checkout of 403 forbidden。应该写成cen = r和huang = r

9. Subversion启动

svnserve -d -r /home/svn

Subversion 设计了一个抽象的网络层，版本库建立完毕之后，可以通过各种服务器向外公布。svnserve 是 Subversion 自带的一个小型的服务器，它使用独立的协议与客户端。–i 作为 inetd 启动。-d参数表示svnserve将会作为一个服务程序运行在后台。-r参数表示将/home/svn指定为代码库的根目录。这样，当客户端使用类似svn://192.168.0.1/repos这样的URL访问服务器的时候，其所访问的真实库是/home/svn/repos。另外如 --listen-port，--listen-host 可以指定绑定的地址和端口，-R 可以强制设定为 Read-Only 模式。

下面命令可检查是否成功启动：

ps -ef | grep svn

10. SVN客户端的安装及简单使用

TortoiseSVN下载地址：http://tortoisesvn.net/downloads.html

在Win7上新建文件夹作为本地副本的存储目录，单击右键，选择TortoiseSVN->Repo-browser，在弹出框URL中添加Subversion的访问地址http://ServerIP/svn/repos

Check Out取出服务器上的版本库到本地。

详细使用见http://cdnetworks-kr-2.dl.sourceforge.net/project/tortoisesvn/1.7.7/Documentation/TortoiseSVN-1.7.7-zh_CN.pdf

chown -R www-data:www-data /home/svn/repos
可解决在客户端提交时出现subversion can't open file “xxx”Permission denied的问题

注：为了以后备份方便，可将passwd.conf和authz.conf两个文件放在repos/conf下，相应地也改动Apache2配置文件里<Location>字块所指路径，重启Apache2。

【参考资料】

用 Apache 和 Subversion 搭建安全的版本控制环境 https://www.ibm.com/developerworks/cn/java/j-lo-apache-subversion/