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

时间:2021-11-15 08:39:44

版本控制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/ 。