SVN的介绍和使用

SVN的介绍和使用

SVN的介绍

简介

TortoiseSVN 是Subversion 版本控制系统的一个免费开源客户端，可以超越时间的管理文件和目录。文件保存在中央版本库，除了能记住文件和目录的每次修改以外，版本库非常像普通的文件服务器。你可以将文件恢复到过去的版本，并且可以通过检查历史知道数据做了哪些修改，谁做的修改。这就是为什么许多人将 Subversion 和版本控制系统看作一种“时间机器”。

SVN的服务运行模式与访问方式

SVN服务器常见的有3种运行访问方式：
独立服务器（例如：svn://svn.beyondjie.com/test）
借助Apache（例如：http://svn.beyondjie.com/test）
本地直接访问（例如：file:///svn/svndata/test）

SVN数据格式

svn存储版本数据也有两种格式：BDB（一种实物安全型表类型）和FSFS（一种不需要数据库的存储）。BDB在服务器中断时有可能锁住数据，所以FSFS比较安全一些。
BDB：伯克利版本库
可以使用的一种经过充分测试的后台数据库实现，不能在通过网络共享的文件系统上使用，是svn 1.2版本之前默认使用的格式
FSFS
一个专用于svn版本库的文件系统后端，可以使用网络文件系统（例如NFS或SMBFS），是1.2版本以后默认使用的格式
SVN是基于关系数据库或一系列二进制文件，一方面解决了许多问题（例如并行读写共享文件），以及添加了许多新功能。但是数据由此变得不透明，在服务器上是不能看到上传的文件的原件的

SVN工作架构图

SVN的部署

系统环境

[root@SVNServer~]# uname -r
2.6.32-358.el6.x86_64
[root@SVNServer~]# uname -m
x86_64
[root@SVNServer~]# uname -a
LinuxSVNServer 2.6.32-358.el6.x86_64 #1 SMP Fri Feb 22 00:31:26 UTC 2013 x86_64x86_64 x86_64 GNU/Linux

安装SVN

由于svn大多数用于局域网内开发上传代码使用，所以使用yum源安装即可，方便快捷

yuminstall subversion –y
检查：
[root@SVNServer~]# rpm -qa subversion
subversion-1.6.11-7.el6.x86_64

配置SVN并启动

1）创建SVN目录

[root@SVNServer~]# mkdir -p /svn/{svndata,svnpassword}
[root@SVNServer~]# ls /svn
svndata  svnpassword

2）启动SVN

[root@SVNServer~]# svnserve -d -r /svn/svndata/
[root@SVNServer ~]# netstat -anput | grep svn
tcp        0     0 0.0.0.0:3690               0.0.0.0:*                   LISTEN      1678/svnserve
[root@SVNServer ~]# ps -ef | grep svn
root      1678     1  011:33 ?        00:00:00 svnserve -d -r/svn/svndata/
[root@SVNServer ~]# lsof -i :3690
COMMAND   PIDUSER   FD   TYPE DEVICE SIZE/OFF NODE NAME
svnserve 1678 root   3u  IPv4  13985     0t0  TCP *:svn (LISTEN)

3）建立版本库

[root@SVNServer ~]# svnadmin create /svn/svndata/test
[root@SVNServer ~]# ls /svn/svndata/test
conf  db  format hooks  locks  README.txt

4）配置用户权限
现在有三个用户，user1，user2，user3，两个组 admin，guest；admin组的成员可以对版本库内容读写，guest组用户只能读。user1属于admin组，user2和user3属于guest组

[root@SVNServer ~]# cd /svn/svndata/test/conf/
[root@SVNServer conf]# cp svnserve.conf svnserve.conf.bak
[root@SVNServer conf]# egrep '\-access|\-db ='svnserve.conf
# anon-access = read
# auth-access = write
# password-db = passwd
# authz-db = authz
[root@SVNServer conf]# vim svnserve.conf
修改为
anon-access = none   #禁止匿名访问
auth-access = write    #是否允许可写
password-db = /svn/svnpassword/passwd          #密码文件存放的地方
authz-db = /svn/svnpassword/authz                                   #权限文件所在地方
查看修改：
[root@SVNServer conf]# egrep '\-access|\-db ='svnserve.conf                   anon-access = none
auth-access = write
password-db = /svn/svnpassword/passwd
authz-db = /svn/svnpassword/authz

快捷修改：
sed -i 's/# anon-access = read/anon-access = none/g'svnserve.conf
sed -i 's/# auth-access = write/auth-access = write/g'svnserve.conf
sed -i 's/# password-db = passwd/password-db =\/svn\/svnpassword\/passwd/g' svnserve.conf
sed -i 's/# authz-db = authz/authz-db =\/svn\/svnpassword\/authz/g' svnserve.conf

