SVN配置管理系统的搭建、使用和维护

1、confidential2009.2.27svn配置管理系统搭建、使用和维护 tsdcopyright 2008 by neusoft group. all rights reserved.目目 录录第一部分：svn的基本概念配置管理环境搭建客户端tsvn基本功能的介绍及使用方法eclipse下svn的使用第二部分svn系统日常维护配置库规划分支策略目目 录录第一部分svn的基本概念配置管理环境搭建客户端tsvn基本功能的介绍及使用方法eclipse下svn的使用第二部分svn系统日常维护配置库规划分支策略confidential2009.2.27 版本库（ repository ） 工作拷贝

2、 版本模型 复制-修改-合并方案 锁定-修改-解锁方案 如何选择？ 修订版本svn的基本概念confidential2009.2.27svn的基本概念 版本库（ repository ） svn的核心是版本库，储存所有的数据，版本库按照文件树形式储存数据包括文件和目录，任意数量的客户端可以连接到配置库，读写这些文件。通过写数据，别人可以看到这些信息；通过读数据，可以看到别人的修改。版本库通常是配置管理中的配置库 最特别的是 subversion 会记录版本库中的每一次更改，不仅针对文件也包括目录本身，包括增加、删除和重新组织文件和目录。 confidential2009.2.27svn的基本概

3、念工作副本 与位于版本库相对应的是每个人的工作空间，它是每个程序员工作的地方，程序员从配置库拿到源代码，放在本地作为工作副本，在工作副本上进行查看、修改、编译、运行、测试等操作，并把新版本的代码从这里提交回配置库库中。 工作副本的结构 配置库配置库配置库配置库配置库配置库工作副本工作副本工作副本工作副本工作副本工作副本checkoutcommitconfidential2009.2.27 svn的基本概念版本模型版本模型 复制复制- -修改修改- -合并方案合并方案(subversion(subversion默认的模式默认的模式) ) 在这种模型里，每一个客户读取项目配置库建立一个私有工作副本

4、。用户并行工作，修改各自的工作副本，最终，各个私有的复制合并在一起，成为最终的版本，这种合并通常可以由系统辅助操作，但是最终要靠人工去确定正误。 锁定锁定- -修改修改- -解锁方案解锁方案 在这样的模型里，在一个时间段里配置库的一个文件只允许被一个人修改。如何选择？如何选择？ subversion 缺省使用复制-修改-合并方案，如果你有不可合并的文件，或者你只是想实行强制管理策略，可选择锁定-修改-解锁方案。confidential2009.2.27svn的基本概念修订版本 在版本库中，每一次提交被当作一次原子事务操作。每当版本库接受了一个提交，文件系统进入了一个新的状态，叫做一次修订（re

5、vision）,每一个修订版本被赋予一个独一无二的自然数，初始修订号是0。 全局修订号：不像其他版本控制系统，svn的修订号是针对整个目录树的，而不是单个文件。每一个修订号代表了一次提交后版本库整个目录树的特定状态。目 录svn的基本概念配置管理环境搭建客户端tsvn基本功能的介绍及使用方法eclipse下svn的使用svn系统日常维护配置库规划分支策略confidential2009.2.27配置管理环境搭建subversion相关软件配置管理环境搭建 服务器安装 客户端安装confidential2009.2.27subversion相关软件基于visualsvn server和torto

6、isesvn的版本控制系统visualsvnvisualsvn server server ：免费。包含了所有需要的安装和配置，用于windows平台：subversion, apache，管理端口。可以使用任何svn客户端与其连接，或者直接通过浏览器快速浏览配置库。tortoisesvntortoisesvn：免费。svn的客户端工具，和资源管理器完美集成。使用简单方便。confidential2009.2.27配置管理环境搭建：服务器配置服务器软件下载：http:/ 操作系统要求：windows xp windows 2003 server microsoft windows vista

7、windows 2008 server 硬件要求：pentium 500mhz or greater 128 mb ram or greater 30 mb hard drive space confidential2009.2.27配置管理环境搭建：服务器配置 1. 创建管理员帐户 2. 创建repository（版本库） 3. 测试confidential2009.2.27配置管理环境搭建：服务器配置repository版本库布局 推荐建立：trunk，tags，branches三个目录，他们不是必须的，但其设置贴合svn功能，在使用中你将会发现这样设置的好处。 trunk：最新的代码；

