SVN入门及配置使用
 

2009-10-23 来源:网络

 

SVN,即Subversion,是一个自由开源的版本控制系统,可以将数据恢复到早期版本,或者检查数据修改的历史,这些数据可以是源代码,也可以是其他类型的文件。

在SVN出现之前,CVS是开源世界版本控制工具的事实标准,然而CVS存在一些固有的缺陷,并且修复这些缺陷需要耗费很大的精力,因此,SVN的发起者Brian Behlendorf和CollabNet决定重新编写一个版本控制系统,保留CVS的基本思想,但要修正其中错误和不合理的特性。于是,SVN作为CVS的继任者出现了。SVN的设计者们力图通过两方面的努力赢得CVS用户的青睐:保持开源系统的设计以及界面风格与CVS尽可能类似,同时尽力弥补CVS许多显著的缺陷。这些努力的结果使得从CVS迁移到SVN不需要作出重大的变革,因此越来越多的人选择了SVN。
http://svnbook.red-bean.com

http://www.subversion.org.cn

目录

一、客户端的使用
 1.1 Linux系统下一般使用(Ubuntu)
 1.2 Windows系统下一般使用
 1.3 Linux下使用SVN+ssh认证(未找到相关资料@_@)
 1.4 Windows下使用SVN+ssh认证
二、服务器端的配置
 2.1 Linux下的svnserve配置
 2.2 Windows下的svnserve配置
 2.3 Linux下的svnserve+ssh配置
 2.4 Windows下的svnserve+ssh配置(需使用Cygwin,略)
 2.5 Linux下基于APache的SVN服务器配置
 2.6 Windows下基于APache的SVN服务器配置
三、建立版本库
 3.1 Linux下创建版本库
 3.2 Windows下创建版本库

大多数人都是从客户端开始使用SVN,以下先介绍客户端的使用。假设已经假设好了SVN服务器,其文件夹地址为http://domain/svn/trunk/myproject,用户名为test,密码为test。(如果服务器端配置的是SVN,则使用svn://开头的URL访问;如果服务器端配置的是SVN+SSH,则使用svn+ssh开头的URL访问)

一、客户端的使用

1.1 Linux(Ubuntu)系统下一般使用

1)首先需要安装svn客户端,ubuntu下使用$sudo apt-get install subversion(其他请baigoogledu,余同)

2)checkeout命令:第一次使用时使用checkout命令,把服务器的目录拷贝到本地的当前目录下,同时会建立一个隐藏文件夹记录版本信息:
  [工作目录]$svn checkout "http://domain/svn/trunk/myproject" --username test
然后输入密码

3)svn update命令:获取服务器上的最新版本
  [工作目录]$svn update(除了第一次要加url和用户名和密码,之后系统会记住)

4)svn add命令:要把非版本控制的本地文件添加到版本控制:
  [工作目录]$svn add hello.c

5)svn commit命令:把本地文件上传到服务器

[工作目录]$svn commit(如果有新的文件,要首先svn add)

1.2 Windows系统下一般使用

1)安装客户端:http://tortoisesvn.net/downloads

2)新建一个文件夹(工作目录),右击选择checkout,填写URL和用户名密码

3)工作目录右键update

4)工作目录右键add

5)工作目录右键commit

1.3 Linux下使用SVN+ssh认证(未找到相关资料@_@)

1.4 Windows下使用SVN+ssh认证

(参考ubuntu下架设svn服务器及在windows建立svn+ssh客户

1.4.0 安装TortoiseSVN、Puttygen、Pageant
  http://sourceforge.net/projects/tortoisesvn
  http://www.chiark.greenend.org.uk/~sgtatham/putty/

1.4.1 转换私钥格式
 1)将Linux下的文件<username>key拷贝到windows下,运行Puttygen;
    2)选择菜单conversions->Import Key;选择文件<username>key,提示"Enter passphrase for key",输入创建公私钥对示使用的passphrase关键字;
    3)选择Parameters为“SSH-2 DSA”或“SSH-2 RSA”->Save private key->保存文件名为username>key.ppk。

1.4.2 建立TortoiseSVN与Pageant的关联,并将私钥加入Pageant:
    1)鼠标右键选择TortoiseSVN->Settings->Network->SSH client,输入:
     C:\Program Files\TortoiseSVN\bin\TortoisePlink.exe
    2)鼠标右键选择TortoiseSVN->RepoBrowser 输入URL:
  svn+ssh://<username>@<SvnServiceIP>/usr/local/svn/trunk
    3)运行Pageant,右键点击屏幕右下角的图标-〉Add Key,将私钥文件<username>key.ppk加入。
