【山外笔记-工具框架】SVN版本控制系统

【山外笔记-框架工具】SVN版本控制系统

学习资料:

1、本文打印版下载地址:[山外笔记-框架工具笔记]SVN版本控制工具-打印版.pdf

2、SVN和TortoiseSVN在线中文文档:http://svndoc.iusesvn.com/

3、SVN教程-菜鸟教程:https://www.runoob.com/svn/svn-tutorial.html

4、SVN中文手册下载地址:svnbook1.4中文手册.pdf

5、TortoiseSVN中文文档下载地址:TortoiseSVN-1.9.3-zh_CN中文使用手册.pdfTortoiseMerge-1.9.3-zh_CN.pdf

6、TortoiseSVN安装包:TortoiseSVN-1.13.1.28686-x64-svn-1.13.0.msi

7、TortoiseSVN语言包(中文):LanguagePack_1.13.1.28686-x64-zh_CN.msi

本文重点内容:

1、SVN概述

2、SVN安装

3、SVN生命周期

4、SVN服务端操作

5、SVN客户端操作

6、TortoiseSVN 使用教程

一、SVN概述

1、SVN简介

(1)SVN是Apache Subversion的缩写,是一个开源的版本控制系统。

(2)SVN在2000年由CollabNet Inc开发,现已发展成为Apache软件基金会的一个项目。

(3)SVN管理着随时间改变的数据(比如代码),这些数据放置在一个中央资料档案库(repository)中,这个档案库会记住每一次文件的变动,可以把档案恢复到旧的版本, 或是浏览文件的变动历史。

(4)SVN管理源代码以行为单位,只要不是修改同一行代码,SVN都会自动合并两种修改。如果是同一行,SVN 会提示文件冲突(Conflict),需要手动确认。

(5)SVN相对于的RCS、CVS,采用了分支管理系统,设计目标就是取代CVS。

(6)SVN源代码地址:https://github.com/apache/subversion

2、SVN基本概念

(1)repository(源代码库):源代码统一存放的地方。

(2)Checkout(提取):从版本库创建一个工作副本到本地目录。

(3)Commit(提交):提交本地已修改的代码到版本库(repository)中。

(4)Update (更新):更新本地工作副本,和版本库同步。

3、SVN的主要功能

(1)目录版本控制

CVS只能跟踪单个文件的历史,但SVN能够依时间跟踪整个目录的变动,目录和文件都能进行版本控制。

(2)真实的版本历史

无论是文件还是目录,在SVN中可以增加(add)、删除(delete)、复制(copy)和重命名(rename),所有的新加的文件都从一个新的、干净的版本开始。

(3)自动提交

SVN允许一次提交,不管是单个还是多个文件都是作为一个整体提交的。允许开发人员以逻辑区间建立并提交变动,以防止当部分提交成功时出现的问题。

(4)纳入版本管控的元数据

每一个文件与目录都附有一组可以创建的属性关键字和属性值,即Key/Value。属性是随着时间来作版本管控的,就像文件內容一样。

(5)选择不同的网络层

  • ① SVN有抽象的档案库存取概念, 可以很容易地实施新的网络机制。
  • ② SVN可以作为一个扩展模块嵌入到Apache HTTP服务器中。
  • ③ SVN还提供了许多重要功能: 如身份认证, 授权, 在线压缩, 以及文件库浏览等等。
  • ④ SVN还有一个轻量级的独立SVN服务器,使用自定义的通信协议,可通过ssh以tunnel方式使用。

(6)一致的数据处理方式

SVN使用二进制差异算法来异表示文件的差异,将文件以压缩形式储存在档案库中,而且文件差异是以两个方向在网络上传输的。

(7)有效的分支(branch)与标签(tag)

SVN建立分支与标签的方法, 就只是复制该项目, 使用的方法就类似于硬连接(hard-link)。

(8)Hackability