8、tags：subversion使用过程中创建的标签； branches：保存subversion的工作分支。导入数据到版本库 在你的硬盘上创建一个空的文件夹 在那个文件夹下创建你想要的顶级目录 通过在那个文件夹右键，选择tortoisesvn 导入. 将这个结构导入到版本库中。 注意导入路径的选择confidential2009.2.27配置管理环境搭建：客户端安装客户端软件下载tortoisesvn、中文语言包：http:/ 资源管理器完美集成目 录第一部分svn的基本概念配置管理环境搭建客户端tsvn基本功能介绍及使用方法在eclipse中使用svn第二部分svn系统日常维护配置库规划分支

9、策略基线策略confidential2009.2.27客户端tsvn基本功能介绍及使用方法tsvn的图标说明tsvn的使用基本流程tsvn基本操作 访问版本 checkout(检出) show log (显示日志) update(更新) commit(提交) revert(还原) add(添加) rename(改名) add to ignore list （忽略文件） 删除认证数据 得到历史版 处理冲突 创建分支与切换 svn的其他功能 创建分支与切换 svn的其他功能confidential2009.2.27tsvn图标说明confidential2009.2.271. 一个新检出的工作副本

10、使用绿色的对勾。表示subversion状态正常.2. 当我们开始编辑一个文件后，图标将变成红色感叹号。通过这种方式，可以很容易地看出我们对哪些文件进行了修改操作，但是还没有提交到版本库中；3. 如果在提交的过程中出现了冲突，图标将变成黄色感叹号。4. 如果我们拥有了一个文件的锁，并且subversion状态是正常，这个重载图标将提醒我们：如果不使用该文件的话，请进行释放锁操作，允许其他成员提交对该文件的修改tsvn图标说明confidential2009.2.27tsvn图标说明confidential2009.2.27tsvn的使用基本流程存在副本？checkout （ 检出 ）updat

11、e （ 更新 ）编辑工作副本保存 ？revert （还原 ）查看差异commit （提交）提交成功？否是否是是查看并解决其他问题否冲突引起？编辑/ 解决冲突是否继续工作?否是confidential2009.2.27tsvn基本操作：访问版本库方案 访问方法 file:/直接版本库访问(本地磁盘或者网络磁盘)。http:/通过 webdav 协议访问支持 subversion 的 apache 服务器。https:/与 http:/ 相似，但是用 ssl 加密。svn:/通过未认证的 tcp/ip 自定义协议访问 svnserve 服务器。svn+ssh:/通过认证并加密的 tcp/ip 自定

12、义协议访问 svnserve 服务器。visualsvn server使用https:/. 访问confidential2009.2.27tsvn基本操作：checkout(检出)作用：将版本库中的内容检出到本地工作副本步骤： 1.新建一个空文件夹； 比如：e:proj_trunk 2.在此目录中点击右键- svn checkout.confidential2009.2.27 checkout的注意项检出深度：检出深度： 1.全递归(默认选择) 检出完整的目录树，包含所有的文件或子目录。 2.直接节点，包含目录 检出目录，包含其中的文件或子目录，但是不递归展开子目录。 3.仅文件子节点 检出指

13、定目录，包含所有文件，但是不检出任何子目录。 4.仅此项。 只检出目录。不包含其中的文件或子目录。省略外部省略外部：如果项目含有外部项目的引用，而这些引用我们不希望同时检出，请选中忽略外部项目：如果项目含有外部项目的引用，而这些引用我们不希望同时检出，请选中忽略外部项目复选框。如果选中了这个复选框，更新的时候要使用命令复选框。如果选中了这个复选框，更新的时候要使用命令”更新至版本更新至版本update to revision.” confidential2009.2.27tsvn基本操作：showlog(显示日志)confidential2009.2.27tsvn基本操作：update(更新)

