个人环境搭建——版本控制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）

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

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

4、 加锁/解锁

5、 更新到某个版本

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

7、 删除文件

8、 查看日志

9、 查看文件详细信息

10、 比较差异

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

12、 SVN 帮助

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

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

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

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

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

15、 恢复本地修改

16、 代码库URL变更

17、 解决冲突

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/ 。