SVN没有任何的历史包袱,主要是一群共用的C程序库,具有定义完善的API,便于维护。

4、SVN的优点:优于CVS之处

(1)原子提交:一次提交不管是单个还是多个文件,都是作为一个整体提交的。

(2)重命名、复制、删除文件等动作都保存在版本历史记录当中。

(3)对于二进制文件,使用了节省空间的保存方法。

(4)目录也有版本历史。整个目录树可以被移动或者复制,而且能够保留全部版本记录。

(5)分支的开销非常小。

(6)优化数据库访问,减少了不必要的数据库访问。

二、SVN安装

1、Windows下安装SVN

(1)下载地址:

(2)下载完成后,双击下载的安装文件进行安装,指定SVN的安装目录。

(3)添加环境变量:将SVN安装目录中的bin目录添加到path路径中。

(4)在CMD命令行窗口中输入svnserve -help命令验证是否安装成功。

2、CentOS下安装SVN

(1)大多数GNU/Linux发行版系统自带了SVN,使用svn --version命令检查是否安装。

(2)如果SVN客户端没有安装,将报告svn命令找不到的错误。

(3)如果SVN客户端已安装,将报告SVN的版本号和编译日期。

(4)安装命令:yum install -y subversion

3、Ubuntu下安装SVN

(1)大多数GNU/Linux发行版系统自带了SVN,使用svn --version命令检查是否安装。

(2)如果SVN客户端没有安装,将报告svn没有安装。

(3)如果SVN客户端已安装,将报告SVN的版本号和编译日期。

(4)安装命令:apt-get install subversion

三、SVN生命周期

1、创建版本库

(1)版本库相当于一个集中的空间,用于存放开发者所有的工作成果代码。

(2)版本库不仅能存放文件,还包括了每次修改的历史,即每个文件的变动历史。

(3)Create操作:用来创建一个新的版本库。

2、检出

(1)Checkout操作:用来从版本库创建一个工作副本。

(2)工作副本是开发者私人的工作空间,可以进行内容的修改,然后提交到版本库中。

3、更新

(1)update操作:用来更新版本库,将版本库同步到工作副本。

(2)版本库一直保持最新的代码,版本库一有更新,本地工作副本就会过期。

4、执行变更

(1)Rename操作:可以更改文件/目录的名字。

(2)移动操作:用来将文件/目录从一处移动到版本库中的另一处。

(3)添加操作:用来添加文件/目录,但这些添加的文件目录只是被添加进待变更列表中,直到执行了commit操作后才会成为版本库的一部分。

(4)删除操作:用来将文件从工作副本中删除掉,但该文件的实际删除只是被添加到了待变更列表中,直到执行了commit操作后版本库才会真正删除。

5、复查变化

(1)在commit操作之前复查下在工作副本中所进行的变动是一个很好的习惯。

(2)Status操作:列出工作副本中所进行的变动。

(3)Status操作只是提供了一个变动列表,但并不提供变动的详细信息。

(4)对工作副本的任何改动都会成为待变更列表的一部分,Status 操作就是用来查看这个待变更列表。

(5)diff操作:用来查看这些变动的详细信息。

6、修复错误

(1)Revert操作:重置对工作副本的修改,将会销毁待变更列表并将工作副本恢复到原始状态。

(2)Revert操作可以重置一个或多个文件/目录,也可以重置整个工作副本。

7、解决冲突

(1)Merge操作:自动处理可以安全合并的东西,其它的会被当做冲突。

(2)Resolve操作:用来帮助用户找出冲突并告诉版本库如何处理这些冲突。

8、提交更改

(1)Commit操作:用来将更改从工作副本到版本库。

(2)Commit操作会修改版本库的内容,其它开发者可以通过更新他们的工作副本来查看这些修改。

(3)Commit是一个原子操作,要么完全提交成功,要么失败回滚,用户不会看到成功提交一半的情况。

(4)在提交之前,必须将文件/目录添加到待变更列表中。列表中记录了将会被提交的改动。

