VSS配置管理流程.doc

VSS配置管理流程控制文档 凯尚网络科技有限公司VSS配置管理流程控制1. 文档介绍11.1 文档目的11.2 文档范围21.3 读者对象21.4 撰写人员22. VSS配置管理控制流程32.1 目录维护规范32.2 针对项目目录的权限控制42.3 配置项版本号命名规范52.4 VSS用户工作守则52.5 配置管理工作流程63. VSS客户端安装74. VSS客户端登录界面124.1开启VSS124.2配置正确的数据库地址124.3使用正确的账号登录165. 客户端基本操作175.1创建新的项目185.2添加文件195.3查看文件225.4创建工作文件夹245.5修改和编辑文件275.6移动文件/文件夹315.7共享文件/文件夹(share)355.8拆分文件（branch）375.9删除/恢复文件或文件夹415.10查看文件/文件夹的历史信息或早期版本425.11获取文件的最新版本455.12获取文件的早期版本475.13修改用户密码485.14打开/关闭数据库491. 文档介绍1.1 文档目的Visual SourceSafe（以下简称VSS）是一种版本控制管理工具。它通过将各种类型的文件存入其内部数据库的方式有效地管理工程。此文档为了使VSS在我们的项目管理、文档版本控制等方面得到有效合理地应用，就VSS的配置管理控制流程、VSS的安装流程、客户端基本操作等方面作相关介绍。1.2 文档范围适用于所有项目文档和日常工作中产生的文档的归档工作。1.3 读者对象公司内部所有开发人员和测试人员1.4 撰写人员2. VSS配置管理控制流程2.1 目录维护规范注意：1） 文档一般分为两类进行管理，一类是以项目为大类的进行管理，如软件开发过程的文档，其中包括需求文档、设计文档、源代码、测试计划、测试用例、测试报告、评审报告等；一类是公共资源类，如学习资料、部门工作计划、工作总结等。2） 其中每一个项目有四个固定文件夹：需求文档、设计文档、源代码、测试版本软件开发步骤VSS管理项目立项新建项目，增加项目用户。需求分析：系统需求说明书需求详细说明书项目需求分析写入“需求文档”设计阶段：数据库设计文档数据字典概要设计文档项目设计写入“设计文档”源代码编写源代码chick in“源代码”测试程序、数据库脚本提交测试程序“测试版本”2.2 角色和权限定义角色是配置管理流程的执行者和参与者，定义明确的角色有利于实现明确的授权和明晰的流程，虽然在实际中可能多个角色由一个人担任，但还是应该保留角色的定义。按以下四个用户角色（配置管理员、项目经理、开发人员、测试人员）来描述VSS中的权限控制：配置管理员项目经理开发人员测试人员需求文档R/CADR/CADR/CRC设计文档R/CADR/CADR /CARC源代码R/CADR/CAR/CARC测试版本R/CADR/CAR/CAR/C测试计划R/CADR/CADRCR/CA测试用例R/CADR/CADRCR/CA操作手册R/CADR/CADR/CAR/CA测试报告R/CADR/CADR/CR/CA注：权限描述Read (R)可用View和Get命令查看文件，但不能修改文件Check Out (C)可用Check Out，Check In和Undo Check Out命令修改文件。这些权限常被赋予QA工程师和技术作家。 Add (A)可用Add，Delete，Label和Rename 命令修改文件列表。大部分公司给予所有编程人员该项权限，也有公司将该权限保留给项目经理。Destroy (D)可用Destroy，Purge和Rollback命令对文件执行永久性删除操作。对于重视安全性的组织，该项权限只被给予项目经理或VSS管理员。您必须拥有本项权限才能执行部署Web站点的操作。2.3 配置项版本号命名规范配置项的状态一般分为三种：“草稿”、“正式发布”和“正在修改”。配置项的版本号与配置项的状态紧密相关，可通过配置项的版本号来区分其状态。为了更好的控制和管理文档版本，下面对配置项版本号的命名规则做如下定义：（1） 处于“草稿”状态的配置项的版本号格式为：0.YZ（2） 处于“正式发布”状态的配置项的版本号格式为：X.Y。一般只是Y值递增，当Y值到达一定的范围时X值才发生变化。（3） 处于“正在修改”状态的配置项的版本号格式为：X.YZ。一般只增大Z值，当配置项修改完毕，状态重新变成“正式发布”时，将Z值变为0，增加X.Y值。2.4 VSS用户工作守则1、各成员必须遵守的规范和规则: （1）工作开始初次打开VSS时必须向服务器请求最新版本.（2）当向VSS中添加新项或编辑任何程序代码后,应立即签入（check in）.以便其他成员可操作该文件.（3）不允许签出（check out）整个目录. 不允许长时间签出（check out）项目或文件夹.并且除非特别必要.不应同时签出（check out）过多的项. （4）某工作步骤完成后,应检查整个目录.防止签入错误的文件、不需要的文件或缺少文件.2、配置库的备份是有效降低配置风险的重要活动，要求配置管理员或项目经理必须对配置库做定期的异地备份。3、配置管理员或项目经理需对VSS文档做定期整理，检查、清除垃圾或临时文件。2.5 配置管理工作流程项目经理配置管理员开发人员测试人员计划阶段批准并发布配置管理计划制订项目计划制订配置管理计划制订访问控制和开发策略开发和维护阶段配置（维护）工作空间创建（维护）附加元素创建配置管理库Label版本修改文件提交工作成功建立软件原形建立发布版本测试工作3. VSS客户端安装1. 电脑上安装虚拟光驱，可使用daemon4304-lite.exe，并在虚拟光驱上载入Microsoft.Visual.SourceSafe.2005.iso文件 （图3-1使用虚拟光驱安装）2. 双击开始安装 （图3-2安装准备中）3. 选择同意，并点击“next” （图3-3同意协议并继续安装）4. 选择默认安装，并制定安装路径 （图3-4）5. 客户端安装中 （图3-5）6. 安装完成 （图3-6）7.有需要的用户可以使用汉化包（VSS.2005.LP.2052.exe）进行汉化，汉化步骤如下：7.1双击exe文件7.2选择文件安装目录，此目录要与VSS安装目录一致！ （图3-7选择正确的安装目录）7.3安装成功后进入VSS显示中文界面 （图3-8 VSS中文界面）4. VSS客户端登录界面4.1开启VSS 开始程序 Microsoft Visual SourceSafe- Microsoft Visual SourceSafe 4.2配置正确的数据库地址第一次启动，系统需要配置正确的数据库地址，配置方法：4.2.1在客户端登录界面，点击“浏览” （图4-1）4.2.2在“打开SourceSafe数据库”界面点击“添加”按钮 （图4-2）4.2.3在“添加SourceSafe数据库向导”中界面点击“下一步” （图4-3）4.2.4选择“链接一个现有的数据库”，并点击“下一步” （图4-4） 4.2.5输入正确的VSS数据库地址，并点击“下一步”。公司的VSS数据库地址为 192.168.1.2vss （图4-5） 4.2.6输入连接名称，直接点击“下一步” （图4-6） 4.2.7数据库添加完成 （图4-7） 4. 2.8此时在可用数据库界面就会显示刚才添加的数据库名称和路径 （图4-7）4.3使用正确的账号登录登录界面输入正确的用户名和密码登录（此账号由管理员分发） （图4-8）登录后显示界面 （图4-9）5. 客户端基本操作VSS是存储和管理文件的工具，但是编辑和编译文件必须在VSS指定文件夹中进行。这个文件夹叫工作文件夹，它可以是现存的文件夹，也可以是VSS新建的文件夹。VSS浏览器在文件列表上方显示了文件的工作文件夹的路径。在VSS系统中，工作文件夹才是你真正用于处理文档的地方。当你要编辑或修改某个文档时，必须对文档实施签出（check out） 操作，VSS将该文档从项目中拷贝出来，放入你的工作文件夹。当你修改完毕并签入（check in） 文件之后，VSS又将文件重新拷贝到数据库中以记录你的修改。一旦你将文件签出，VSS就开始在你的本地机上创建并管理你的工作文件夹。每一个用户、每一个项目或每一台微机都可以有自己的工作文件夹。如果Joe在项目$/SpreadSheet和$/WordProcessor上工作，他就有相应的2个不同的工作文件夹。如果Hanna在同样的项目上工作，对于每一个项目她又有自己的工作文件夹。当你为某个项目设置了工作文件夹，你可以用它来放置你该项目中包括子项目再内的所有文件。你还可以为每个子项目设置工作文件夹。你必须为从出自VSS中的文件副本指定一个工作文件夹,以完成签出、取出最新版本等操作。如果你在使用这些命令时，没有为文件设置工作文件夹，VSS会给出一个信息，提示你是否要为文件指定工作文件夹，如果你选NO，VSS就停止执行命令。 具体的操作步骤在下面一一讲解5.1创建新的项目5.1.1选中要创建新文件夹的项目（上级文件夹）；5.1.2在file菜单中选中“创建项目”；或者也可以右键点击选择“创建项目” （图5-1） （图5-2）5.1.3写入要添加的文件夹的名称，同时也可以在comment栏中为新建的文件夹添加备注； （图5-3）5.1.4点击OK。5.1.5用此方法，对一个项目可以创建多个子目录 （图5-4 一个项目下创建多个子目录）5.2添加文件方法1：使用添加按钮添加文件/文件夹5.2.1选中你要添加文件的文件夹；5.2.2在“文件”菜单中选中“添加文件”（图5-5）；或者也可用鼠标右键点击文件夹选择“添加文件”（图5-6） （图5-5） （图5-6）5.2.3在文件列表中选中要添加的文件；如果要添加多个文件，可以使用CTRL键或SHIFT键，同时选中多个文件； （图5-7）5.2.4点击“打开”，同时为你添加的文件夹做一个简单备注； （图5-8）5.2.5点击“确定”。 （图5-9 文件添加成功）方法2：用拖动的方法添加文件/文件夹5.2.6打开VSS浏览器，调整其大小，使得Windows资源管理器能够显示出来；5.2.7打开Windows资源管理器，调整大小，使得两个浏览器可以同时显示； （图5-10 分别打开Windows资源管理器和VSS浏览器，使用鼠标直接拖文件）5.2.8从Windows资源管理器中选择你要添加的文件或文件夹；5.2.9拖动你所选的文件或文件夹，放入VSS浏览器，加入备注后文件被添加进项目，而添加的文件夹将作为项目的子项目。 (图5-11 拖动文件后弹出确定框，选择”是”) （图5-12 Windows资源管理器中的文件被成功拖入VSS浏览器）PS：采用此方法只能拖文件夹下的文件，如果拖动的文件夹下含子文件夹，子文件夹不能被拖入5.3查看文件5.3.1在文件列表中选中要查看的文件；5.3.2在编辑菜单中选中“查看文件”（图5-13）；或者右键文件选择“查看“（图5-14） （图5-13） （图5-14）5.3.3选中“查看该文件在SourceSafe上的副本”； （图5-15）5.3.4点击OK。5.4创建工作文件夹在执行签入(check in)、签出(check out)、撤消签出(undo check out)、取出最新版本(get latest version)和文件合并(merge branches)等命令时都必须使用工作文件夹。工作文件夹可以随时设定或修改，VSS系统中可以通过两种方式设置工作文件夹。5.4.1专门创建工作文件夹5.4.1.1在VSS浏览器的文件或项目列表中选中要设置工作文件夹的文件/文件夹；5.4.1.2在文件菜单中选择“设置工作目录”（图5-16）；或者鼠标右键文件选择“设置工作目录”（图5-17） （图5-16） （图5-17）5.4.1.3在资源管理列表中选择或新建文件夹； （图5-18）5.4.1.4点击“确定”。5.4.2利用check out操作设置工作文件夹在对文件执行check out操作时，如果该文件还没有设置工作文件夹，系统会提示用户为文件创建或指定工作文件夹，如图5-19 （图5-19）用户可以根据系统的提示对文件进行工作文件夹的设置。5.5修改和编辑文件5.5.1在VSS浏览器的文件或项目列表中选中要修改或编辑的文件5.5.2在文件菜单中选中编辑文件（图5-20）；或者鼠标右键选择文件点编辑（图5-21） （图5-20） （图5-21）5.5.3选择“签出到工作目录并编辑这个文件” （图5-22）5.5.4点击“确定”。5.5.5被签出编辑的文件会显示签出状态，即在签出的文件上加了一个，如图5-23 （图5-23 demo1-测试-安全测试 这个文件显示已经被签出）5.5.6文件在本地编辑完签出的文件后需要把文件签入回去，方法为：在VSS浏览器中点击需要签入的文件，点击“版本”菜单中点击“签入”（图5-24）；或者鼠标右键点击文件选择“签入”（图5-25） （图5-24） （图5-25）PS：如果用户已经为文件设置了工作文件夹，VSS会将该文件的一个COPY放入你的工作文件夹并打开文件，让用户进行修改和编辑；如果用户还没有为文件设置工作文件夹，VSS系统会提醒用户设置工作文件夹，用户可根据系统提示，先设置工作文件夹，才可以对文件进行编辑。 VSS为了防止多人同时修改某个文件而导致出现意外，原则上不允许多人同时签出文件，所以已经签出的文件编辑完成后必须进行签入，不然别人将无法对此文件签出。5.6移动文件/文件夹5.6.1移动文件普通用户只有一种方法移动文件：即将文件共享(share)到项目中5.6.1.1首先选择需要移动的文件点击“版本”菜单中“共享至 */*”， （图5-26）5.6.1.2选择需要共享到的目录（即把此文件复制到哪个目录） （图5-27）5.6.1.3给文件加上备注，也可以修改此文件的名称 （图5-28）再将其从原来的项目中删除（delete）或是销毁（destroy）。移动文件后，历史信息仍然有效。但是你不能用move命令来移动单个的文件。5.6.2移动文件夹（project）注：要使用移动(move)命令，必须先请管理员为你设置对移动目的项目的添加(add)权限和对源项目中文件的破坏(destroy)权限。使用移动命令你可以重新定位子文件夹，将其从一个文件夹移动到另一个文件夹中。这个命令重新定义了被移动文件夹的路径。这个命令不可以重命名文件；你只能通过执行重命名命令来实现它。这个移动命令不会改变文件夹的内容或其中子文件夹的历史信息，它只会影响到新的和旧的上级文件夹的历史信息。警告：当你移动一个文件夹之后，就不能再如实地重建其上级文件夹的早期版本。移动文件夹的具体操作步骤如下：5.6.2.1选中要移动的文件夹；5.6.2.2在文件菜单中选中“移动”，打开对话框； （图5-29）5.6.2.3在列表中选择目标文件夹； （图5-30）5.6.2.4点击确定。5.7共享文件/文件夹(share)在VSS中可以实现一个文件被多个项目共享(share)。在一个项目中对文件的改动可以自动反映到其他共享的项目中去。这正提倡了代码重用。在file菜单中的properties中，点击link，可以查看某一文件的共享情况。5.7.1在VSS浏览器中选择你要共享的目标项目。5.7.2在版本菜单中选择“共享至*/*”，打开共享对话框。 （图5-31）5.7.3在文件共享列表中选择你要共享的文件，如果文件没有显示，可以旁边的项目列表中查找。 （图5-32）5.7.4点击“共享”。5.7.5点击“关闭”。共享成功： （图5-33 demo目录中的文件AAA被成功共享到测试目录中）5.7.6另外也可以选择文件/文件夹，直接鼠标拖动到需要放到的项目或文件中来实现共享 （图5-34 鼠标点中AAA文件夹，直接拖动到测试目录）5.8拆分文件（branch）拆分(branch)是将文件从原来共享的项目中分离出来的过程。它使得VSS可以实现从不同的路径追踪文件。拆分文件就断开了共享连接，使得本项目中的文件与其他原来共享的项目无关。对此文件的修改将不会再反映到其他项目上。拆分是这样被建立的：两个文件以前有着共同的历史记录，从实现拆分开始，他们的历史记录将被VSS分别追踪。拆分文件之后，link按纽将不再显示已断开的连接，但你可以用path（file菜单中的properties项）按纽浏览拆分的历史记录。共享（share）文件就是在多个项目间建立文件的连接。拆分(branch)文件就是在项目之间建立了不同的文件路径。5.8.1拆分被共享的文件5.8.1.1在浏览器中选中你想要拆分的文件；5.8.1.2在版本菜单中选择拆分，打开拆分对话框； （图5-35）5.8.1.3在对话框中填写备注； （图5-36）5.8.1.4点击确定。5.8.2用一步操作完成文件的拆分与共享5.8.2.1在VSS浏览器中选择你要共享和拆分（branch/share）的项目；5.8.2.2在版本菜单中打开“共享至*/*”对话框； （图5-37）5.8.2.3在文件共享列表中选择要共享的文件，如果你要的文件没有显示，在项目列表中选择其所在的项目；5.8.2.4选中“共享后分离”选项； （图5-38）5.8.2.5点击“共享”；5.8.2.6在对话框中填写备注； （图5-39）5.8.2.7点击确定；5.8.2.8点击关闭。5.9删除/恢复文件或文件夹如果想从VSS中移走某个文件，你必须首先确定是仅仅从项目中移走，还是从VSS数据库中移走。你还必须确定是要删除文件，但使其能够恢复，还是永久性地破坏它。VSS中有以下三种途径可以实现从数据库中移走文件。5.9.1删除（delete）将文件从项目中移走。该文件仍然存在于你的VSS数据库和其它共享该文件的项目中，你可以恢复它。此命令同样适用于项目。5.9.1.1选择文件或项目；5.9.1.2选择文件菜单中的删除（delete）命令（图5-40）；或者鼠标右键点击选择“删除”（图5-41） （图5-40） （图5-41）5.9.1.4点击确定。5.9.2破坏（destroy）删除(delete)对话框中有永久性破坏（the Destroy Permanently）选项，你一旦选中它，文件或项目将从VSS数据库中被移走，你不能再恢复它。此外，当Destroy 和Destroy Permanently命令用于共享文件时，它只作用于当前文件夹，其它共享的文件夹仍然保留该文件，该文件依然保存在VSS数据库中。5.9.2.1选择文件或项目；5.9.2.2选择文件菜单中的删除（delete）命令（图5-40）；或者鼠标右键点击选择“删除”（图5-41）5.9.2.3选中 永久销毁 选项； （图5-42）5.9.2.4点击确定。5.10查看文件/文件夹的历史信息或早期版本在历史信息中保存有每一个文件的详细信息。在历史对话框中，你不仅可以浏览到文件的版本信息、备注、以及文件的相关历史记录，也能够获取文件的某个旧版本。注：只有文件(file)可以从历史信息中check out，文件夹（project）不能从中check out。你还可以从历史信息对话框中执行get、check out、diff、pin、unpin、roll back和reprot等操作。要查看历史信息：5.10.1选择文件或项目5.10.2在工具菜单选中查看历史（图5-43）；或者鼠标右键点击选择“查看历史”（图5-44） （图5-43） （图5-44）5.10.3打开项目历史选项对话框； （图5-45）5.10.4点击确定，查看历史记录 （图5-46 该文件的所有历史版本）5.11获取文件的最新版本5.11.1选择你要操作的文件，也可以是多个文件或某个项目；5.11.2在版本菜单中选择“获取最新版本”； （图5-47）5.11.3如果你事先没有设定工作文件夹，VSS会提示你是否设定一个工作文件夹，点击OK，设定一个工作文件夹； （图5-48）5.11.4如果你已经确定了选项，VSS就会显示获取最新版本对话框，你