14、作用：获取其他用户对文件进行的修改，与自己对文件进行的修改进行合并，保证本地的文件总是最新的。svn将显示出更新的文件和更新的次数注意：经常更新工作副本，确保得到最新的修改。confidential2009.2.27tsvn基本操作：commit(提交)对工作副本进行编辑后提交到svn在右键菜单中点击svn 提交（c）提交前写好信息，点击确定confidential2009.2.27commit(提交)的注意项提交之前要确保你的工作副本是最新的，避免冲突使用tortoisesvn 更新使用tortoisesvn 检查更新，看看哪些文件在本地或是服务器上已经有了改动提交文件与提交文件夹的区别当你

15、提交文件时，提交对话框只显示你选择提交的文件。当你提交文件夹，提交对话框将自动选择该文件夹中有改动的所有文件。如果你忘记你建立了一个新文件，提交文件夹将使你可以找到它。填写好的日志信息日志信息主要记录的是每次的修改内容。建议把一些重要数据、关键操作写到日志信息中。（修改人和提交时间由软件自动记录，无需人工写入日志信息）不规范的不规范的日志日志规范的日志规范的日志去除无用去除无用文件文件删除分支中的无用删除分支中的无用文件文件attachment.js_baattachment.js_bak_k_和和moderation.js”moderation.js”线索报警线索报警修改线索的样式修改线索的

16、样式更新配置更新配置文件文件更新公司主题包和更新公司主题包和栏目配置文件栏目配置文件confidential2009.2.27tsvn基本操作： add(添加)选中文件/文件夹（在新文件/文件夹所在父文件夹点击右键），在菜单中选择“添加add”命令。不需要受svn控制的文件请取消打钩。确认添加执行提交操作confidential2009.2.27tsvn基本操作： delete(删除)选中文件/文件夹，在菜单中选择“删除（d）”命令。确认删除执行提交操作。如何找回已删除的文件或目录？在删除的文件或目录所在 的目录中打开日志， 找出删除的版本和文件右键浏览版本库， 选择删除的文件或目录， 右键并

17、选择“复制到工作副本”confidential2009.2.27tsvn基本操作： revert(还原)作用：撤销本地所有未提交的修改注意：还没有执行commit操作之前执行此命令才可以，否则无效confidential2009.2.27tsvn基本操作： rname(改名)对文件/目录进行subversion控制下的改名操作，用此功能对文件/目录进行改名后文件仍处于svn的控制下并保持连续的变更信息。注意：必须使用tortoisesvn的重命名功能，直接在资源管理器中进行重命名svn无法监控。confidential2009.2.27tsvn基本操作：删除认证数据步骤：点击右键 选择设置 以

18、保存数据 清除认证数据confidential2009.2.27tsvn基本操作：得到历史版本工作副本右键显示日志选择所需的版本号保存存版本至confidential2009.2.27tsvn基本操作：addtoignorelist（忽略文件）添加忽略文件 右键一个单独的未进入版本控制文件tortoisesvn (加入忽略列表)add to ignore list，会出现一个子菜单允许你仅选择该文件，或者所有具有相同后缀的文件。 删除忽略文件： 如果你想从忽略列表中移除一个或多个条目，右击这些条目，选择tortoisesvn 从忽略列表删除。已进入版本控制的文件或目录不能够忽略 confide

19、ntial2009.2.27tsvn基本操作：处理冲突冲突的产生产生原因产生原因：两个开发人员修改了文件中相同的几行产生步骤产生步骤： commit时出现错误提示：“文件或目录 “readme.txt” 已经过时；请先更新” 更新后出现“至少还有一个的文件处于冲突状态” 红色警告。svn自动在当前目录产生几个文件记录冲突文件解释文件解释： filename.mine：你更新前的文件，没有冲突标志，只包含你最新更改的内容。 filename.roldrev：这个是你做更新操作以前的base版本，就是你在上次更新之后未作更改的版本。 filename.rnewrev：这是subversion从服务

20、器刚刚收到的版本。这个版本就是版本库的head版本filename.minefilename.rnewrevfilename.roldrev1213confidential2009.2.27tsvn基本操作：处理冲突面对文件冲突，我们可以选择以下两种方式解决冲突使用工具解决冲突用revert放弃所做的修改confidential2009.2.27使用工具解决冲突 选择冲突文件-”编辑冲突” 出现merge界面，分为”远程文件”、”本地文件”和”已合并”3部分，表示”别人修改的内容”、 ”我修改的内容”和”合并后的结果”3部分。tsvn基本操作：处理冲突confidential2009.2.27