编辑passwd，增加user1，user2，user3三个用户

[root@SVNServerconf]# cp authz passwd /svn/svnpassword/
[root@SVNServerconf]# cd /svn/svnpassword/
[root@SVNServersvnpassword]# vim passwd
[root@SVNServersvnpassword]# tail -3 passwd
user1= 123.com
user2= 456.com
user3= 789.com
提示：注意格式

编辑权限文件authz，设置相应权限

[root@SVNServersvnpassword]# vim authz
admin= user1
guest= user2,user3
[test:/]
@admin= rw
@guest= r
注意：
权限配置文件中出现的用户名必须在用户密码文件passwd中有
对权限修改立即生效，不必重启SVN
用户组格式：
[groups]
groupname= username1,username2
其中1个组可以包含1个或多个用户，用户之间用逗号隔开
版本库目录格式
[<版本库>:/项目/目录]
@<groupnameor username> = <权限>
其中方括号内可以有多种写法 [/]表示根目录及一下，根目录是svnserver启动时指定的，我们此时指定的为/svn/svndata/test

此时SVN已经部署完成

svn管理命令

[root@SVNServer svnpassword]# svnserve --help
用法: svnserve [-d | -i | -t | -X] [options]
有效选项:
-d [--daemon] : 后台模式
-i [--inetd] : inetd 模式
-t [--tunnel] : 隧道模式
-X [--listen-once] : 监听一次方式(调试用)
-r [--root] ARG : 服务的根目录
-R [--read-only] : 强制只读；覆盖版本库配置文件
--config-file ARG : 从文件 ARG 读取配置
--listen-port ARG : 监听端口
--listen-host ARG : 监听主机名称或IP地址
-T [--threads] : 使用线程代替进程 [方式: daemon]
--foreground : 在前台运行(调试用)
--log-file ARG : svnserve 日志文件
--pid-file ARG : 写进程 PID 到文件 ARG
--tunnel-user ARG : 隧道用户名(默认是当前UID对应的用户名)
-h [--help] : 显示本帮助
--version : 显示程序版本信息

svn配置文件的详细解释

（1）svn配置文件vim /svn/svndata/test/conf/svnserve.conf 各参数功能在配置文件的注释中有说明, 此处配置如下: [general] anon-access =none #使非授权用户无法访问 auth-access = write #使授权用户有写权限 password-db = passwd #指明密码文件路径 authz-db = authz #访问控制文件 realm = /svn/svndata/test #认证命名空间,subversion会在认证提示里显示，并且作为凭证缓存的关键字。 注意：各语句都必须顶格写,左侧不能留空格,否则会出错.（2）配置用户认证信息 vim /svn/app1/svndata/test/conf/passwd 格式： [users] <用户> = <密码>例如：admin = admin username2 = password2 （3）配置权限信息 vim /svn/svndata/test/conf/authz说明: 用户组格式： [groups] <用户组名> = <用户1>,<用户2>其中，1个用户组可以包含1个或多个用户，用户间以逗号分隔。 版本库目录格式： [<版本库>:/项目/目录] @<用户组名> = <权限> <用户名> = <权限> 其中，方框号内部分可以有多种写法: /,表示根目录及以下。根目录是svnserve启动时指定的，我们指定/svn/svndata。这样，/就是表示对全部版本库设置权限。 repos1:/,表示对版本库1设置权限 repos2:/abc, ,表示对版本库2中的abc项目设置权限 repos2:/abc/aaa, ,表示对版本库2中的abc项目的aaa目录设置权限 权限主体可以是用户组、用户或*，用户组在前面加@，*表示全部用户。权限可以是w、r、wr和空，空表示没有任何权限。 例1: [groups] admins = admin,user1,user2 [/] @admins = rw user3 = rw user4 = r * = [repos:/] @admins = rw * = rw 注意：配置auth 、passwd和svnserve.conf一定要心细，否则客户端访问时会认证失败，svn默认端口是3690

SVN钩子的介绍和使用

介绍：
SVN钩子就是被版本库事件触发的程序或脚本，例如新修订版本的创建，或是未版本化属性的修改。每个钩子都会被告知足够多的信息，包括那是什么事件，所操作的对象，和触发事件的用户名。通过钩子的输出或返回状态，钩子程序能让工作继续、停止或是以某种方式挂起。通常在版本库里的hooks目录里
post-commit.tmpl pre-revprop-change.tmpl
post-revprop-change.tmpl start-commit.tmpl
pre-commit.tmpl

