软件配置管理和文档管理

软件配置管理的概念

　　软件配置管理（Software Configuration Management, SCM）是指通过执行版本控制、变更控制等规程，以及使用合适的配置管理软件，来保证所有配置项的完整性和可跟踪性。配置管理是对工作成果的一种有效保护。

　　软件开发和管理过程中会产生许许多多的工作成果，例如文档、程序和数据等，它们都应当被妥善地保管起来，以便查阅和修改。如果把所有文件一股脑地塞进计算机里，那么使用起来肯定很麻烦。毫无疑问，人们应当将文件分门别类、有条理地保存起来。

　　凡是纳入配置管理范畴的工作成果统称为配置项（Configuration Item），配置项主要有两大类：软件代码（包括源代码和二进制代码）和文档。

　　每个配置项的主要属性有：名称、标识符、文件状态、版本、作者、日期等。所有配置项都被保存在配置库里，确保不会混淆、丢失。配置项及其历史记录反映了软件的演化过程。

　　基线（Baseline）由一组配置项组成，这些配置项构成了一个相对稳定的逻辑实体。基线中的配置项被“冻结”了，不能再被任何人随意修改（即变更控制）。基线通常对应于开发过程中的里程碑（Milestone），一个产品可以有多个基线，也可以只有一个基线。基线的主要属性有：名称、标识符、版本、日期等。通常将交付给客户的基线称为一个“Release”，为内部开发用的基线则称为一个“Build”。

　　软件代码管理的一般规则

　　软件代码管理的特征：

　　开发人员可能在一天之内多次更新代码，可能对整个目录进行checkout/checkin操作，文件数量多，对实时性要求比较高。

　　软件代码的版本结构可能比较复杂（例如产生分支），对代码管理工具的功能要求比较高。

　　一般地只有开发人员可以checkout/checkin代码，非开发人员不必（也不该）访问代码库。

开发人员应当采用专业配置管理工具来管理所有的软件代码，常见配置管理工具有CVS、SourceSafe、ClearCase等。软件代码管理的一般规则如下：

　　·先请配置管理员在配置管理工具中创建对应的代码库，其目录结构与开发环境的目录结构保持一致。

　　·配置管理员为每个项目成员分配代码库的操作权限。一般地，项目成员拥有Add, Checkin/Checkout等权限，但是不能拥有“删除”权限。具体操作视所采用的配置管理工具而定。

　　·项目成员根据自己的权限操作代码，例如Add, Checkin/Checkout 等，项目组成员要保证代码及时Checkin（建议时间间隔不能超过1天，最好能够每日Build所有代码）。

　　·如果要修改已经发布了的代码，必须遵循 “申请－审批－执行”的变更管理流程。在开发进度压力比较大的情况下，为了提高工作效率，允许省略“变更控制报告”，但是至少要得到项目经理的口头批准，并告知受影响的相关人员。

　　·有关责任人定期备份代码库。

　　文档管理的一般规则

　　文档管理的特征：

　　·文档的主要用途是交流，交流越充分则文档的价值就越高。所以除了开发人员，不少相关人员（例如领导、市场人员等）都可能访问文档库。

　　·人们一般不会频繁地修改文档，文档的版本结构很简单（一般不会产生版本分支），对管理工具的功能要求不高。

　　·人们并不局限在办公室里使用文档，可能出差在外地、也可能在家里使用文档。

　　·一般地，企业领导和市场人员基本上不会使用CVS、SourceSafe、ClearCase查看文档（对他们而言这些工具都太复杂了），使用Web方式对他们而言最方便。

 

　尽管专业的配置管理工具既可以管理软件代码也可以管理文档，由于软件代码和文档有比较大的差异，业界倾向于将软件代码和文档分开管理：

　　·采用专业配置管理工具（如CVS、SourceSafe、ClearCase等）来管理软件代码。

　　·方式访问他需要的文档（前提条件是拥有访问权限），非常方便。

　　文档管理的一般规则如下：

　　·配置管理员创建文档库，至少确定文档库的第一级目录。

　　·配置管理员为每个项目成员分配文档库的操作权限。一般地，项目成员拥有Add, Checkin/Checkout等权限，但是不能拥有“删除”权限。具体操作视所采用的文档管理软件而定。

　　·项目成员根据自己的权限操作文档，例如Add, Checkin/Checkout 等，项目组成员要保证文档及时Checkin（建议时间间隔不能超过1周）。

　　·配置管理员用文件袋或文件柜妥善保管纸质文档（例如客户提供的纸质文件）。

　　·如果要修改已经发布了的重要文档（例如需求文档、设计文档、项目计划），必须遵循“申请－审批－执行”的变更管理流程。在开发进度压力比较大的情况下，为了提高工作效率，允许省略“变更控制报告”，但是至少要得到项目经理的口头批准，并告知受影响的相关人员。

　　·有关责任人定期备份文档库（见配置管理计划，一般由配置管理员备份）。

　　集成化研发管理平台RDMS提供了“基于Web的文档管理系统DocCenter”，是对软件配置管理工具的补充，满足上述文档管理的要求。