21、tsvn基本操作：处理冲突 合并目标是将”别人修改的内容”和”我修改的内容”有取舍地合并起来，形成”合并后的结果”。一般分为4种情况： 保留”我的修改”,舍弃”别人的修改”。鼠标右键点击mine框的相应行，点击”使用此文件块”。 舍弃”我的修改”,保留”别人的修改”。鼠标右键点击theirs框的相应行，点击”使用此文件块”。 同时保留”我的修改”和”别人的修改”，并将”我的修改” 放在前面。鼠标右键点击mine框的相应行，点击”优先使用本地而非远程文件块”。 同时保留”我的修改”和”别人的修改”，并将”别人的修改”放在前面。鼠标右键点击mine框的相应行，点击”优先使用远程而非本地文件块”。

22、合并完成，ctrl+s存盘，退出。confidential2009.2.27tsvn基本操作：处理冲突选择svn还原（revert） 放弃自己所做的修改confidential2009.2.27tsvn基本操作：处理冲突通过上面所说的方法，解决冲突后要选择已解决的（resolved）解决后，带问号的三个文件将自动删除最后选择commit提交到svnconfidential2009.2.27tsvn基本操作：处理冲突关于冲突的建议 修改文件之前，先进行一次update操作 修改完成后，及时commit，不要在本地停留过长时间 在多位团队成员协作时，尽量修改自己撰写的部分，尽量不要修改不属于自己撰

23、写的部分 出现冲突很正常，可以通过前面的方法解决，不要相互覆盖confidential2009.2.27tsvn基本操作：获取标签和分支中的文件什么是分支？什么是标签？ 分支分支 版本控制系统的一个特性是能够把各种修改分离出来放在开发品的一个分割线上。这条线被称为分支。 标签标签 版本控制系统的另一个特性是能够标记特殊的版本(例如某个发布版本)，所以你可以在任何时候重新建立一个特定的构件和环境。这个过程被称作标记。confidential2009.2.27tsvn基本操作：获取标签和分支中的文件切换到分支工作 第一个方法：第一个方法：checkout checkout，在本地任意位置创建新的工

24、作副本。对于已经创建了工作副本的版本库，不建议采用此操作。造成多个本地工作副本，不便管理。 第二个方法：第二个方法：switch 对于已经checkout的版本库，可以在本地工作副本中使用switch方便的切换到该目录的任意历史版本。 注意：在工作副本里当进行本操作时，任何没有提交过的修改都会被混合。如果你不想看到这样的结果，那么你可以有两种选择，要么在切换前提交修改，要么把工作副本恢复到一个已经提交过的版本(比如最新版本)。confidential2009.2.27tsvn基本操作：获取标签和分支中的文件tortoisesvn -切换切换. 仅仅传输已经被修改的数据到你的工作副仅仅传输已经被

25、修改的数据到你的工作副本中本中confidential2009.2.27tsvn的其他功能export（导出） 导出你需要的文件，导出后不在受svn控制；而checkout检出的文件仍受svn控制；import（导入） 将需要的文件导入到版本库中；relocatedrelocated（重新定位）（重新定位） 当服务器上的版本库目录已经改变，我们可以把工作复本重新定位；cleanup（清理） 递归的清理工作副本，删除锁定和保留的未完成操作，如果你得到工作副本已经锁定的错误，运行这个命令删除无用的锁定，并将工作副本恢复到可用的状态；目 录第一部分svn的基本概念配置管理环境搭建客户端tsvn基本功

26、能的介绍及使用方法在eclipse中使用svn第二部分svn系统日常维护配置库规划分支策略confidential2009.2.27在eclipse中使用svn将版本库导入到svn资源库将项目文件导入到版本库在eclipse下使用的图标eclipse下使用svn的主要功能 菜单介绍： team：最常用，与svn版本库互动操作的大部分命令菜单 compare with：比较版本差异 replace with： 常规操作 更新项目 添加文件或目录 删除文件或目录 重命名文件或目录 忽略文件 提交更改confidential2009.2.27在eclipse中使用svn：下载安装下载插件 subcl