(5)当提交的时候,通常会提供一个注释来说明改动。这个注释也会成为版本库历史记录的一部分。

四、SVN服务端操作

1、配置SVN启动模式

(1)新建版本库目录:mkdir /opt/svn

(2)创建版本库:svnadmin create /opt/svn/svntest

(3)启动版本库:svnserve -d -r 目录--listen-port 端口号

  • ① -r:配置方式决定了版本库访问方式。
  • ② --listen-port:指定SVN监听端口,不加此参数,SVN默认监听3690

(4)单库svnserve方式:-r直接指定到版本库

  • ① 命令:svnserve -d -r /opt/svn/svntest

  • ② 一个svnserve只能为一个版本库工作。

  • ③ authz配置文件中对版本库权限的配置:

    [groups]
    admin=user1
    dev=user2
    [/]@admin=rw
    user2=r
    
  • ④ URL:输入svn://192.168.0.1/,即可访问svntest版本库

(5)多库svnserve方式:-r指定到版本库的上级目录

  • ① 命令:svnserve -d -r /opt/svn

  • ② 一个svnserve可以为多个版本库工作。

  • ③ authz配置文件中对版本库权限的配置:

    [groups]
    admin=user1
    dev=user2
    [svntest:/]@admin=rw
    user2=r
    [svntest01:/]@admin=rw
    user2=r
    
  • ④ 用[/],则表示所有库的根目录,即[/src]表示所有库的根目录下的src目录。

  • ⑤ URL:svn://192.168.0.1/svntest,即可访问svntest版本库。

2、创建SVN版本库

(1)新建版本库目录:mkdir /opt/svn

(2)创建版本库:svnadmin create /opt/svn/svntest

(3)以多库svnserve方式启动SVN:svnserve -d -r /opt/svn,URL:svn://192.168.0.1/svntest01

(4)配置目录:/opt/svn/svntest/conf,包括svnserve.conf、passwd、authz配置文件。

(5)SVN服务配置文件:svnserve.conf

[general]
anon-access = none
auth-access = write
password-db = /home/svn/passwd
authz-db = /home/svn/authz
realm = tiku
  • ① anon-access:控制非鉴权用户访问版本库的权限,取值范围为write、read和none。即write为可读可写,read为只读,none表示无访问权限。默认值:read

  • ② auth-access:控制鉴权用户访问版本库的权限。默认值:write

  • ③ password-db:指定用户名口令文件,默认为conf目录中的passwd。

  • ④ authz-db:指定权限配置文件,实现以路径为基础的访问控制。默认值:authz

  • ⑤ realm:指定版本库的认证域,即在登录时提示的认证域名称。

    • ❶ 若两个版本库的认证域相同,建议使用相同的用户名口令数据文件。
    • ❷ 默认值: UUID(Universal Unique IDentifier,全局唯一标示)。

(6)用户名口令文件passwd

  • ① 用户名口令文件由svnserve.conf的配置项password-db指定,默认为conf目录中的passwd。

  • ② passwd文件仅由一个[users]配置段组成。

  • ③ [users]配置段配置行格式:<用户名> = <口令>

    [users]
    admin = admin
    thinker = 123456
    

(7)权限配置文件authz

  • ① 权限配置文件由svnserve.conf的配置项authz-db指定,默认为conf目录中的authz。

  • ② authz配置文件由一个[groups]配置段和若干个版本库路径权限段组成。

  • ③ [groups]配置段中配置行格式如下:<用户组> = <用户列表>

  • ④ 版本库路径权限段的段名格式如下:[<版本库名>:<路径>]

    [groups]
    g_admin = admin,thinker
    [admintools:/]
    @g_admin = rw
    * =
    [test:/home/thinker]
    thinker = rw
    * = r
    

五、SVN客户端操作

1、SVN检出操作