——如果不想缓存ssh密码,则第8、9步不需要,只保留第二步,但每次check out、check in中每进入一个文件夹都要输入两次密码,烦死你:)

二、服务器端的配置

Web服务器部署可以有三种选择,配置由简单到复杂排列为

·svnserve

·svnserve over SSH

·Apache+mod_dav_svn模块

下面从最简单的入手,介绍svnserve。

[更新]Windows下服务器端的配置可以使用VisualSVN Server进行傻瓜化安装。

官方网站:http://www.visualsvn.com/

参考链接:VisualSVN系列介绍(有详细的安装过程介绍,这里就不转述了)

2.1&2.2 配置svnserve

svnserve是一个轻型的服务器,可以同客户端通过在TCP/IP基础上的自定义有状态协议通讯,客户端通过使用开头为svn://或者svn+ssh://svnserve的URL来访问一个svnserve服务器。

2.1 Linux下的svnserve配置

2.1.0 同样地,使用命令$sudo apt-get install subversion

2.1.1 svnserve作为独立守护进程,监听请求
  $svnserve -d
  $ #svnserve is now running, listening on port 3690
  ——可以使用--listen-port=[端口号]来指定端口,或者--listen-host=[主机名]来指定主机名
  假定已经建立一个版本库位于/usr/local/repositories/project路径(版本库的建立稍后提及), 此时客户端可以使用svn://[主机]/usr/local/repositories/project来进行访问
  ——可以使用-r选项来限制只输出指定路径下的版本库,从而使客户端访问更为简洁:
  $svnserve -d -r /usr/local/repositories
  则客户端只要使用svn://[主机]/project就可以访问

2.1.2 通过inetd使用svnserve
  $svnserve -i
  ——此时svnserve会尝试使用自定义协议通过stdin和stdout来与subversion客户端通话,默认端口为3690。可以在/etc/services添加如下几行:
  svn 3690/tcp #subversion
  svn 3690/udp #subversion
  ——如果是使用经典的类Unix的inetd守护进程,可以在/etc/inetd.conf添加如下行,则如果有客户连接来到端口3690,inetd会产生一个svnserve进程来做服务
  svn stream tcp nowait svnowner /usr/bin/svnserve svnserve -i

2.1.3 设置svnserve的内置认证

编辑版本库目录的conf/svnserve.conf文件:
 1)设置匿名访问
  [general]
  anon-access = none #无权限
  anon-access = read #只读
  anon-access = write #打开匿名的写访问,但这样很危险,不能控制谁来修改版本库
 2)使用用户和密码
 2.1)定义保存用户名和密码的文件和一个认证域
  [general]
  password-db = <userfile> #指出保存用户和密码列表的文件,可以是绝对或相对路径
  realm = example realm #定义认证域
  anon-access = read
  auth-access = write
 2.2)然后在userfile文件中指明用户名和密码:(格式为“用户名=密码”)
  [users]
  harry = foopassword
  sall = barpassword

2.2 Windows下的svnserve配置

2.2.0 安装svnserve

1)从http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91得到最新版本的Subversion
(如果之前已经安装了subversion,svnserve已经在服务器上运行,需要先停止服务)

2)安装subversion,然后进入subversion的安装目录,找到bin目录下的文件svnserve.exe,int13_svn.dll,libapr.dll,libapriconv.dll,libapriutil.dll,libdb*.dll,libeay32.dll和ssleay32.dll,将它们复制到服务器目录下(如C:\svnserve)。

2.2.1 以守护方式运行svnserve

在命令行窗口输入svnserve.exe --daemon,则svnserve将会在端口3690等待请求,--daemon选项告诉svnserve以守护进程方式运行,这样在手动终止之前不会退出。这种方式的不便之处是需要保持命令行窗口不关闭。

2.2.2 svnserve作为windows服务

svnserve作为windows服务时,在后台运行,可以在启动时自动执行,并且可以使用同其他windows服务一致的管理界面启动和停止服务。
需要使用命令行工具sc.exe定义新的服务(create svnserve),在windows启动时指明svnserve的调用:
  C:\>sc create svnserve
   binpath= "\"c:\svnserve\svnserve.exe\" --service --root c:\repos"
   displayname= "Subversion"
   depend= tcpip
   start= auto
  ——注意为了回避目录名中的空格等字符,将整个binpath值放在双引号中;另外,sc 的命令行很特殊。在 key= value 对中,key 与 = 之间不能有空格,但是在 value 之前,必须有空格。