27、ipse 需要根据 eclipse 的版本下载相应版本的 subclipse插件 下载地址： 安装subclipse插件confidential2009.2.27在eclipse中使用svn：将版本库导入到svn资源库confidential2009.2.27在eclipse中使用svn：将项目文件导入到版本库confidential2009.2.27在eclipse下使用的图标受svn控制的文件被标记为小黄桶；修改过的文件都被标记上一个黑色星号；未受版本控制的文件被标记为问号；confidential2009.2.27菜单介绍：小组 tea

28、mconfidential2009.2.27菜单介绍：比较对象 compare with例如：confidential2009.2.27菜单介绍：比较对象 compare with1）基本修订版:在eclipse中的基本版confidential2009.2.27菜单介绍：比较对象 compare with2） 资源库中的最新内容 confidential2009.2.27菜单介绍：比较对象 compare with3）分支/标记confidential2009.2.27菜单介绍：比较对象 compare with4）修订版 比较的对象是你选择的版本号对应的项目confidential2009

29、.2.27菜单介绍：比较对象 compare with5） 本地历史纪录 现修改的版本与本地修改的其他版本进行比较confidential2009.2.27菜单介绍：比较对象 compare with注:与比较对象的应用一样,只是这是替换.confidential2009.2.27常规操作更新项目更新项目 右击您要更新的项目，然后从菜单中选择 team update。eclipse 将从存储库中检索任何变更，并尝试将它们与本地副本合并。 添加文件或目录添加文件或目录 右击新文件，然后选择 team add to version control。下一次将此项目中的变更提交给存储库时，新文件也会检

30、入。删除文件或目录删除文件或目录 右击文件，然后选择 delete。不需要使用 team 菜单，subclipse 自动将标记要删除的文件，并将它从项目中移除。下一次将变更提交给存储库时，该文件被删除了。 重命名文件或目录重命名文件或目录 要重命名 subclipse 控制的文件或目录，请右击它，然后选择 rename。在输入字段中键入项的新名称，按 enter 键。文件是在项目中重命名的，重命名操作（通过 add 操作添加新名称、通过 delete 操作删除旧名称）排队等待您下一次提交。 忽略文件忽略文件 如果项目生成文件，或者包括您不想检入的 subversion 存储库文件，则可以通知

31、subclipse 忽略它们。右击您要在版本控制中排除的文件或目录，然后选择 team add to svn:ignore 即可显示add to svn:ignore 对话框 提交更改提交更改 在尝试提交变更之前，请确保更新您的项目（参阅 “更新项目”）。右击项目，并从菜单中选择 team commit。eclipse 会显示一个 commit 对话框（参见图 18），其中汇总了您作出的变更。目 录第一部分svn的基本概念配置管理环境搭建客户端tsvn基本功能的介绍及使用方法在eclipse中使用svn第二部分svn系统日常维护配置库规划分支策略confidential2009.2.27svn

32、系统日常维护subversion属性tsvn专用属性钩子脚本管理磁盘空间与数据库恢复备份与恢复confidential2009.2.27svn系统日常维护：subversion属性subversion属性用于存放文件的特殊信息，作为支持某些特殊操作的一种方法。属性也是版本化的 。subversion保留了一组名称以svn:开头的属性，来预定义一些有用的功能。 svn:keywords :关键字替换，告诉客户端如何扩展文件的特定关键字 值：见后页 svn:externals:外部定义，如果出现在一个目录上，则这个之就是客户端必须要检出的路径和url列表 值：可选的修订版本标记和完全有效的版本库u

33、rl列表 svn:needs-lock:锁定交流，提醒用户在开始编辑以前必须锁定这个文件：除非用户锁定这个文件，否则文件一直是只读的。 值：任意confidential2009.2.27subversion属性：svn:keywords右键-tortoisesvn-属性-新建 设置后提交id这是一种综合的格式，例如“$id: v2excore.php 4 2005-10-29 23:08:09z livid $”。 lastchangeddate最后被修改的时间，这个属性也可以缩写为 date。 lastchangedby最后修改该源代码文件的用户名，这个属性也可以被缩写为 author。 l