(1)创建版本库svntest,URL为svn://192.168.0.1/svntest,svn用户user01有读写权限。

(2)检出命令:svn checkout svn://192.168.0.1/svntest --username=user01

(3)查看检出工作副本信息命令:svn info .

2、SVN提交操作

(1)在工作副本中新建一个文件:echo “Hello,SVN” > HelloSVN.txt

(2)查看工作副本状态:svn status,状态显示为?,说明还未加到版本控制中。

(3)添加到版本控制中:svn add HelloSVN.txt

(4)查看工作副本状态:svn status,状态显示为A,说明已添加到版本控制中。

(5)提交到版本库:svn commit -m "SVN readme."

  • ① -m:备注本次提交的注释信息,如果忽略了,SVN会打开一个文本编辑器来让你输入提交信息。
  • ② 命令执行后会输出提交的文件,并且修订版本号自动增加了1。
3、SVN解决冲突

(1)冲突的原因:SVN管理源代码以行为单位,只要不是修改同一行代码,SVN都会自动合并两种修改。如果是同一行,SVN 会提示文件冲突(Conflict),需要手动确认。

(2)解决过程:假设版本库版本号为10时,用户A和用户B同时对修改了svntest.txt文件中的同一行。

  • ① 用户A先提交了自己修改的文件到版本库,提交成功后,版本库版本号变更为11.
  • ② 用户B提交自己修改的文件到版本库时,提交失败,产生冲突。
  • ③ 用户A提交后版本号已经变更,用户B的工作副本已经失效,SVN不会允许用户B提交修改操作。
  • ④ 用户B先查看用户A提交的修改和自己的修改的差异,执行svn diff命令。
  • ⑤ 用户B需要更新工作副本,执行svn update命令,可以指定更新到的版本,默认是最新的版本。
  • ⑥ 工作副本和版本库同步后,用户B可以提交自己的修改到版本库。
4、SVN版本回退

(1)svn revert操作:撤销任何文件或目录里的局部更改,即对文件的修改。

(2)撤销文件修改的具体操作流程:

  • ① 查看SVN状态:执行svn status命令,显示文件名及其状态,状态为M,说明文件被修改。

  • ② 撤销文件的修改:执行svn revert filename

  • ③ 再次查看SVN状态:执行svn status命令,没有任何显示,说明撤销成功。

(3)撤销目录修改操作同撤销文件修改,只是恢复目录用需要使用-R选项,即svn revert -R dirname

(4)恢复一个已经提交的版本

  • ① 消除旧版本,必须撤销旧版本里的所有更改然后提交一个新版本,这种操作叫做reverse merge。

  • ② 命令:svn merge -r 22:21 filename,当前版本22,上一个版本21。

5、SVN查看历史信息

通过svn命令可以根据时间或修订号去除过去的版本,或者某一版本所做的具体的修改。

(1)svn log:用来展示svn 的版本作者、日期、路径等等。

  • ① 只查看特定的某两个版本之间的信息:svn log -r 6:8
  • ② 只查看某一个文件的版本修改信息:svn log file_path/filename
  • ③ 只查看目录的版本修改信息:svn log -v file_path

④ 显示限定N条记录的目录信息:svn log -l N -v

(2)svn diff:用来显示特定修改的行级详细信息。

  • ① 比较工作副本接本地版本库的修改:svn diff
  • ② 比较工作副本与版本库的修改:svn diff -r 3 filename
  • ③ 比较版本库与版本库的修改:svn diff -r 2:3 filename,版本号之间用冒号分隔。

(3)svn cat:查看在特定版本中的某文件的内容,执行svn cat -r 版本号 filename

(4)svn list:显示一个目录或某一版本存在的文件,执行svn list -r 版本号 dir_path

6、SVN分支

Branch分支就是trunk版(主干线)的一个copy版,也具有版本控制功能,而且和主干线相互独立,最后可以通过合并功能,将分支合并到trunk上来,合并为一个项目。