对每种Subversion版本库支持的钩子的都有一个模板，通过查看这些脚本的内容，你能看到是什么事件触发了脚本及如何给传脚本传递数据。同时，这些模版也是如何使用这些脚本，结合Subversion支持的工具来完成有用任务的例子。要实际安装一个可用的钩子，你需要在 hooks目录下安装一些与钩子同名（如 start-commit或者post-commit）的可执行程序或脚本。
提示
由于安全原因，Subversion版本库在一个空环境中执行钩子脚本—就是没有任何环境变量，甚至没有$PATH或%PATH%。由于这个原因，许多管 理员会感到很困惑，它们的钩子脚本手工运行时正常，可在Subversion中却不能运行。要注意，必须在你的钩子中设置好环境变量或为你的程序指定好绝对路径。
start-commit.tmpl
它在提交事务产生前已运行，通常用来判定一个用户是否有权提交。版本库传给该程序两个参数：到版本库的路径，和要进行提交的用户名。如果程序返回一个非零值，会在事务产生前停止该提交操作。如果钩子程序要在stderr中写入数据，它将排队送至客户端。

pre-commit.tmpl
在事务完成提交之前运行，通常这个钩子是用来保护因为内容或位置（例如，你要求所有到一个特定分支的提交必须包括一个bug追踪的ticket号，或者是 要求日志信息不为空）而不允许的提交。版本库传递两个参数到程序：版本库的路径和正在提交的事务名称，如果程序返回非零值，提交会失败，事务也会删除。如果钩子程序在stderr中写入了数据，也会传递到客户端。

Subversion的分发版本包括了一些访问控制脚本（在Subversion源文件目录树的tools/hook-scripts目录），可以用来被 pre-commit调用来实现精密的写访问控制。另一个选择是使用Apache的httpd模块mod_authz_svn，可以对单个目录进行读写访问控制
post-commit.tmpl
它在事务完成后运行，创建一个新的修订版本。大多数人用这个钩子来发送关于提交的描述性电子邮件，或者作为版本库的备份。版本库传给程序两个参数：到版本库的路径和被创建的新的修订版本号。退出程序会被忽略。

Subversion分发版本中包括mailer.py和commit-email.pl脚本（存于Subversion源代码树中的 tools/hook-scripts/目录中）可以用来发送描述给定提交的email（并且或只是追加到一个日志文件），这个mail包含变化的路径清 单，提交的日志信息、日期和作者以及修改文件的GNU区别样式输出。

Subversion提供的另一个有用的工具是hot-backup.py脚本（在Subversion源代码树中的tools/backup/目录 中）。这个脚本可以为Subversion版本库进行热备份（Berkeley DB数据库后端支持的一种特性），可以制作版本库每次提交的快照作为归档和紧急情况的备份。

pre-revprop-change.tmpl
因为Subversion的修订版本属性不是版本化的，对这类属性的修改（例如提交日志属性 svn:log）将会永久覆盖以前的属性值。因为数据在此可能丢失，所以Subversion提供了这种钩子（及与之对应的post-revprop- change），因此版本库管理员可用一些外部方法记录变化。作为对丢失未版本化属性数据的防范，Subversion客户端不能远程修改修订版本属性， 除非为你的版本库实现这个钩子。

这个钩子在对版本库进行这种修改时才会运行，版本库给钩子传递四个参数：到版本库的路径，要修改属性的修订版本，经过认证的用户名和属性自身的名字。

post-revprop-change.bat
我们在前面提到过，这个钩子与pre-revprop-change对应。事实上，因为多疑的原因，只有存在pre-revprop-change时这个 脚本才会执行。当这两个钩子都存在时，post-revprop-change在修订版本属性被改变之后运行，通常用来发送包含新属性的email。版本 库传递四个参数给该钩子：到版本库的路径，属性存在的修订版本，经过校验的产生变化的用户名，和属性自身的名字。

Subversion分发版本中包含propchange-email.pl脚本（在Subversion源代码树中的tools/hook- scripts/目录中），可以用来发送修订版本属性修改细节的email（并且或只是追加到一个日志文件）。这个email包含修订版本和发生变化的属性名，作出修改的用户和新属性值。

警告

不要尝试用钩子脚本修改事务。一个常见的例子就是在提交时自动设置svn:eol-style或svn:mime-type这类属性。这看起来是个好主 意，但它会引起问题。主要的问题是客户并不知道由钩子脚本进行的修改，同时没有办法通告客户它的数据是过时的，这种矛盾会导致出人意料和不能预测的行为。

