SVN入门及配置使用

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\