定义了服务之后,就可以使用GUI工具(如服务管理面板)进行停止、启动和查询,也可以通过命令行的方式进行:
  C:\>net stop svn
  C:\>net start svn
  C:\>sc delete svn(需要确定先停止了服务)

2.2.3 设置svnserve的内置认证

同上Linux配置文件即可。

2.3&2.4 配置svnserve+ssh

2.3 Linux下的svnserve+ssh配置

2.3.0 介绍与安装ssh
  通过此方法,svnserve不会作为守护进程启动,而是SSH来启动svnserve,以SSH授权用户进行。
  $sudo apt-get install ssh

2.3.1 创建帐户
  $sudo adduser <username> #为参与项目开发的成员建立用户帐户
  $sudo addgroup <groupname> #建立用户组
  $sudo addgroup <username> <groupname> #将用户帐户添加进用户组

2.3.2 为成员生成密钥对
  首先必须切换为<username>的用户登陆Linux:
  $sudo <username>
  $(提示输入密码)
  $cd ~/
  $whoami
  <username>$ssh-kegen -b 1024 -t dsa -N <passphrase> -f <filename> #使用DSA加密,也可以改为RSA加密
  ——这时产生两个文件:私钥<username>key和公钥<username>key.pub
  然后创建目录/home/<username>/.ssh,把公钥拷贝到该目录下:
  $cp <username>key.pub /home/<username>/.ssh/authrized_keys #文件名必须为authorized_keys

2.4 Windows下的svnserve+ssh配置

需要使用Cygwin来配置ssh,此处略,详情可参考http://tortoisesvn.net/node/156

2.5&2.6 基于Apache服务器的SVN配置

概述

Apache的http服务器是一个subversion可以利用的“重型”网络服务器,通过一个自定义模块,httpd可以让SVN版本库通过WebDAV/DeltaV协议在客户端前可见。可以将浏览器指向版本库的URL,无需安装SVN客户端就可以浏览内容。

基于Apache的SVN需要两个包的四个部分:Apache httpd2.0及其中包含的mod_dav DAV模块,Subversion及与之一起发布的mod_dav_svn模块。有了上述组件之后,配置步骤一般如下
 1)配置好http2.0,并且使用mod_dav启动
 2)为mod_dav安装mod_dav_svn插件
 3)配置httpd.conf来发布版本库

2.5 Linux下基于APache的SVN服务器配置

