大三的做嵌入式实验的时候就知道了svn,可是平时代码都是随便写写,也没有怎么好好管理,导致版本管理十分混乱,很多修改都无迹可寻。最近正好要帮实验室写点东西,又恰逢春节时间充足,就打算抽点时间研究一下。于是在网上发现了一篇好文,特意转载下来排版一下,以备日后参考。原文来自:
http://bemike.org/posts/258
http://bemike.org/posts/260
http://bemike.org/posts/261
http://bemike.org/posts/262
**********************************************************************************
建立 Subversion 服务器
目录:
· 序言
· 建立自己的 Repository
· 用 svnserve 建立 subversion 服务器
· 在 Apache 下建立 subversion 服务器
1. 序言
像我以前说过的,subversion 是一个非常好的版本控制系统。如果你对版本控制这个概念不太了解的话,我来简单解释一下。比如我有一个项目,有几百个文件,包括项目的相关文档,图表,和一些视频音频文件,它们都被放在电脑的一个文件夹内。随着项目的发展,文件夹内的会增加新的文档图表等文件,而老的文件也会被修改,同时也许会有一些文件会被删除。在版本控制系统下,每一次对该项目文件夹下的改动,都会被记录,如果哪个文件被删错了,或是想把文档恢复到以前的版本,可以轻而易举的达到。更了不起的是,如果该项目被一个团队来执行,该团队的每一个成员都可以对项目内的文件进行管理和同步,这样就可以保持大家永远 on the same page.
如果我说的不清楚,可以参考一下 Google Docs 的 revision 功能,对于一篇文档,你可以回到以前的版本。这个就是一个简单的版本控制。本质上说,subversion 干的活和 Google Docs 干的一样,但不同的是,subversion 使用上更加灵活,功能上更加强大。
对于普通的个人应用,建立 subversion 服务器完全可以在自己的电脑上进行,而且非常简单,因为完全不用去考虑安全的因素,所以也不必设置相关的验证身份的程序。如果想把“项目文件夹”(我不知道应该怎么翻译,以下改称 repository 或 repo)放在局域网上,甚至互联网上,就相对复杂一些了。
除了这篇序言,我准备分三篇说说如何建立 subversion 服务器,Windows 和 Linux 都适用,因为这几天我一直都在 Linux 下,例子就举 Linux 下的,Windows 下也是一样的,只需把路径格式换成 Windows 的就可以了。
2. 建立自己的 Repository
2.1 基础知识
在 Subversion (以下简称 svn) 下有两个概念要清楚,一个是 repository (以下简称 repo), 一个是 working copy (以下简称 wc)。前者是项目所在的地方,后者是你做修改的地方,两者的内容可以完全一样,也可以不完全一样,两者在电脑上一般都表现为文件夹或目录。你在 wc 里所做的改动可以 commit 到 repo 中,如果你成功把 wc 中的内容 commit 到 repo 中,那么 repo 就会自动更新一个版本 (revision)。如果不进行 commit 操作,你在 wc 上做的任何修改对不会对项目产生任何影响。如果你愿意,可以随时把 wc 替换为任何一个 revision (包括以前的老版本)。
要使用 svn 就要先安装,ubuntu 的用户很简单,直接在终端处输入:
sudo apt-get install subversion
就完成了,Windows 需要到下载页面下载 Windows 版本,我建议下载 .zip 包,直接解压就可以使用了。
在 windows 下使用最好把 svn 的执行文件路径加入到 PATH 这个环境变量中去,以便能够在任何路径下都可以正常使用,你很快就能发现,这点很重要。
2.2 建立自己的 repo
假设我要正在制作一个 wordpress 主题,我需要对制作过程中的文件建立一个 repo, 以便在需要时可以随时“回到过去”。制作中的主题所在的目录为 /foo/bar,我准备在 /home/michael 下建立一个 repo,那么我需要这么做:
#建立一个名为 theme 的 repository
svnadmin create /home/michael/theme
#把 /foo/bar 下的内容导入到 theme 中并建立 repo,这个 repo 的版本号是 1。
svn import -m "第一次导入" /foo/bar file:///home/michael/theme
从此以后,如果在本地电脑上想 checkout 刚才建立的 repo 只需在任何路径下输入
svn checkout file:///home/michael/theme baz #建立一个名为 baz 的 working copy
就完成了一个 working copy 的建立。Windows 用户需要把路径格式换成 file:///X:/path/to/repo。其中 X: 为 repo 的盘符。
在 wc 中你可以任意修改,如果不满意可以直接用 svn revert 命令恢复。在适当的时候你觉得需要把你的修改提交到 repo 中去了,可以用:
svn commit -m "blah blah"
这样就产生了新的版本。”blah blah” 是给这个新版本的注解。
2.3 svn 命令
要注意的一点是,在 wc 下做文件操作时,比如删除或移动文件,不能直接用 rm, mv 来进行,这样 svn 不能追踪到文件的变化,你必须使用 svn del 或是 svn move 来完成删除或移动的操作。下面举几个命令的例子:
svn add filename #新增一个文件
svn move filename foo/bar/baz #移动 filename 到 foo/bar/baz 下
svn rename filename1 filename2 #给文件改名
跟普通的 DOS/Linux 命令没什么不同,更多具体的命令可以参考 svn book。Windows 用户如果觉得命令行太麻烦,可以用一个名叫 TortoiseSVN 的图形化前端来代替命令行。
2.4 总结
通过以上的内容我们已经可以:
1.建立 repository
2.导入项目到 repo 中
3.建立 working copy
4.一些简单的 svn 命令
以上对个人的小项目来说基本够用了,但如果要用的得心应手还是不行,大家可以用 svn help 命令来查看其它命令的用法。如果你对命令行操作感到不适应,这里尤其建议 Windows 下的用户使用上面提到的 TortoiseSVN 软件,完全图形化界面,使用非常简单。如果需要帮助,可以看看 Lifehacker 上的使用指南。
下面两篇准备谈谈 Subversion 在服务器上的应用,包括建立服务器以及用户的验证。
3. 用 svnserve 建立 subversion 服务器
让我们来点真的吧
Part1 中介绍了在本机上建立 repo 自用,但如果想把 repo 放在网上供其他用户 checkout,则还需要架设 svn 服务器--这也是本文的目的。
svn 服务器可以用两种方法架设,一种比较简单,使用 svn 自带的 svnserve 实用程序,另一种直接利用 Apache 架设,需要加载额外的模块。svnserve 简单够用,我打算在这篇里先说说怎么用它架设 svn 服务器。
svnserve 就包含在 subversion 的程序包中,你的电脑上安装了 subversion 就自动有了 svnserve 这个小型 svn 服务器。这个服务器跟 Apache 这个巨无霸比起来简单轻便,使用自己的一套协议,访问时区别于 http:// 前缀,使用 svn:// 前缀。
3.1 用 svnserve 搭建 svn 服务器
我们要把 svnserve 运行起来,我将在例子中介绍具体的使用方法。
下面假设我在本机上运行 svnserve,IP 为 192.168.0.1,这个 svn 服务器为局域网内的电脑提供 svn 服务。我打算把 svn 服务器的访问地址设为 http://192.168.0.1/svnprojects/projectX,其中 X 为不同的多个项目。整个过程如下(以 windows 下为例):
首先确定 repo 在本机上的储存的位置,比如我准备把 repo 放在 D:/svnprojetcs/ 下,那么在命令行运行 svnserve -d -r d:/svnprojects 就可以了。其中 -d 参数让 svnserve 运行在后台,-r 参数限定了 repo 在网络上可以访问的地址。这样如果网络上其它的计算机要 checkout 这个服务器,只需要输入
svn checkout svn://192.168.0.1/project1
而 repo 在本机上实际的位置是 d:/svnprojects/project1。同理,如果想 checkout project2,则把上面的 project1 改成 project2 就可以了。
到此,一个简单的 svn 服务器就算是基本架设好了。但如果要正常使用,我们还需要设定用户的验证和相应的权限。
现在我们先建立一个叫 project1 的 repo,然后转到 project1中:
svnadmin create d:/svnprojects/project1
cd d:/svnprojects/project1
project1 目录下有一堆目录,进入 conf 并打开 svnserve.conf 这个文件,找到以下几行,并把前面的注解符号 ‘#’ 去掉,注意千万在每行的前面别留任何空格:
anon-access = read
auth-access = write
password-db = passwd
其中 anon-access 和 auth-access 分别为匿名和有权限用户的权限,默认给匿名用户只读的权限,这很好,我们不需要改它们。但如果想拒绝匿名用户的访问,只需把 read 改成 none 就能达到目的。password-db 后的 passwd 则为定义用户名及密码的文件路径。这个文件默认跟 snvserve.conf 在同一个目录,下面看看怎么配置 passwd 中的内容:
[user]
# harry = harryssecret
# sally = sallyssecret
harry 和 sally 这两行分别定义了可以对 repo 进行写入的用户的用户名和密码。我们可以在下面加上自己的用户名和密码,比如
testsvn = tester
这样就给了用户 testsvn 往 repo 中写的权限。存盘退出后,svn 服务器就算正式可以运行了!把所有需要管理的项目都放在 d:/svnprojects 这个目录下,像正常那样用 svnadmin create 命令建立 repo,如果要 checkout repo,则在命令行中输入:
svn checkout svn://192.168.0.1/project1
如果要 commit 刚需要输入刚才设置好的用户名和密码:
svn commit -m "we are commiting changes!" --username testsvn --password tester
3.2 给 Windows 用户的建议
如果你打算在 Windows 系统上运行 svnserve,只是简单的在命令行输入 svnserve -d -r d:/svnprojects 不是个好方法,一是每次都这么干太麻烦,二是服务器启动后为了保持它的运行,你必须让命令提示符窗口一直悬在桌面上,影响美观。最好是把 svnserve 作为系统的一个进程每次启动自动运行:
D:/> sc create svn
binpath= "D:/svn/bin/svnserve.exe --service -r D:/svnprojects"
displayname= "Subversion Server"
depend= Tcpip
start= auto
把当中的路径换成你的 svn 安装目录就可以了。
4. 在 Apache 下建立 subversion 服务器
在 Apache 中部署 Subversion 实际上并不比用 svnserve 难多少,它的难点在于一般人没有修改 Apache 配置的权限,如果你有相应的修改权限,那么搭建一个 svn 服务器不是一件难事,我们来看看应该怎么配置。
4.1 准备工作
首先确定 Apache 正确安装,mod_dav 和 mov_dav_svn 这两个模块也被启用,在 Debian 系的 Linux 上可以这么安装:
sudo apt-get install apache2 subversion libapache2-svn
在 Windows 平台上,可以下载一个 XAMPP,Apache MySQL PHP 什么的就都有了。
确定 mod_dav 和 mod_dav_svn 被打开:
a2enmod dav dav_svn
4.2 基本设置
以上的准备工作做完后,就正式开始了,还是拿 part2 的机器网络环境,同样的例子。
我准备让 repo 的网络访问地址成为 http://192.168.0.1/svnprojects/projectX,
修改 /etc/apache2/conf 下的 httpd.conf,加入如下代码:
<Location /svnprojects>
DAV svn
SVNParentPath /path/to/svnprojects
</Location>
更多详细的<Location>命令用法请参见 Apache 手册,下同。SVNParentPath 命令用来把网络访问地址和 repo 的实际地址对应起来。
这样就设置完了,如果你把 repo 建立好了,现在就已经可以 checkout 了,输入:
svn checkout http://192.168.0.1/svnprojects/project1
4.3 设定用户的权限和验证
但这样肯定是不够的,因为还没有设定相应的用户权限,现在不管谁都可以往 repo 里塞东西,为了更好的控制,我们还需要设定访问权限,比如让指定的用户可以 commit,其他的只能 checkout。
因为我们在 Apache 上,所以访问权限的控制就可以直接借用 Apache 的,首先为你的用户设定用户名和密码:
htpasswd -cmb /path/to/passwdfile/passwords user1 test1
这样就把用户名和密码储存在 passwords 中了,加密方式为 MD5。如果需要添加新的用户,
htpasswd -mb /path/to/passwdfile/passwords user2 test2
以此类推。
然后回到我们在 httpd.conf 中添加的代码,修改一下:
<Location>
DAV svn
SVNParentPath /path/to/svnprojects
AuthType Basic
AuthName "Test Repository"
AuthUserFile /path/to/passwdfile/passwords
<LimitExcept GET PROPFIND OPTION REPORT>
Require valid-user
</LimitExcept>
</Location>
在这段代码的控制下,任何人都可以对 repo 进行 checkout,但只有 user1 和 user2 才可以 commit,<LimitExcept> 的作用是控制 HTTP 请求,如果 HTTP 请求是 GET PROPFIND OPTION REPORT 中的一种,则不需要去验证用户。
最后,你需要把 repo 所在的目录和文件的所有权都改成系统中操作 Apache 的用户,这样在 commit 的时候才会被 Apache 认可。在 Ubuntu 中,这个用户叫 www-data:
sudo chown -R www-data /path/to/repo
如果你用其它系统或是用 Windows,可以在 Apache 的配置文件中找到 User 这个命令来知道应该把目录的所有权交给谁。
以上就是一个初步的 Subversion 服务器的搭建,这一篇考虑到实际上用的人可能不多,要用的人估计肯定会自己配置,因此我写的不够细致,比如说没有说到基于 SSL 的设置步骤。如果你确实需要了解,可以联系我,我们一起探讨。