• 1. SVN配置与使用教程yhuayun88@sina.com
  • 2. SVN安装配置1、软件下载 下载SVN1.6服务器程序。 http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 【注意】如果之前已经安装了TortoiseSVN客户端,必须选择与之配套的SVN服务端版本,否则会出现各种问题,可以从TortoiseSVN的"About"菜单中看到与之对应的Subversion版本! 下载Subversion的Windows客户端TortoiseSVN及简体中文语言安装包【根据个人爱好而定】 http://tortoisesvn.net/downloads
  • 3. 2、服务器和客户端安装。服务器安装,直接运行安装程序,根据提示安装即可,这样我们就有了一套服务器可以运行的环境。 安装TortoiseSVN,同样直接运行安装程序,按照提示安装即可,不过最后完成后会提示是否重启,其实重启只是使svn工作拷贝在windows中的特殊样式生效,与所有的实际功能无关。 重启完毕后安装简体中文语言包,然后在随便一个目录右击,就会发现多出了一些SVN相关菜单,选择其中的TortoiseSVN,再选择子菜单"Settings",设置Language为"中文(简体)"。
  • 4. 3、建立SVN1.6版本库(Repository) 运行Subversion服务器需要首先要建立一个版本库(Repository),版本库可以看作是服务器上集中存放和管理数据的地方。在安装客户端时默认已经创建了一个版本库,可以直接用这个库,或是根据需要重新建立一个库。 新建一个版本库具体操作步骤如下 首先建立 d:\svn 空文件夹作为所有版本库的根目录。然后,进入命令行并切换到subversion的bin目录。输入如下命令: svnadmin create D:\svn\repository1 此命令在 D:\svn 下建立一个版本库 repository1。repository1下面会自动生成一些文件夹和文件。就会在目录D:\svn\repository下创建一个版本库。 如果在命令行中不识别svnserver命令,可以查看系统环境变量path中有无subversion/bin的条目,没有就手动加上。 我们也可以使用 TortoiseSVN 图形化的完成这一步: 先建立空目录 E:\svn\repository1,注意一定是要空的。然后在 repository1文件夹上“右键->TortoiseSVN->Create Repository here”,然后可以选择版本库模式,这里使用默认的FSFS即可,然后就创建了一系列文件夹和文件,同命令行建立的一样。(可能有的版本不能直接选择版本库模式)
  • 5. 4、配置SVN1.6用户和权限 用文本编辑器打开E:\svn\repository1\conf目录,修改svnserve.conf: 将: # password-db = passwd 改为: password-db = passwd 即去掉前面的 # 注释符,注意前面不能有空格。 然后修改同目录的passwd文件,增加一个帐号: 将: [users] # harry = harryssecret # sally = sallyssecret 增加帐号: [users] #harry = harryssecret #sally = sallyssecret test = test
  • 6. 在svnserve.conf文件,这里行前凡是有#的都等于是被注释忽略了,你可以把#去掉让那一行生效,或者自己新添加行.里面的英文注释已经详细说明了各种设置的含义,最后你设置[general]小节中行前没有#号的内容为 anon-access=none auth-access=write password-db=passwd 含义是: 未验证用户无任何权限(如果把none修改为read就是给予读权限) 已验证用户给予写权限(当然也能读) 密码数据存放到passwd文件中 【注意】anon-access=none这条必须显示写出来,否则会有一个默认权限,别人可能不用登陆就能看到你的项目! 然后打开同目录的passwd文件来设置帐户: 同样,设置[users]小节中行前没有#号的内容,例如: admin=zhang 含义是: 用户admin的密码为zhang 该目录下还有一个authz的文件,用来针对不同的目录给用户分配不同的权限。
  • 7. 5、运行独立服务器 安装SVN1.6的bin目录有svnservice.exe。 在dos控制台状态下直接输入svnservice -d-r D:\svn\repository,(最后一个参数是刚才设置的版本库的位置),此时console处于阻塞状态,让它一直开着就行,关闭它就意味着关闭了svnservice的服务了。 建议你到控制面板-管理工具-服务中找到SVNService,右击选择"属性",再将其启动类型设置为"自动",这样每次开机自动启动服务,不用手动启动了。如果没有这项服务的话,在命令行输入sc create svnserver binPath= “\“D:\ProgramFiles\Subversion\bin\”--service -r D:\svn\repository“ DisplayName= "subversion“ depend= Tcpip start= auto 【注意】“=”前没有空格,之后必须有一个空格!
  • 8. 5、运行独立服务器 此时 subversion 服务还没有开始,只是通过它的命令建立了版本库。继续在刚才的命令窗口输入: svnserve.exe -d(等效于输入 svnserve.exe --daemon)   svnserve 将会在端口 3690 等待请求,--daemon(两个短横线)选项告诉 svnserve 以守护进程方式运行,这样在手动终止之前不会退出。注意不要关闭命令行窗口,关闭窗口会把 svnserve 停止。 为了验证svnserve正常工作,使用TortoiseSVN -> Repo-browser 来查看版本库。在弹出的 URL 对话框中输入: svn://localhost/svn/repository1 点 OK 按钮后就可以看见 repo1 版本库的目录树结构了,只不过这时 repository1是个空库。 你也可以使用--root选项设置根位置来限制服务器的访问目录,从而增加安全性和节约输入svnserve URL的时间: svnserve.exe --daemon --root drive:\path\to\repository 以前面的测试作为例,svnserve将会运行为: svnserve.exe --daemon --root e:\svn 然后TortoiseSVN中的版本库浏览器URL缩减为: svn://localhost/repository1
  • 9. 6、初始化导入 打开"我的电脑",在你需要进行版本控制的目录上右击,选择TortoiseSVN,再选择子菜单"Import...",设置"文件库url"为svn://localhost点确定后就会提示文件正在导入. 需要注意的是,这里是svn文件库与svn服务是同一台计算机的情况,所以可用localhost,其它机器如果要访问svn服务,应该用svn://svn服务器的IP地址,例如svn://192.168.1.125
  • 10. 下面就是将我们的数据(项目)导入到这个版本库,以后就由版本库管理我们的数据。我们的任何改动都回被版本库记录下来,甚至我们自己丢失、改错数据时版本库也能帮我们找回数据。 比如,在 d:\wwwroot 下有个 guestbook 文件夹,里面存放的是编写的留言簿程序。在此文件夹上“右键 -> TortoiseSVN -> Import...” ,在弹出对话框的“URL of repository”输入“svn://localhost/repository1/guestbook”。在“Import message”输入“导入整个留言簿”作为注释。 点 OK 后要求输入帐号。我们在用户名和密码处都输入 test 。完成后 guestbook 中的内容全部导入到了 svn://localhost/repository1/guestbook 。 我们看到在 e:\svn\repository1没有任何变化,连个 guestbook 文件夹都没有建立,唯一的变化就是e:\svn\repository1容量变大了。实际上我们源guestbook中的内容已经导入 repository1版本库了,源 guestbook 文件夹可以删除了。 需要注意的是,这一步操作可以完全在另一台安装了 TortoiseSVN 的客户机上进行。例如运行svnserve的主机的IP是133.96.121.22,则URL部分输入的内容就是“svn://133.96.121.22” 。
  • 11. 7、SVN1.6基本客户端操作1、取出(check out) 取出版本库到一个工作拷贝: 来到任意空目录下,比如在f分区建立一个空文件夹 f:\work 。“右键 -> SVN Checkout”。在“URL of repository”中输入“svn://localhost/svn/repository1/guestbook”,这样我们就得到了一份 guestbook 中内容的工作拷贝。 2、存入(check in)/提交(commit) 在工作拷贝中作出修改并提交: 在 guestbook 工作拷贝中随便打开一个文件,作出修改,然后“右键 -> SVN Commit... ”。这样我们就把修改提交到了版本库,版本库根据情况存储我们提交的数据。 在修改过的文件上“右键 -> TortoiseSVN -> Show Log” ,可以看到对这个文件所有的提交。在不同的 revision 条目上“右键 -> Compare with working copy”,我们可以比较工作拷贝的文件和所选 revision 版本的区别。
  • 12. 没安装TortoiseSVN的计算机先安装它。 创建一个准备用来存放版本控制工程的目录,例如d:\project,然后在"我的电脑"中右击这个目录,选择"SVN取出...",设置"文件库url"为svn://svn服务器的IP地址,接下来会问你用户名和帐号,你就填写前面搭建服务器端所设置的用户admin密码zhang 点确定后就会提示文件正在取出到d:\project,至此,SVN客户端配置完成,你会看到d:\project及其下面的文件都被标记了绿色对勾
  • 13. 简单日常使用: 要取得工程的当前的最新版本,右击d:\project,选择"SVNupdate",你更改工程后,要将你的修改更新到SVN,右击d:\project,选择"SVNcommit",谨慎的话请先更新到SVN最新版本后再提交。 创建服务 sccreatesvnserverbinPath="C:\ProgramFiles\Subversion\bin\svnserve.exe--service-rD:\svn\energy"DisplayName="energy_subversion"depend=Tcpipstart=auto sccreatesvnserverbinPath="服务全名--service-r资源库位置"DisplayName="服务名"depend=协议start=自动。
  • 14. SVN权限配置在 Subversion 的使用当中,存在“认证”、“授权”两个概念。认证,即 authentication,是指用户名与密码的认证。授权,即 authorization ,是指某用户对某个目录是否具备读、写权限的一种审核。这两者配合作用,就组成了 Subversion 的整个帐户管理体系。 Subversion 提供了面向目录的帐户权限管理功能,通过它,我们就可以很精确地实现项目目录的访问控制。
  • 15. 背景假设一家电子元器件设备供应商,其中有个ARM部门,专门负责ARM芯片的方案设计、销售,并在北京、上海各设立了一个办事处。对于工作日志,原先采用邮件方式发给经理,但是这种方式有个缺点,那就是不具备连续性,要看以前的日志必须一封一封邮件去查看,很麻烦。于是就想到利用 Subversion, 让员工在自己电脑上编辑日志,然后利用svn传送回来,既方便员工自己编写日志,又方便对日志的归档处理,而且提交日志的时候只需要执行一下 svn commit 即可,比发送邮件还要简单的多。
  • 16. svn服务器相关信息 服务器地址: 192.168.0.1 服务器OS: MS Windows 2000 Server Edition 中文版 用于存放日志的代码库本地目录: D:\svn\arm arm部门文档的目录结构如下: arm 部门名称 ├─diary 工作日志目录 │ ├─headquarters 总部工作日志目录 │ ├─beijing 北京办日志目录 │ └─shanghai 上海办日志目录 ├─ref 公司公共文件参考目录 └─temp 临时文件目录
  • 17. 人员情况 morson,公司总经理,不习惯使用电脑,更喜欢传统的纸与笔,以及面对面的交流 michael,arm事业部的部门经理 scofield,北京办人员 lincon,上海办人员 linda,总部协调员、秘书 rory,单片机技术员,技术支持 访问权限需求分析 允许总经理、部门经理读取所有文件。顺便给他们开放写权限,以便体现对他们职位的尊重,虽然对于某些文件来说,他们若拥有“写”权限其实也没什么用处 除部门经理外,所有其他人员,均只能看到本办事处人员工作日志 不允许匿名访问 ref目录只允许经理和秘书读写,对其他人只读 temp目录人人都可以随意读写
  • 18. 1.启动Subversion服务在服务器端,打开一个命令行窗口,用CD命令进入 Subversion 安装目录下的 bin 目录,运行如下指令: svnserve -d -r E:\svn 其中的 -d 参数表示 svnserve.exe 将会作为一个服务程序运行在后台,而 -r 参数表示将 E:\svn 目录指定为代码库的根目录。这样,当客户端使用类似 svn://192.168.0.1/foo 这样内容的 URL 来访问服务器时候,其所访问到的真实代码库,其实就是 E:\svn\foo
  • 19. 2.建立代码库在服务器端的 E:\svn 目录下,建立一个名为 arm 的代码库,命令如下: E:\svn>svnadmin create arm 使用上述命令之后,如果不出问题的话,在 E:\svn 目录下就会多出一个叫做 arm 的目录,其下具备 conf、dav、hooks、locks、db 等子目录或文件,此即 一个名为arm的代码库 。从此,通过 svn://192.168.0.1/arm 这样的 URL,我们就可以对这个代码库进行访问了。接下来就要进入本文的正题了,也就是权限配置部分了。 其实进入 arm\conf 目录你就会发现,它下面已经存在三个写了一些帮助信息和示例的配置文件,以帮助用户尽早掌握其配置方法。这三个默认的配置文件分别是 svnserve.conf、passwd、authz 。其中后两者没有后缀,对于 windows 系统的用户来说,看起来总是有些怪异,所以在接下来的章节里面,我将它们两个都给添加了个 conf 后缀,以便管理。
  • 20. 3.编辑代码库基础配置文件 在服务器端,编辑代码库的 arm\conf\svnserve.conf 文件,如下: [general] password-db = passwd.conf anon-access = none auth-access = write authz-db = authz.conf
  • 21. 4.管理用户帐号 在服务器端,新建 arm\conf\passwd.conf 文件,如下: [users] morson = ShowMeTheMoney michael = mysecretpassword scofield = hellolittilekiller lincon = asyouknows111 rory = 8809117 linda = IlikeWorldCup2006
  • 22. 建立目录访问权限控制文件 在服务器端,新建 arm\conf\authz.conf 文件,内容如下: [groups] g_vip = morson g_manager = michael g_beijing = scofield g_shanghai = lincon g_headquarters = rory, linda g_docs = linda [arm:/] @g_manager = rw * = r [arm:/diary/headquarters] @g_manager = rw @g_headquarters = rw @g_vip = r * = [arm:/diary/beijing] @g_manager = rw @g_beijing = rw @g_vip = r * = [arm:/diary/shanghai] @g_manager = rw @g_shanghai = rw @g_vip = r * = [arm:/ref] @g_manager = rw @g_docs = rw * = r [arm:/temp] * = rw
  • 23. 6.导入代码 在客户机 F:\temp 目录下,建立好前述“背景假设”一节中描述的目录结构,然后用命令 F:\temp>svn import arm svn://192.168.0.1/arm --username michael --password mysecretpassword 导入整个目录结构。 这条指令的精确意思是,将 arm 目录下面的所有东西,导入到那个名叫 arm 的代码库中去。如果你不指定源目录,则 svn 会默认将当前目录作为源目录。比如说,你处于 F:\temp 目录下的时候,直接执行 svn import svn://192.168.0.1/arm ,那么当你取出你的代码的时候,你会发现,居然多了一层名为 arm 的目录。结果,你就必须使用类似 svn://192.168.0.1/arm/arm 这样怪异的URL,才能够正确访问到你的代码们。 这一点粗看好像不是特别重要,不过联想到前述的目录授权规则,可都是按照标准的项目目录结构来设计的。突然之间,你项目的根目录之上,多出了一个名为 arm 的目录,那么我们的所有目录授权规则,基本上都要全部改过了,否则除了根目录,你永远会得到一个莫名其妙的“access denied”。由于 Subversion 在这一步骤上的界面不够人性化,因此这是初学者很容易弄混的地方之一。
  • 24. 7.测试在服务器上,打开一个 DOS Prompt 窗口,输入如下指令: svn co svn://127.0.0.1/arm --no-auth-cache --username rory --password 8809117 我们应该得到如下目录结构: Arm ├─diary │ └─headquarters ├─ref └─temp 然后修改ref目录下任意文件并提交,服务器将会报错“Access denied”,Bingo!
  • 25. 详细说明下面将详细两个配置文件: svnserve.conf 和 authz.conf,通过对配置逐行的描述,来阐明其中的一些细节含义。 这里首先要注意一点,任何配置文件的有效配置行,都 不允许存在前置空格 ,否则程序可能会出错,给你一个 Option expected 的提示。
  • 26. svnserve.conf 首先,我们告诉 svnserve.exe,用户名与密码放在 passwd.conf 文件下。当然,你可以改成任意的有效文件名,比如默认的就是 passwd: password-db = passwd.conf 接下来这两行的意思,是说只允许经过验证的用户,方可访问代码库。目前只允许 read write none 三种值 anon-access = none auth-access = write 接下来就是最关键的一句呢,它告诉 svnserve.exe,项目目录访问权限的相关配置是放在 authz.conf 文件里: authz-db = authz.conf
  • 27. authz.conf 之用户分组 arm\conf\authz.conf 文件的配置段,可以分为两类, [group] 是一类,里面放置着所有用户分组信息。其余以 [arm:/] 开头的是另外一类,每一段就是对应着项目的一个目录,其目录相关权限,就在此段内设置。 首先,我们将人员分组管理,以便以后由于人员变动而需要重新设置权限时候,尽量少改动东西。我们一共设置了5个用户分组,分组名称统一采用 g_ 前缀,以方便识别。当然了,分组成员之间采用逗号隔开:
  • 28. [groups] # 任何想要查看所有文档的非本部门人士 g_vip = morson # 经理 g_manager = michael # 北京办人员 g_beijing = scofield # 上海办人员 g_shanghai = lincon # 总部一般员工 g_headquarters = rory, linda # 小秘,撰写文档 g_docs = linda 注意到没有, linda 这个帐号同时存在“总部”和“文档员”两个分组里面,这可不是写错了,是因为 Subversion 允许这样设置。它意味着,这个人所拥有的权限,将会比他的同事 rory 要多一些,这样的确很方便。
  • 29. authz.conf 之项目根目录 接着,对项目根目录做了限制,该目录只允许arm事业部的经理才能修改,其他人都只能查看: [arm:/] @g_manager = rw * = r [arm:/] 表示这个目录结构的相对根节点,或者说是 arm 项目的根目录。其中的 arm 字样,其实就是代码库的名称,即前面用 svnadmin create 命令创建出来的那个 arm。 这里的 @ 表示接下来的是一个组名,不是用户名。因为目前 g_manager 组里面只有一个 michael,你当然也可以将 @g_manager = rw 这一行替换成 michael = rw ,而表达的意义完全一样。 * 表示“除了上面提到的那些人之外的其余所有人”,也就是“除了部门经理外的其他所有人”,当然也包括总经理那个怪老头 * = r 则表示“那些人只能读,不能写”
  • 30. authz.conf 之项目子目录 然后,我们要给总部人员开放日志目录的读写权限: [arm:/diary/headquarters] @g_manager = rw @g_headquarters = rw @g_vip = r * = 这个子目录的设置有些特色,因为从需求分析中我们知道,这个子目录的权限范围要比其父目录小,它不允许除指定了的之外其他任何人访问。在这段设置中,我们需要注意以下几点: 为了表示 diary\headquarters 这个目录,我们必须使用 [arm:/diary/headquarters] 这样的格式。 这里最后一行的 * = 表示,除了经理、总部人员、特别人士之外,任何人都被禁止访问本目录。这一行是否可以省略呢?不行,因为 权限具备继承性 ,子目录会自动拥有父目录的权限。若没有这一行,则所有帐号都可以读取 /diary/headquarters 目录下的文件。* = 这一句的目的,就是割断权限继承性,使得管理员可以定制某个目录及其子目录的权限,从而完全避开其父目录权限设置的影响。 之所以这儿需要将 @g_vip = r 一句加上,就是因为存在上述这个解释。如果说你没有明确地给总经理授予读的权力,则他会和其他人一样,被 * = 给排除在外。 各个配置行之间,没有 先后顺序 一说。也就是说,如果我将本段配置的 * = 这一行挪到最前面,完全不影响整个配置的最终效果。
  • 31. 接下来我们看看这一段: [arm:/ref] @g_manager = rw @g_docs = rw * = r 这里的主要看点,就是 g_docs 组里面包含了一个 linda 帐号,她也同时在 g_headquarters 组里面出现,这就意味着, linda 将具备对 /ref 和 diary\headquarters 两个目录的读写权限
  • 32. authz.conf 之目录表示法 在前面的描述中,我们都采用 [repos:/some/dir] 这样的格式来表示项目的某个目录,比如上一小节中的 [arm:/diary/headquarters] 。而实际上,Subversion 允许你采用 `[/some/dir] 这样的格式,即不指定代码库的方式来表示目录,此时的目录就匹配所有项目。 对于使用 svnserve 的用户来说,只有当 svnserve 运行的时候使用了 -r 参数,并且让多个代码库共享同一个目录权限文件(即 authz.conf 或 authz)时,不指明代码库名称才有可能惹麻烦。一般情况下,我们对每个代码库都会独立使用配置文件,毕竟每个项目的目录结构,都有很大不同,混在一起意义不大。因此一般来说,为简洁起见,都可以不指明代码库名称。本文全都指明了代码库名称,主要是为了将来扩展成同一个配置文件,以方便配合 Apache 服务器。 对于使用 Apache 的用户来说,它们二者可有着很大的不同,因为此时往往习惯于使用一个公共的目录权限配置文件。如果你使用了 SVNParentPath 指令,则指定版本库的名字是很重要的,因为假若你使用后者,那么 [/some/dir] 部分就会与所有代码库项目的 [/some/dir] 目录匹配。如果你使用 SVNPath 指令,则这两种表示方式就没有什么区别了,毕竟只有一个版本库。
  • 33. authz.conf 的其他注意点 1. 父目录的 r 权限,对子目录 w 权限的影响 方便那些想在一个代码库存放多个相互独立的项目的管理员,来分配权限了。比如说给一公司建立一个大的代码库用于存放所有员工日志,叫做 diary,而arm事业部只是其中一个部门,则可以这样做: [diary:/] @g_chief_manager = rw [diary:/arm] @g_arm_manager = rw @g_arm = r 这样,对于所有arm事业部的人员来说,就可以将 svn://192.168.0.1/diary/arm 这个URL当作根目录来进行日常操作,而完全不管它其实只是一个子目录,并且当有少数好奇心比较强的人想试着 checkout 一下 svn://192.168.0.1/diary 的时候,马上就会得到一个警告“Access denied” 。
  • 34. 2. 默认权限 如果说我对某个目录不设置任何权限,会怎样?马上动手做个试验,将: [diary:/] @g_chief_manager = rw 改成: [diary:/] # @g_chief_manager = rw 这样就相当于什么都没有设置。此时是禁止任何访问。也就是说,如果你想要让某人访问某目录,你一定要显式指明这一点。
  • 35. 3. 只读权限带来的一个小副作用 若设置了: [arm:/diary] * = r 则 Subversion 会认为,任何人都不允许改动 diary 目录,包括删除、 改名 ,和 新增 。 也就是说,如果你在项目初期创建目录时候,一不小心写错目录名称,比如因拼写错误写成 dairy,以后除非你改动 authz.conf 里面的这行设置,否则无法利用 svn mv 命令将错误的目录更正
  • 36. 4. anon-access 属性对目录权限的影响 你想将你的代码库开放给所有人访问,于是你就开放了匿名访问权限,在 svnserve.conf 文件中添加一行: anon-access=read 。可是对于部分目录,你又不希望别人看到,于是针对那些特别目录,你在 authz.conf 里面进行配置,添加了授权访问的人,并添加了 * = 标记。你认为一切OK了,可是你缺发现,那个特别目录却无法访问了,总是提示 Not authorized to open root of edit operation 或者 未授权打开根进行编辑操作 。你再三检查你配置的用户名与密码,确认一切正确,还是无法解决问题。 原来,Subversion 有个小 bug ,当 anon-access=read 并且某个目录有被设置上 * = 标记,则会出现上述问题。这个 bug 在当前最新版本上(v1.4)还存在,也许在下一版本内可以被改正吧。 解决的办法是,在 svnserve.conf 中,将 anon-access 设置成 none 。
  • 37. (本页无文本内容)