版本控制SVN
SVN服务器配置:
第一部分:svn服务器搭建(主要是四步走)
参考:http://www.son1c.cn/show/920.html
一,安装Subversion
- sudo apt-get install subversion
二,创建版本库
2.添加svn管理用户及subversion组
- cd /home/username
- mkdir myproject
- svnserve -d -r /home/username (第一步:先启服务器)
- svnadmin create myproject (第二步:再建仓库)
- 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,把下面三行的注释去掉
- anon-access = read
- auth-access = write
- 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,添加用户和密码
- sun = 123456
- lucia = lucia
- svntest1 = 123456
- 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 (第四步:权限设完导文件)
- 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等客户端命令。
- 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 | 证书过期。 |
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库的文件总容量上限。 |
Sorry,commit too many files, limit 2000! | 单次提交的文件数超过上限。出现这种错误提示时,一般是由于单次提交的文件数过多,请分批多次提交。 |
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库里的无效文件。 |
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/ 。 |