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/

posted @ 2012-05-25 11:19  水芊芊  阅读(3786)  评论(0编辑  收藏  举报