作为尝试修改事务的替代，我们通过检查pre-commit钩子的事务，在不满足要求时拒绝提交。
Subversion会试图以当前访问版本库的用户身份执行钩子。通常，对版本库的访问总是通过ApacheHTTP服务器和mod_dav_svn进行，因此，执行钩子的用户就是运行Apache的用户。钩子本身需要具有操作系统级的访问许可，用户可以运行 它。另外，其它被钩子直接或间接使用的文件或程序（包括Subversion版本库本身）也要被同一个用户访问。换句话说，要注意潜在的访问控制问题，它 可能会让你的钩子无法按照你的目的顺利执行

SVN客户端的使用

linux客户端使用

1.将svn中的资源池同步到本地
svn checkout path（path是服务器上的目录） 本地目录
svn checkout svn://172.16.254.4/project//project
或 svn co svn://172.16.254.4/project/ /project
2.将本地资源导入到svn中
svn import localdir svn://ip/dir
3.将本地新创建的文件添加到svn中
svn add file
4.将改动的文件提交到版本库中
svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果选择了保持锁，就使用–no-unlock开关)
例如：svn commit -m “addtest file for my test“ test.php
简写：svn ci
5、Linux命令行下的加锁/解锁
svn lock -m “LockMessage“ [--force] PATH
例如：svn lock -m “locktest file“ test.php
svn unlock PATH
6、Linux命令行下更新到某个版本
svn update -r m path
例如：
svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。
svn update -r 200 test.php(将版本库中的文件test.php还原到版本200)
svn update test.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit)
简写：svn up
7、Linux命令行下查看文件或者目录状态
1）svn statuspath（目录下的文件和子目录的状态，正常状态不显示）
【?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】
2）svn status-v path(显示文件和子目录状态)
第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。
注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。
简写：svn st
8、Linux命令行下删除文件
svn delete path -m “delete test fle“
例如：svn deletesvn://192.168.1.1/pro/domain/test.php -m “delete testfile”
或者直接svn delete test.php 然后再svn ci -m ‘delete test file‘，推荐使用这种
简写：svn (del, remove, rm)
9、Linux命令行下查看日志
svn log path
例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化
10、Linux命令行下查看文件详细信息
svn info path
例如：svn info test.php
11、Linux命令行下比较差异
svn diff path(将修改的文件与基础版本比较)
例如：svn diff test.php
svn diff -r m:n path(对版本m和版本n比较差异)
例如：svn diff -r 200:201 test.php
简写：svn di
12、Linux命令行下将两个版本之间的差异合并到当前文件
svn merge -r m:n path
例如：svn merge -r 200:205 test.php（将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下）
13、Linux命令行下SVN 帮助
svn help
svn help ci
14、Linux命令行下版本库下的文件和目录列表
svn list path
显示path目录下的所有属于版本库的文件和目录
简写：svn ls
15、Linux命令行下恢复本地修改
svn revert: 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:
用法: revert PATH…
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录

windows客户端使用

1.安装
客户端程序
TortoiseSVN-1.6.8.19260-win32-svn-1.6.11.msi中文支持包：
LanguagePack_1.6.8.19260-win32-zh_CN.msi安装完成后，在资源浏览器中，点击鼠标右键，如下图所示：



2. 中文设置
在语言设置中，设置使用中文。



3. 基本工作流程
1) 检出工作副本2) 更新工作副本3) 产生更改4) 查看更改5) 合并其他人的改动6) 提交改动4. 检出工作副本
将后台svn服务器，检出到本地目录：



版本库URL为：svn://192.168.237.5/windows
指定输出的目录。




输入用户、口令（SVN后台服务器分配的用户、口令，请联系相关系统管理员获取）


钩选“保存认证”，下次打开不需要再输入用户、口令信息。
点击“确定”后，会下载文件至本地。

5.更新工作副本
选中工作副本目录，右键点击“SVN更新”获取当前最新版本代码。




6. 产生更改、提交改动
增加文件：将文件拷贝到工作副本目录下，右键“TortoiseSVN”>“增加”



提交改动：右键选中文件，点击“SVN提交”



说明本次版本变更情况，并确定后提交。



提交成功后，会显示当前版本号：




删除文件：选中文件后，点击“TortoiseSVN”>“删除”
完成后必须点击“SVN提交”才能删除。

SVN实现本地提交目录之后自动同步到远程服务器上