(1)在本地工作副本创建一个分支:svn copy trunk/ branch/mybranch

(2)查看SVN状态:svn status

(3)提交新增的分支到版本库:svn commit -m "add my_branch"

(4)合并my_branch分支到trunk中:svn merge . ./branches/my_branch/

7、SVN标签(tag)

SVN支持tag选项,可以给某一个具体版本的代码一个标签,主要用于项目开发中的里程碑,往往代表一个可以固定的完整的版本。

(1)在本地工作副本创建一个tag分支:svn copy trunk/ tags/v1.0

(2)查看SVN状态:svn status

(3)提交tag内容: svn commit -m "tags v1.0"

六、TortoiseSVN使用教程

1、TortoiseSVN简介

TortoiseSVN是Subversion版本控制系统的一个免费开源GUI客户端

2、安装TortoiseSVN

(1)下载地址:https://tortoisesvn.net/downloads.html, 页面里有语言包补丁的下载链接。

(2)运行下载的 TortoiseSVN 安装程序

(3)运行下载的 TortoiseSVN 中文语言包

(4)重启电脑,确认TortoiseSVN安装完成。

(5)修改TortoiseSVN默认语言

  • ① TortoiseSVN默认语言英文,可以通过设置修改成已安装语言。
  • ② 鼠标在桌面空白处右击—>TortoiseSVN—>设置。
3、TortoiseSVN创建服务端版本库

(1)在本地新建一个目录,进入新建的目录.

(2)创建版本库:鼠标在空白右击—>TortoiseSVN—>在此创建版本库

(3)版本库创建完成后,目录中会出现Server端的文件,和svnserve命令创建的一致。

4、TortoiseSVN创建工作副本

(1)在本地创建工作目录,进入创建的目录.

(2)SVN检出:鼠标在空白右击,选择 SVN检出(checkout),弹出检出会话框。

  • ① 版本库URL:repository(版本库)的位置URL,即svn://192.168.0.1/svntest
  • ② 检出至目录:本地创建的工作目录路径。
  • ③ 检出深度和版本默认(最新版)即可,点击确定。
  • ④ 检出完成后,可以看到工作目录里多了一个.svn的隐藏目录。
5、TortoiseSVN客户端操作

(1)svn update操作:鼠标在工作副本空白处右击—>SVN 更新(U)

(2)svn add操作:鼠标在工作副本空白处右击—> TortoiseSVN—>增加(A)

(3)svn commit操作:鼠标在工作副本空白处右击—>SVN 提交(C)

(4)svn copy操作:鼠标在工作副本空白处右击—> TortoiseSVN—>分支/标签(T)

(5)svn merge操作:鼠标在工作副本空白处右击—> TortoiseSVN—>合并(M)

(6)svn import操作:鼠标在工作副本空白处右击—> TortoiseSVN—>导入(I)

(7)svn export操作:鼠标在工作副本空白处右击—> TortoiseSVN—>导出(X)

(8)svn lock操作:鼠标在工作副本空白处右击—> TortoiseSVN—>获取锁定(K)

(9)svn unlock操作:鼠标在工作副本空白处右击—> TortoiseSVN—>解除锁定(K)

(10)svn cleanup操作:鼠标在工作副本空白处右击—> TortoiseSVN—>清理(C)

免责声明:本文整理自《SVN中文手册》、《TortoiseSVN中文手册》、《菜鸟教程-SVN教程》和个人的学习总结,属于个人的学习笔记,仅用于学习和分享交流,不涉及商业用途。文中涉及的下载资源均来源于网络,版权归原作者所有,请在下载后24小时之内自觉删除,若作商业用途,请购买正版,由于未及时购买和付费发生的侵权行为,与本文无关。如果本文发布的内容侵犯到相关的权益,请及时联系本人进行删除!

posted @ 2020-04-23 09:47  山外Sundal  阅读(1860)  评论(0编辑  收藏  举报