(参考http://www.123shang.cn/blog/?p=53

(参考“ubuntu下svn+apache版本管理服务器配置”)

2.5.1 安装aphache
  $sudo apt-get install apache2 #安装apache
  $sudo apt-get install libapache2-svn #安装相关组件
  $sudo apt-get install subversion #安装svn
  安装完毕后启动apache
  $/usr/local/apache/bin/apachectl –k start
  ——用浏览器查看http://localhost/,得到it works,说明apache已经配置成功了。

2.5.2 创建版本库(见第三节)

2.5.3 添加用户并设置密码文件

版本库的密码文件,一般命名为PasswdFile,由用户通过命令创建,里面保存授权用户的用户名和MD5加密后的密码。创建密码文件,密码文件保存在版本库文件目录下,在终端通过下面的命令创建密码文件:
  $htpasswd -c /etc/svn/passwordfile username
   passwordfile 密码文件名称,可以由用户自行命名
   username 你希望添加的用户名,比如zhangsan,lisi,wangwu
   -c 用来创建密码文件
  按提示输入密码,添加成功后会提示add user username,然后可以再继续添加第二个用户。
  $htpasswd /etc/svn/passwordfile seconduser

2.5.4 httpd.conf文件修改
  conf文件正常安装的话在etc/apache2/ 目录下,双击打开进行编辑,添加以下内容:
  LoadModule dav_svn_module modules/mod_dav_svn.so 加载mod_dav_svn模块
  LoadModule authz_svn_module /usr/lib/apache2/modules/mod_authz_svn.so 加载 mod_anthz.svn模块
  <Location /vcard>
   DAV svn
   SVNPath /home/bb/svn/vcard/ 指明版本库的路径
   AuthType Basic 认证类型为基本认证
   AuthName "SVN repos" 认证名称,将在IE界面弹出一个对话框,其标题就是SVN repos
   AuthUserFile /home/bb/svn/vcard/VcardPasswdFile 加载密码文件,访问版本库用户的文件,用apache 的htpasswd命令生成
   # AuthzSVNAcessFile //home/bb/svn//vcard/accesspolicy 访问版本库权限的文件
   # satisfy Any
   Require valid-user 要求验证用户,即不能匿名访问;如果没有这个语句,则只能第一个用户可以访问新建库
  </Location>
  保存文件退出,重新启动apache
  # /usr/local/apache/bin/apachectl –k restart
  测试:
  $svn checkout http://localhost/svn

2.6 Windows下基于APache的SVN服务器配置

2.6.1 下载安装Apache
  APache:http://httpd.apache.org/download.cgi
  ——如果你将Apache安装成一个服务,它将以本地system帐户来运行。为Apache创建一个单独的用户来运行它将会更安全一些。
  ——请确保运行Apache的用户有版本库的完全访问权限(右键版本库目录->属性->安全)。要不然,用户将无法提交他们的更改。
  ——就算Apache以本机system来运行,你也要设置它能完全读写版本库目录。
  ——如果没有为Apache配置这个许可,用户将会得到"禁止访问"的错误信息,在Apache的错误日志中表现为错误500。

2.6.2 配置Subversion

使用Windwos资源管理器,来到Subversion的安装目录(通常是c:\program files\Subversion),找到文件httpd/mod_dav_svn.so和mod_authz_svn.so,复制这些文件到Apache的模块目录(通常是c:\program file\apache group\apache2\modules)。

2.6.3 配置httpd.conf文件
  路径通常为c:\program files\apache group\apache2\conf\httd.conf),修改以下内容:
  去掉以下两行的注释号“#”:
  #LoadModule dav_fs_module modules/mod_dav_fs.so
  #LoadModule dav_module modules/mod_dav.so
  在LoadModule节的最后添加以下两行:
  LoadModule dav_svn_module modules/mod_dav_svn.so
  LoadModule authz_svn_module modules/mod_authz_svn.so
  文件末尾添加以下行,让Apache知道哪个URL将被Subversion使用:
  <Location /svn>
   DAV svn
   SVNParentPath D:\SVN
   AuthType Basic
   AuthName "Subversion repositories"
   AuthUserFile D:\passwd
   #AuthzSVNAccessFile D:\svnaccessfile
   Require valid-user
  </Location>
  ——这样配置表示:你所有的版本库将位于D:\SVN目录下,要访问你的版本库可以使用这样的URL:http://MyServer/svn/,访问权限将由passwd文件中的用户名/密码来限制。
  要创建passwd文件,可以打开命令行,将当前目录切换到apache2目录,输入命令:
  c:\program files\apache group\apache2 >bin\htpasswd -c passwd <username>
  重启Apache服务。
  使用浏览器测试。

三、建立版本库

在前面的服务器配置上我们通常假设已经建立了版本库,这是为了避免在每种配置中重复赘述这种操作,因此把它独立出来讲。

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

3.1 Linux下创建版本库
  版本库有两种数据存储格式:Berkeley DB和FSFS,推荐选用FSFS格式,具体可以查阅参考资料了解二者的区别。
  创建版本库时,在终端运行如下命令:
  # 运行创建版本库的命令,指定数据存储为 FSFS,如果要指定为 Berkeley DB,则将 fsfs 替换为 bdb
  $ svnadmin create --fs-type fsfs /etc/svn/repos 创建版本库,运行这个命令后,我们就可以看到一个版本库应有的文件
  更改版本库的访问权限
  $ sudo mkdir /home/svn
  $ cd /home/svn
  $ sudo mkdir myproject
  前面三条命令用于创建版本库目录,如果已经建立,就可以省略掉;后面三条用于修改权限
  $ sudo chown -R www-data myproject
  $ sudo chgrp -R subversion myproject
  $ sudo chmod -R g+rws myproject 这条命令允许用户对版本库进行读写操作,即可以更新,可以提交

3.2 Windows下创建版本库

可以使用TortoiseSVN图形化的完成这一步,在目录E:subversionrepository下"右键->TortoiseSVN->Create Repository here...“, 然后可以选择版本库模式, 使用默认即可, 然后就创建了一系列目录和文件。
  [Tips]如果下载的是setup.exe版本,安装程序安装后会自动设置系统变量,如果下载的是zip版就需要手动设置系统变量.
  也可以使用命令行来创建:
  C:\> svnadmin create F:\svn\

火龙果软件/UML软件工程组织致力于提高您的软件工程实践能力,我们不断地吸取业界的宝贵经验,向您提供经过数百家企业验证的有效的工程技术实践经验,同时关注最新的理论进展,帮助您“领跑您所在行业的软件世界”。

资源网站: UML软件工程组织