美文网首页
【山外笔记-工具框架】SVN版本控制系统

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

作者: 山外Sundal | 来源:发表于2020-04-23 09:44 被阅读0次

    【山外笔记-框架工具】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小时之内自觉删除,若作商业用途,请购买正版,由于未及时购买和付费发生的侵权行为,与本文无关。如果本文发布的内容侵犯到相关的权益,请及时联系本人进行删除!

    相关文章

      网友评论

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

          本文链接:https://www.haomeiwen.com/subject/geqoihtx.html