个人环境搭建——版本控制SVN

版本控制SVN

SVN服务器配置：

第一部分：svn服务器搭建（主要是四步走）

    参考：http://www.son1c.cn/show/920.html

一，安装Subversion

1. sudo apt-get install subversion  

二，创建版本库

2.添加svn管理用户及subversion组

1. cd /home/username
2. mkdir myproject
3. svnserve -d -r /home/username         （第一步：先启服务器）
4. svnadmin create myproject                （第二步：再建仓库）
5. sudo chmod -R g+rws myproject    //赋予组成员对所有新加入文件仓库的文件拥有相应的权限

     注意：若要启动两个svn服务器，则要指明端口，默认的服务器端口是3690。

     svnserve -d -r /home/username   <＝>（等价于）svnserve -d  --listen-port=3690  -r /home/username

    若要启动第二个服务器，则可svnserve -d  —listen-port=3691  -r /home/username2，但同时后面在checkout时要指明第二个服务器 的端口，如  svn co svn://192.168.1.1:3691/myproject。

如果启动成功了，通过ps aux | grep svnserve可以看到进程，至此一个最简单的SVN服务就搭建好了。把这个命令放到rc.local中，让每次开机都启动SVN服务。

三，修改用户名和密码   （第三步：建完仓库后配置权限）

修改SVN服务器根目录（即 /home/username/myproject目录）有一个叫conf的文件夹下的：

svnserve.conf 、passwd 、authz三个文件,这三个文件的作用分别是：主配置文件、密码配置文件、权限配置文件。

1，修改/home/username/myproject/conf/svnserve.conf，把下面三行的注释去掉

1. anon-access = read  
2. auth-access = write  
3. password-db = passwd 

     注意：去掉注释时要保证anon-access = read 、auth-access = write和password-db = passwd是顶格形式（即该行的前面没有空格） ，否则会出现svnserve.conf:12:Option expected的错误。

其中 anon-access 和 auth-access 分别为匿名和有权限用户的权限，默认给匿名用户只读的权限,但如果想拒绝匿名用户的访问，只需把 read 改成 none 就能达到目的。

     可参考http://www.51testing.com/?uid-209173-action-viewspace-itemid-92904 的解释。

2，修改/home/username/myproject/conf/passwd，添加用户和密码

1. sun = 123456  
2. lucia = lucia 
3. svntest1 = 123456
4. svntest2 = 123456

    格式很简单，用户名、密码，每行一个，默认是明文保存。 这一步骤同样要注意上面提到的顶格形式，否则svn服务器读取passwd时不能识别。

 

3，修改/home/username/myproject/conf/authz，修改用户和组的权限

1.[groups]
2.develop = svntest1,sun
3.test = svntest1,svntest2
4.[/]
5.@develop=rw
6.*=r

这里设置了三个用户sun,svntest1,svntest2密码都是123456;其中sun,svntest1属于develop组，有读和写的权限; svntest1,svntest2属于test组只有读的权限;

[groups] 组是设置用户组的，比如：我设置的develop可以理解为开发人员组，等号的后面是组的成员，每个成员之间用逗号分隔。

接下来的[/]为具体的某个地址设置权限，用@develop代表为develop组设置权限，rw代表又能读又能写。还有其他的复杂用法，不过我只懂最简单最常用的，所以其他的都跳过；

 

四，导入project       （第四步：权限设完导文件）

1. svn import -m "Import rails project hilog" /home/username/workspace/hilog svn://192.168.1.1/myproject/

     注意：导完文件（包含目录）后，就与原始导入目录/home/username/workspace/hilog无关，即“过河拆桥”。 因此，本地客户端使用也需要下面的步骤。

五，导出project

     说明：其实，该步骤属于客户端的操作，写在这里是因为假如你只是搭建一个供你自己在本地使用的svn服务器，那么你的机器既是svn服务器，又是svn客户端。你若要在本地同步svn服务器的数据的话，也要执行checkout等客户端命令。 

1. svn co svn://192.168.1.1/myproject/    <=>  svn co svn://192.168.1.1:3690/myproject/

     ok，可以用了！checkout不需要认证，checkin需要。 
     这是使用Subversion自带的svn协议和svnserve工具简单的搭建svn服务器，还可以结合Apache搭建http://和 https://协议的svn服务器及安装Trac

 接下来测试验证，在客户机上找个目录执行一下命令

svn co svn://192.168.0.111/myproject --username=sun --force

svn://192.168.0.111/myproject 就是新建的代码仓库的地址，假设刚才的服务是建在192.168.0.111上的。

--username是指定用户名的，不指定的话会以当前的系统用户登录，系统用户和SVN用户是不相干的两套，所以还是人工指定的好。

--force参数可有可无，如果在同一个地址上反复测试，删了建建了删，SVN客户端会缓存住上一次成功checkout的UUID，如果删了再建UUID会发生改变，客户端校验不一致会提示“myprojectitory UUID 'xxx' doesn't match expected UUID 'xxx'”，加--force参数就不理会这个校验，强行checkout。如果顺利的话，会提示“Checked out revision 0.”，然后在当前目录下生成一个myproject的目录，里面就是代码仓库的代码了

第二部分：客户端使用

    主要是各种命令的使用，以下是我摘录的最简明的解释

    摘自：http://www.91linux.com/html/article/program/php/20090101/15220.html

1、 将文件checkout到本地目录（我注：checkout最新版,若要checkout其他版本请用update）

svn checkout path（path是服务器上的目录）
例如：svn checkout svn ://192.168 .1.1 /pro/domain
简写：svn co

2、 往版本库中添加新的文件