思路：
方法一：本地成功向SVN提交之后，会触动post-commit钩子，然后post-commit钩子会先在本地checkout出svn中的资源，最后调用rsync脚本进行把本地文件推送到远程服务器上。
方法二：本地成功向SVN提交之后，会触动post-commit钩子，不在本地checkout，直接使用ssh调用远程服务器上的svn update命令来同步svn库中的资源，前提是远程服务器需要先checkout svn中的资源
总之关键在于远程设备上同步目录的权限设定和post-commit钩子的编写
1.做ssh免交互式验证登录
2.编写脚本和钩子
方法一的脚本

Post-commit脚本
#!/bin/bash
#date: 2014年07月18日
REPOS="$1"
REV="$2"
export.UTF-8
/usr/local/svn/bin/svn update--username www --password 123456789.com /data/jxq_web/3g.club.xywy.com
if [ $? == 0 ]
then
chown -R www:develop/data/jxq_web/3g.club.xywy.com
/bin/sh/shell/jxq_rsync-script/3g.club.xywy.com.sh > /dev/null 2>&1
fi
rsync脚本
#/bin/bash
#date: 2014年02月17日
#client--->server
#define variables
IP="118.244.192.243"
Auth_module="3g.club.xywy.com"
Localdir="/data/jxq_web/3g.club.xywy.com/"
Auth_user="xywy_svn_user"
Passwd_file="/shell/rsync-password/rsync.password"
Exc=" --exclude=.svn --exclude=cache/--exclude=application/logs/ --exclude=www/dianshang --exclude=www/robots.txt"
rsync -vzrtopgl --progress--delete ${Exc} ${Localdir} $Auth_user@${IP}::${Auth_module}--password-file=${Passwd_file}

方法二脚本

#!/bin/bash
REPOS="$1"                  # 仓库的路径
REV="$2"                    # 新提交的版本号
LOGFILE=/var/log/svn.log    # 钩子脚本的日志
# 脚本的标准输出和标准错误输出都打印到日志文件里
exec1>>"$LOGFILE"
exec 2>&1

SVNLOOK=/usr/bin/svnlook
TIME=$(date "+%Y-%m-%d%H:%M:%S")
AUTHOR=$($SVNLOOK author -r$REV "$REPOS")  #提交作者
CHANGEDDIRS=$($SVNLOOKdirs-changed $REPOS) #修改的目录集合
MESSAGE=$($SVNLOOK log -r$REV "$REPOS")    #提交时的备注信息，不建议用中文

# SVN客户端配置，需要自行修改**********************************
CLIENT1=172.16.254.3        #project1的服务器
CLIENT2=172.16.254.5        #project2的服务器
CLIENTSVNROOT=/usr/local/haproxy
#WEB服务器的代码根目录
SVNUSER="fuzj"
SVNPASSWD="fuzj123"
#**************************************************************

function myecho() {
echo "$TIME" "$*"
}

myecho "**************************************************************"
myecho "提交版本：$REV 作者：$AUTHOR"
myecho "提交备注：$MESSAGE"
myecho "修改目录：$(echo $CHANGEDDIRS | tr '\n' ' ')"

MASTERDIR=$(echo"$CHANGEDDIRS" | head -1) #CHANGEDDIRS里的最上级目录
# 遍历提交的代码目录，同步到WEB服务器上
while ["$CHANGEDDIRS" != "" ];do
PROJECT=$(echo $MASTERDIR | awk -F /'{print $1}')
# 判断项目文件夹
if [ "$PROJECT" =="tage" ];then
myecho
myecho "项目：$PROJECT 同步目录：$MASTERDIR"
#    myecho "同步 $MASTERDIR 到 $CLIENT1:$CLIENTSVNROOT/$MASTERDIR"
myecho "同步 $MASTERDIR 到 $CLIENT1:$CLIENTSVNROOT"
# 无密码ssh连接到客户端服务器，执行svn up
/usr/bin/ssh fuzj@$CLIENT1 "exportLANG=en_US.UTF-8; svn up --non-interactive --username $SVNUSER --password$SVNPASSWD '$CLIENTSVNROOT'"
elif [ "$PROJECT" =="trunk" ];then
myecho
myecho "项目：$PROJECT 同步目录：$MASTERDIR"
myecho "同步 $MASTERDIR 到$CLIENT2:$CLIENTSVNROOT/$MASTERDIR"
/usr/bin/ssh fuzj@$CLIENT2 "exportLANG=en_US.UTF-8; svn up --non-interactive --username $SVNUSER --password$SVNPASSWD '$CLIENTSVNROOT'"
fi
# 在目录集合里删除子目录
CHANGEDDIRS=$(echo "$CHANGEDDIRS"| grep -v "^$MASTERDIR")
# 获取新的需要同步的最上级目录
MASTERDIR=$(echo "$CHANGEDDIRS" |head -1)
done