1、安装必要软件包
http://wiki.xasoft.org:8090/svn/xasoftorg
http://wiki.xasoft.org:8090/svn/xasoftorg/
我 们假设您已经正确的安装了Debian系统。
SVN最常用的方式是通过Apache2使用(其他方式本文不会涉及,最主要是我也没做 过.^_^),因此需要安装apache2。在一般情况下,我的服务器上会安装php,因为我选择了apache的apache2-mpm- prefork包。安装命令:
shell#apt-get install apache2-mpm-prefork libapache2-svn subversion
Debian的包管理系统会自动安装缺少的包。
2、配置
svn作为apache2的一个模块,配置文件在Debian下位于/etc/apache2/mods-available /dav_svn.conf(其他发行版或许有所区别)。首先我们看一个配置文件示例:
<Location /svn>
DAV svn
SVNParentPath /var/svnroot
AuthzSVNAccessFile /etc/apache2/dav_svn.authz
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
Require valid-user
</Location>
说明:
a)第一行:<Location /svn>表示svn仓库位于/svn虚拟目录下面(Location的作用有点类似Alias的作用)。当然你可以的目录,比 如<Location /src>。那么这样配置一般您将可以通过浏览器http://hostname/svn进行浏览(如果权限足够的话)。
b)第二行:DAV svn表示dav启用svn支持。
c)第三行:SVNParentPath /var/svnroot表示使用SVNParent方式,并且仓库的物理路径为/var/svnroot.SVN支持两种对项目的管理方式,一种是 SVNParent,另一种是SVNParentPath。使用这种方式添加一个新项目是不需要重启 apache的,而另一种方式则需要。对于一个实际使用的服务器来说,是否需要常常重启是一件很重要的事情了。这儿的/var/svnroot目录必须是 存在而且目录的属主应该为apache的用户(Debian下一般为www-data)。mkdir -p /var/svnroot;chown -R www-data:www-data /var/svnroot。注意:配置文件默认的是SVNPath,即使用的后一种方式。
d)第四行:AuthzSVNAccessFile /etc/apache2/dav_svn.authz。表示用户权限文件是/etc/apache2/dav_svn.authz(权限文件的写法我在 后面再说)。文件可以位于任意其他位置。
e)第五至八行:是apache的配置,使用使用apache的用户文件作为身份验证,需且要求有效用户才可以访问。
配置完成后,进入/etc/apache2/mods_enabled查看指向dav_svn.conf和dav_svn.load的文件链接是否存在 (apache据此启动模块)。
3、创建用户文件
在dav_svn.conf的注释中已经说明了创建用户文件的方法:
htpasswd -c /etc/apache2/dav_svn.passwd loglou
添加用户loglou到/etc/apache2/dav_svn.passwd文件中,如果文件不存在,则创建。
4、建立项目仓库
根据上面一节的规划来创建你的仓库。
1) 创建仓库
$ svnadmin create /path/to/repos
观察repos目录结构
2) 根据仓库规划,创建临时目录:
$mkdir tmpdir
$cd tmpdir
$mkdir boss (boss在这里是project name)
$mkdir boss/trunk
$mkdir boss/tags
$mkdir boss/branches
3) 添加上面创建的目录结构到1)中创建的仓库中去
$svn import . file:///path/to/repos –message ‘Initial repository layout’
方法2:
我们假设您的配置的SVNParentPath目录是/var/svnroot。进入/var/svnroot,此时目录应该是空的。
创建一个项目仓库分为三个步骤:a)建立目录b)使用svnadmin初始化新项目目录c)将目录属主改为apache的用户(本文中我们都假设您使用默 认为www-data用户)。
我写了一个小脚本(假设文件名为createnew):
#!/bin/bash
echo "Create a new resposity ..."
mkdir $1
svnadmin create $1
chown -R www-data:www-data $1
很简单,三条命令。用法:./createnew test,则我们就建立了一个test项目。建立其他项目也一样,比如:./createnew project1
执行完以后再查看一下目录情况下。我们可以进入test目录看看,它不象CVS一样,你能够看到什么,因为svn使用了Berkeley数据库来存放代 码.
5、建议权限文件(authz)
svn授权粒度可以是单独用户,也可以是用户组。
svn的权限分为三种:无权限,读权限,读写权限。无权限当然是禁止访问,读权限也就是说有浏览权限,你可以checkout代码,但不能提交。读写权限 当然是最大权限了,读写添加删除都可以。
svn的授权深度是它最大的特点了,它不仅可以对整个项目授权,甚至于它可以对项目下的某个目录,某个文件进行单独授权。我认为这是非常有用的一个功能。
咱们还是先来看一个文件示例吧:
[groups]
manager = qsg
user = user1,user2
[test:/]
@manager = rw
user1 = r
user2 =
[test:/file1]
@manager = rw
user1 =
user2 = rw
先来解释一下吧:
a)groups区段,就如它的名字所说的那样,是定义用户组用的。比如在示例文件中定义了两个组maanger组和user组。
b)项目区段,每一个区段是一个授权单位。比如示例中有两个项目区段test:/和test:/file1。对于test:/表示对test项目的根目录 授权,test:/file1表示对test项目下的/file1文件授权(目录也是一样)。如果我们还需要对test项目的dir1目录进行授权,则我 们需要再增加一个test:/dir1区段。
c)授权。如果要对某个项目的某部分进行项目组授权,则写法为组名前加@符号(如@manager),如果要对单独用户授权,则直接为用户名。等号(=) 后面是权限,有三种写法:空(无权限),r(读权限),rw(读写权限)。默认为空,即无权限。
d)权限优先级。您可能已经看到了我在test:/区段对user1授了读权限,而对user2是无权限,而对于/file1下的文件,我给user1授 了无权限,给user2授了读写权限。这个就是权限的优先级问题,即目录越深,权限越是优先。比如test下有一目录 /dir1/dir2/dir3/dir4/file5,那么对于用户user1来说,svn首先检查是否有针对user1的对file5的授权,若有, 则用此授权;如果没有,再判断user1对dir4的权限,至到/目录。如果至根目录依然没有设置,则使用默认权限(无权限)。
6、重启 apache
该写的配置文件都写了,那我们就重启一下apache服务吧。/etc/init.d/apache2 restart
然后通过浏览器查看一下吧:http://hostname/svn/test
现在因为我们还没有往svn是添加任何东西,所以我们看到的是"Revision 0: /"
7、svn的简单操作
svn操作除了命令行以后,在windows和linux的图形化界面下,都有相应的客户端软件。
a)导入
初始化以后,库中没有任何东西,所以我们首先要将我们的内容import进去。
作为一个演示:
mkdir /tmp/svn
cd /tmp/svn
touch file1
svn import http://hostname/svn/test -m "init" #会提示你输入用户名和口令,用户默认为当前用户,如果不正确,直接回车再输入用户名
现在通过浏览器查看http://hostname/svn/test,我们可以看到现在已经变成"Revision 1: /"而且我们可以看到file1文件也存在了。
b)Checkout
checkout的操作是将代码从svn服务器上取下来。
继续上面的演示:
cd ..
rm -rf svn
svn co http://hostname/svn/test #我们看到在tmp目录下多了一个test目录。
C)Add和Commit
cd test
vi file1 #修改一下file1文件
touch file2 #新增一个file2文件
svn stat #查看一下当前目录的文件改动情况
我们看到file2前面是一个问号,表示file2还没有加到仓库中。file1前面是一个M,表示修改。
svn add file2 #添加file2,add与import的区别是add并不会直接加到svn服务器上,而import则会。add只是增加了一个添加作业项。
svn ci -m "add file2 and modify file1" #提交
现在通过浏览器查看http://hostname/svn/test,我们可以看到现在已经变成"Revision 2: /"而且我们可以看到file2文件也存在了。
8、常见问题
a)配置后通过浏览器提示权限禁止
将/etc/apache2/mods-available/dav_svn.conf中的<LimitExcept GET PROPFIND OPTIONS REPORT>行和</LimitExcept>注释掉。本文仅是一个基本配置,如果您想了解这两行的含义可以通过网络搜索一下吧。
注:本文应该说是svn最简单的一个配置示例了,以后如果有时间我会将svn使用ldap进行身份验证的方法写出来(其实是apache使用ldap进行 身份验证).
svn服务器安装
最新推荐文章于 2024-09-18 16:08:04 发布