34、astchangedrevision最后修订的版本号，这个属性也可以被缩写为 revision 或者 rev。 headurl该源代码文件所位于的 repository 上的绝对 url 地址，这个属性也可以被缩写为 url。在源代码文件中需要 subversion 进行自动更新的地方插入 $id$ 这样的 keyword下次进行 svn commit 之后，$id$ 就会被 subversion 自动替换为 $id: perties 12 2009-02-19 12:54:51z zhaoxin $这样的格式。confidential2009.2.27svn系统日常维护：

35、tsvn专用属性tortoisesvn 有自己专用的几个属性，它们都有tsvn:前缀。 tsvn:logminsize设置提交日志的最小长度。如果你输入的日志短于预设值，提交会被禁止。 tsvn:logtemplate在需要定义日志消息格式化规则的工程中使用。在你开始提交时，这个属性的多行消息会被插入日志消息编辑框。你可以编辑它以便包含需要的信息。confidential2009.2.27svn系统日常维护：版本库钩子钩子脚本是被版本库事件触发的程序，例如新修订版本的创建或未版本控制属性的修改。每一种钩子都会被告知事件的足够信息，操作的目标，触发事件的用户名。依赖于钩子的输出或返回状态，钩子程

36、序可以继续执行，停止或以某种方式挂起。svn版本库钩子模板的位置：hooks文件夹每种subversion版本库支持的钩子都有一个模板，需要在repos/hooks目录下安装一些与钩子同名的可执行程序或脚本。注意：钩子脚本的默认执行者是访问svn的用户，必须确保该用户有执行局程序的权限。confidential2009.2.27svn系统日常维护：版本库钩子svn的9种钩子 start-commit：开始提交的通知，通常用来确定用户是否有提交权限 pre-commit：在提交结束之前提醒，用来保护因为内容或位置而不允许的提交 post-commit：成功提交的通知。多用于发送关于提交的描述性电

37、子邮件 pre-revprop-change：修订版本属性修改的通知。如脚本没有返回一个非零值，属性修改不成功 post-revprop-change：修订版本属性修改成功的通知，用于修改后发送邮件通知 pre-lok：路径尝试锁定的通知，用来控制哪些用户可以锁定特定路径 post-lock：成功锁定路径的通知。用来发送锁定事件的邮件通知 pre-unlok：路径尝试解锁的通知。限制哪些用户可以解除文件锁定。 post-unlok：路径成功解锁的通知。发送解锁事件通知邮件confidential2009.2.27svn系统日常维护：管理磁盘空间与数据库恢复删除终止的事务删除终止的事务原因：客户

38、端粗暴的结束提交进程，或操作过程出现网络故障，导致出现死亡事务。仅消耗磁盘空间，没有负面影响清除方法：1、暂时关闭版本库和客户端的连接，保证不会有正常事务进入版本库2、在服务器端执行如下命令：svnadmin rmtxns myrepos svnadmin lstxns myrepos删除不使用的删除不使用的berkeley db日志文件日志文件耗费磁盘空间最大的凶手，预写入使日志文件快速增长删除命令：rm svnadmin list-unused-dblogs /path/to/reposberkeley db数据库恢复数据库恢复致命错误或异常中断导致某个进程没有及时将锁删除，结果任何访问数

39、据库的操作都会被挂起恢复方法：关闭版本库和客户端的连接运行命令：svnadmin recover /path/to/repos重新启动服务进程confidential2009.2.27svn系统日常维护：备份与恢复最简单(但不推荐)的方法： 直接备份仓库整个文件夹（全部版本），重装svn程序后直接还原过去。绝对确定没有访问数据的进程，即不能有任何访问。推荐的方法： 通过svn命令行备份和还原指定版本号的数据 全备份：使用svnadmin hotcopy 或svnsync 例：svnadmin hotcopy path/to/repository path/to/backup clean-logs 增量备份：使用svnadmin dump的incremental选项来实现命令格式：svnadmin dump 版本库路径及名称 revision 上次导出的版本号:到本次要导出到的版本号 incremental 导出的命名 还原版本：svnadmin load 要恢复的版本库路径及名称confidential2009.2.27svn系统日常维护：备份与恢复svnadmin dump优点：比较灵活，可以全量备份也可以增量备份，并提供了版本恢复机