SVN配置与使用教程.ppt

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