svn add file
例如：svn add test.php(添加test.php)
svn add *.php(添加当前目录下所有的php文件)

3、 将改动的文件提交到版本库

svn commit -m “LogMessage“ [ -N] [ --no-unlock] PATH (如果选择了保持锁，就使用–no-unlock开关)
例如：svn commit -m “add test file for my test“ test.php
简写：svn ci

4、 加锁/解锁

svn lock -m “LockMessage“ [ --force] PATH 
例如：svn lock -m “lock test file“ test.php
svn unlock PATH

5、 更新到某个版本

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

6、 查看文件或者目录状态（我注：这是一条本地命令，用来显示自己改动了哪些文件 ）

1）svn status path （目录下的文件和子目录的状态，正常状态不显示）
【?：不在svn 的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】
2）svn status -v path (显示文件和子目录状态)
第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。
注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn 中保留了本地版本的原始拷贝。
简写：svn st

7、 删除文件

svn delete path -m “delete test fle“
例如：svn delete svn ://192.168.1.1/pro/domain/test.php -m “delete test file”
或者直接svn delete test.php 然后再svn ci -m ‘delete test file‘，推荐使用这种
简写：svn (del, remove, rm)

8、 查看日志

svn log path
例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化

9、 查看文件详细信息

svn info path
例如：svn info test.php

10、 比较差异

svn diff path(将修改的文件与基础版本比较)
例如：svn diff test.php
svn diff -r m:n path(对版本m和版本n比较差异)
例如：svn diff -r 200:201 test.php
简写：svn di

11、 将两个版本之间的差异合并到当前文件

svn merge -r m:n path
例如：svn merge -r 200:205 test.php（将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下）

12、 SVN 帮助

svn help
svn help ci

——————————————————————————

以上是常用命令，下面写几个不经常用的

——————————————————————————

13、 版本库下的文件和目录列表

svn list path
显示path目录下的所有属于版本库的文件和目录
简写：svn ls

14、 创建纳入版本控制下的新目录

svn mkdir : 创建纳入版本控制下的新目录。
用法: 1、mkdir PATH…
2、mkdir URL…
创建版本控制的目录。
1、每一个以工作副本 PATH 指定的目录，都会创建在本地端，并且加入新增
调度，以待下一次的提交。
2、每个以URL指定的目录，都会透过立即提交于仓库中创建。
在这两个情况下，所有的中间目录都必须事先存在。

15、 恢复本地修改

svn revert : 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:
用法: revert PATH…
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复
被删除的目录

16、 代码库URL变更

svn switch (sw): 更新工作副本至不同的URL。
用法: 1、switch URL [PATH]
2、switch –relocate FROM TO [PATH...]

1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将
服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的
方法。
2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动
(比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用
这个命令更新工作副本与仓库的对应关系。

17、 解决冲突

svn resolved: 移除工作副本的目录或文件的“冲突”状态。
用法: resolved PATH…
注意: 本子命令不会依语法来解决冲突或是移除冲突标记；它只是移除冲突的
相关文件，然后让 PATH 可以再次提交。

18、 输出指定文件或URL的内容。

svn cat 目标[@版本]…如果指定了版本，将从指定的版本开始查找。
svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)

其他资源：

官方的svn使用手册，网页版

第三部分 常见错误提示

在使用SVN进行代码代码提交的过程中，客户端常返回一些错误提示，如下表所示：

错误提示	错误原因及解决方案
Certificate expired	证书过期。 解决方案详见提示SVN证书过期？
Unable to connect to a repository at URL!	无法访问该SVN库的地址。 一般是由于用户名密码错误导致的。解决方案详见用户名密码校验失败？
User xxx do not have permission to operate 1st or 2nd tier directory!	用户不能操作CEE SVN的一级和二级目录，只能修改应用的某个Web服务的某版本目录下的目录或文件。如/12345/ws/1/a.txt
Not allowed to commit .svny!	.svny不能操作，不允许向.svny目录中提交文件。
Sorry,file(xxx Bytes) is too large,limit 400 MBytes!	提交的文件中有超过大小限制的文件。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,your repository is too large,limit 3072 MBytes	超过SVN库的文件总容量上限。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,commit too many files, limit 2000!	单次提交的文件数超过上限。出现这种错误提示时，一般是由于单次提交的文件数过多，请分批多次提交。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,commit too large files, limit 3072 MBytes!	单次提交的文件大小超过上限。出现这种错误提示时，一般是由于单次提交的文件size过大，请分批多次提交。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,your repository has too many files(xxx),limit 100000	版本库文件总数超过CDN SVN库的上限。建议开发者自行删除CDN SVN库里的无效文件。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,the directory "/repo/path" contains too many files(xxx), limit 7000!	单目录文件数超过上限。建议开发者自行删除该目录下的无效文件，或将文件分散到不同目录中。 SVN文件及目录限制详见：SVN简介及使用限制#2. 系统限制，如果有特殊需要，请通过企业QQ联系腾讯技术支持申请，针对单个应用进行该限制的调整。
Sorry,please commit later	服务器繁忙，过一段时间后再提交。
Sorry, commit too frequently ,please commit later!	提交的频率超过限制，过一段时间后再提交。
xxx is out of date	如果执行svn commit命令时遇到该提示，那么一般是因为您修改了本地某文件或目录结构，而别人也修改了同一个的文件或目录并且先于您提交到了SVN库。 解决办法详见:SVN提交文件时提示文件冲突怎么办？
one or more files are in confict state	文件冲突。解决办法详见:SVN提交文件时提示文件冲突怎么办？
其它	更多SVN错误提示请参考：http://svndoc.iusesvn.com/ 。