配置管理规范.doc

版 本4 2页 码1 19 1 简介简介 3 1 1 目的 3 1 2 适用范围 3 1 3 词汇表 3 1 4 文档结构 4 1 5 参考资料 4 2 角色角色与与职责职责 4 3 配置管理流程配置管理流程 5 3 1 配置管理流程图 5 3 2 配置管理工作流程 5 3 2 1 计划和建立配置管理 6 3 2 1 1 配置管理计划的编制和审批 6 3 2 1 2 配置管理计划的变更 6 3 2 1 3 建立配置管理 6 3 2 2 配置项的管理 6 3 2 2 1 配置项的标识 6 3 2 2 2 基线 6 3 2 2 3 版本控制 7 3 2 3 执行配置控制 7 3 2 3 1 配置项状态演变管理 7 3 2 3 2 需求变更跟踪管理 7 3 2 3 3 程序缺陷变更跟踪管理 8 3 2 4 配置管理检查和审计 8 3 2 4 1 业务部门 项目组检查 8 3 2 4 2 项目监理审计 8 4 配置管理活动描述配置管理活动描述 8 4 1 进入准则 8 版 本4 2页 码2 19 4 2 活动输入 9 4 3 活动内容 9 4 4 活动输出 10 4 5 退出准则 10 5 记录记录 10 6 案例 参考 案例 参考 10 附录一附录一 备份服务器的管理备份服务器的管理 10 1 人员及职责 10 2 备份范围及备份途径 11 3 备份时间及频率 11 4 备份方式 11 5 备份资料的管理 11 6 备份服务器的安全管理 11 7 检查措施 11 附录二 配置库 附录二 配置库 VISUAL SOURCESAFE 的管理 的管理 14 1 建库类型 14 2 库结构 15 3 库操作流程 19 1简介简介 为了统一公司各部门的配置管理活动 保证项目资料的安全性和完整性 特制订本规范 本规范旨在对配置管理工作的具体内容 人员职责以及操作流程做出规定 并规定了配置管 理工作的内容和具体方法 版 本4 2页 码3 19 1 11 1 目的目的 规范配置管理活动 确保配置项正确地唯一标识并易于存取 保证基准配置项的更改受 控并可追溯 明确基准配置项的状态 指导配置管理人员建立配置库 并利用配置库管理所 有配置项 从而提供配置项的存取和检索功能 有利于配置项的更改控制 保证配置项的完 整性和可跟踪性 1 21 2 适用范围适用范围 适用于所有软件项目和 或软件产品的配置项 开发库配置管理工具可采用 VSS 或 CVS 受控库配置管理工具只能统一使用 VSS 本文件以 VSS 配置管理工具为例 规定公 司的配置管理办法 使用其他工具时必须对应本文件的要求参照执行 1 31 3 词汇表词汇表 配置管理 Configuration Management 主要是针对软件开发过程中产生的变更 而提 出的管理方法 通过标识配置项 管理存储空间 进行版本控制 管理变更请求 建立 程序更改日志和调解程序等配置管理活动的执行 最大幅度地降低开发过程中产生的错 误 并最有效地提高软件生产效率 基线 Baseline 已通过审核和批准的工件 可用作下一步开发的基础 并且只能通过 正式程序 例如变更管理和配置控制才能进行更改 配置管理库 Configuration Management Library 存储项目工件的所有版本 即存储项 目的定义的配置项 版本 Version 某个工件的变体 工件的后期版本一般是在初期版本的基础上进行的 扩展 配置项 Configuration Item 项目实施过程所需要的或产生的软件 硬件 工具 释放 产品 文档 变更请求 Change Request 是指在某一软件产品的生命周期中 包括开发过程 针 对硬件项 软件项和用户需求的变化 提出的要变更工件或流程的任何请求的统称 在 变更请求中记录的信息是有关当前问题 提议解决方案及其成本的起源和影响的信息 变更控制委员会 Change Control Board 对变更进行评估 审批的组织 可由项目相 关人员包括开发人员 公司代表 客户代表组成 在小项目中 项目经理一人即可担当 此角色 BUILD 指软件产品的一个工作版本 由若干配置项的不同版本构成 每一次送测的可 版 本4 2页 码4 19 执行系统都是一个 BUILD 1 41 4 文档结构文档结构 第一部分 简介 包括本规范的目的 范围 词汇以及所涉及到的参考信息 第二部分 配置管理角色与职责的定义 第三部分 配置管理工作流程 第四部分 配置管理活动描述 第五部分 配置管理的工作记录 第六部分 案例参考 第七部分 备份服务器的管理 配置库的管理 1 51 5 参考资料参考资料 无 2 角色与职责角色与职责 角色角色职责定义职责定义 项目监理负责配置管理的日常指导 检查 公司级配置备份工作 并协调解 决项目实施过程中出现的与配置管理有关的问题 对于涉及到多个 部门的项目 综合管理部及项目经理就每一项目指定一名主要责任 配置管理员 项目经理是所在项目配置管理的责任人 负责 配置管理计划 的审批 控 制 检查 负责或委托他人负责变更任务的下达 负责一般技术 质量问题的裁定 配置管理员在各项目中负责实现配置管理活动 负责编制 配置管理计划 建立配置管理数据库 执行变更跟踪 版本控制 配置项标识 向 项目经理报告配置管理活动的执行情况和其他活动等 负责组织相 关人员填写 月状态报告 及编制 月状态报告 相应配置部分 配合项目经理组织相关评审 向公司备份服务器中进行数据备份 项目组成员负责提交配置项 变更控制委员会对基线进行审批 对变更进行评估 审批 2 2配置管理流程配置管理流程 3 13 1 配置管理流程图配置管理流程图 版 本4 2页 码5 19 3 23 2 配置管理工作流程配置管理工作流程 配置管理工作可分为计划和建立配置管理 执行配置控制和监控配置项状态 执行配置 管理审计三个阶段 3 2 13 2 1 计划和建立配置管理计划和建立配置管理 3 2 1 1 配置管理计划的编制和审批 在需求调研之前 配置管理员根据项目状况应该编制 配置管理计划 并报项目经理审 批 配置管理计划 的要求格式参见附件 3 2 1 2 配置管理计划的变更 项目组成员若需调整批准后的 配置管理计划 首先要向配置管理员提出变更申请 经项目 经理批准后方可由配置管理员进行调整 3 2 1 3建立配置管理 配置管理员及项目组相关开发人员按批准后的配置管理计划 安装系统软件和配置管理软件 项目立项 项目所在部部门经理 计划配置管理 项目经理和配置管理员 配置项标识 配置管理员 建立基线 配置管理员 执行配置审计 项目监理 变更控制管理 变更控制委员会 编写项目状态报告 项目监理 项目结项 项目所在部部门经理 月状态报告配置部分 配置管理员 版 本4 2页 码6 19 建立有关目录并设置权限 3 2 23 2 2 配置项的管理配置项的管理 3 2 2 1 配置项的标识 标识的配置项主要包括以下几部分 1 开发环境 软件工具 硬件设备等 2 工具 设计工具 开发工具 测试工具 维护工具等 3 技术文档 项目规格说明书 项目总体计划 及子计划 需求分析说明书 质量保证计 划 设计说明书 测试文档 阶段报告 用户手册 项目总结等 4 提交产品 阶段检查点产品 计算机程序 释放产品等 3 2 2 2 基线 项目组在开发过程中产生的基线 可用作下一步开发的基础 并且只能通过变更控制管理 才能进行更改 若基线需要更改 需经过原审批人的再次批准认可 方可进行更改 更改被批准后 项 目总体计划 配置管理计划 等文档也要进行相应的更改 项目组人员要按照更改过的配 置管理计划提交配置项 配置管理员负责管理这些配置项 重新标识所有被影响的配置项及 版本 并对这些配置项进行跟踪 并反映在 月状态报告 中的配置部分 3 2 2 3 版本控制 项目文档版本 项目文档版本编号以 1 0 为起始版本 文档初次通过审批后形成 1 0 版 以后每经过一次 受控更改 在末位加 1 依次为 1 1 1 2 1 3 1 4 1 5 1 6 如果遇到较大变动 可直接升级为 2 0 版 下次变更依次在末位加 1 并由变更人附加上本次变更内容详细说明 依次类推 软件版本 软件出库版本和测试版本 版本号按 项目名称 简称 日期 序号 规则依 次递增 例如 克拉玛依钻井项目在 2004 4 22 出库版本号应为 克拉玛依钻井 20040422 1001 下次出库时必须附上与本次出库内容相区别的说明文档 由测试负责人编写 版 本4 2页 码7 19 3 2 3 执行配置控制执行配置控制 3 2 3 1 配置项状态演变管理 当配置项状态改变时 配置管理员应将配置项从开发库移到受控库相应目录下 当更改 发生后 配置管理员应建立新版本 配置管理员要进行常规的配置项状态检查 若发现实际 与计划有差异 应与相关开发人员一起查找原因并解决出现的差异问题 并反映在 月状态 报告 中的配置部分 3 2 3 2 需求变更跟踪管理 当发生需求变更请求时 CCB 变更控制委员会 应进行需求变更影响分析 经变更影响 分析后确定变更配置项 再由项目经理根据 更改申请确认单 及其 需求管理工作套表 下达变更任务 开发人员执行变更任务时 要对整个变更的执行过程进行记录 更改过的程 序 或文档 都必须经历配置项的全部演变过程 变更完成之后要通知配置管理员 配置管 理员应对变更申请和变更执行情况进行记录和存档 对每个需求变更都要将变更要求记录中 提及的配置项的状态与实际状态比较 若发现有差异 应与相关开发人员一起查找原因并解 决出现的差异问题 另外 配置管理员要将各个需求变更进行汇总 跟踪记录是否完整 并 反映在 月状态报告 中的配置部分 3 2 3 3 程序缺陷变更跟踪管理 对于在测试中发现的问题 首先由分析设计人员进行缺陷分析 然后由项目经理根据缺 陷的严重程度确定是否必须修改 按 更改申请确认单 及附表 下达变更任务 更改过的 程序 或文档 都必须经历配置项的全部演变过程 变更完成之后要通知配置管理员 配置 管理员应对变更申请和变更执行情况进行存档记录和汇总 对每个变更都要将变更要求记录 中提及的配置项的状态与实际状态比较 若发现有差异 应与相关开发人员一起查找原因并 解决出现的差异问题 并反映在 月状态报告 中的配置部分 3 2 4 配置管理检查和审计配置管理检查和审计 3 2 4 1 业务部门 项目组检查 配置管理员必须定期对每个项目配置管理各项控制活动和配置管理计划是否一致的状态 进行报告 对不一致部分必须尽快纠正 反映在 月状态报告 中的配置部分 3 2 4 2 项目监理审计 项目监理必须按照 ISO9001 标准的要求 定期对项目实施情况进行指导 控制和检查 版 本4 2页 码8 19 每周至少一次公司级配置库备份检查 对检查中发现的不合格项 应要求项目组限期整改 并对整改进行跟踪 反映在 项目状态报告 中 4 配置管理活动描述配置管理活动描述 4 14 1 进入准则进入准则 项目正式立项 项目策划结束 需求调研前 4 24 2 活动输入活动输入 输入名称输入名称输入描述输入描述参考指南 模板参考指南 模板 项目开发计划 专题计划 项目总体计划 项目风险管理计划 项目组织结构 人力资源使用计划 项目计划与控制规范 4 34 3 活动活动内容内容 序号序号活动名称活动名称角色角色活动描述活动描述参考参考 1 计划配置管 理 项目经理 配置管理 员 制定配置管理策略 制定变更控制策略 编写配置管理计划 审批配置管理计划 配置管理计 划 模板 2 创建配置管 理环境 配置管理 员 设置硬件环境 设置网络环境 设置软件环境 建立配置数据库 设置权限 3 配置项的标 识 配置管理 员 对文档类的配置项进行的 标识 对程序 coding 模型 的 配置项进行标识 4 建立基线配置管理 员 配置管理计划 中明确 5 报告配置状 态 配置管理 员 根据配置管理计划 收集 配置活动数据 编写 月状态报告 中配 置部分 月状态报告 模板 6 配置审计项目监理 不定期检查配置规范执行 情况 版 本4 2页 码9 19 序号序号活动名称活动名称角色角色活动描述活动描述参考参考 7 变更控制管 理 变更控制 委员会 参见 软件设计开发过程 更改控制程序 更改申请确 认单 4 44 4 活动输出活动输出 输出名称输出名称输出描述输出描述参考参考 配置管理计 划 配置管理计划说明要在项目生命周期过程 中执行的所有配置和变更控制管理活动 说明了活动时间表 指定的职责和需要的 资源 包括人员 工具和计算机设备 配置管理计划 模板 变更请求 对项目当前问题说明 提出的变更请求内容 变更控制委员会的评审结果 确认变更的结果 更改申请确认 单 月状态报告 中配置部分 主要报告各配置项的标识和变更请求情况 当前基于工作的工件版本以及版本说明基 线的状态 配置计划的执行情况 月状态报告 模板 4 54 5 退出准则退出准则 项目结项 终止或暂停 5 5 记录记录 配置管理计划 模板 月状态报告 模板 更改申请确认单 6 6 案例 参考 案例 参考 配置管理计划 案例 附录一附录一 备份服务器的管理备份服务器的管理 1 备份服务器管理备份服务器管理 售中售中 1 1 人员及职责人员及职责 综合管理部项目监理 负责公司备份服务器的权限设置 网络安全 日常维护 并检查 核实备份服务器上公司所有部门项目备份数据的安全可靠性 各部门配置管理员 负责检查备份服务器上本部门项目备份数据的安全可靠性 版 本4 2页 码10 19 1 2 备份范围及备份途径备份范围及备份途径 备份范围包括各业务部门的开发库和受控库中各种项目资料 备份工作由配置管理员 项目监理在备份服务器上为每个项目设置共享目录 通过网络 直接进行备份 1 3 备份时间及频率备份时间及频率 开发库每天至少备份一次 时间下午 17 点到 24 点之间 受控库每周五备份一次 时间 下午 17 点到 24 点之间 公司级备份每周所有开发库及受控库至少备份一次 时间每周三 四 五下午 17 点到 24 点之间 1 4 备份方式备份方式 对于以 VSS 库结构存储的数据备份 将整个目录结构做备份 包括 data 目录 users 目 录 user txt 文件 scraft ini 文件 对于以其它目录结构存储的数据备份 直接备份新增部分的内容 可直接拷贝原文件 或利用 windows 备份工具进行备份 1 5 备份资料的管理备份资料的管理 备份服务器上应保留各项目最近三次的备份数据 以备数据库损坏时的恢复使用 备份 服务器上项目资料的备份 由各备份负责人 配置管理员 负责维护和管理 各部门配置管 理员负责备份资料在公司备份服务器上的安全 在备份完成的当天进行检查 如果出现不正 常现象 立即重新进行备份 由综合管理部项目监理负责统一管理并及时检查备份服务器的 备份数据的安全 1 6 备份服务器的安全管理备份服务器的安全管理 公司备份服务器的权限设置 网络安全 日常维护由综合管理部项目监理进行负责 各 部门配置服务器由本部门配置管理员负责权限设置 网络安全 日常维护 服务器的防杀毒 工具统一使用 Norton 1 7 检查措施检查措施 各部门配置管理员负责检查备份服务器上本部门项目备份数据的安全可靠性 项目监理负责统一检查备份服务器上公司所有部门项目备份数据的安全可靠性 及时性 版 本4 2页 码11 19 及备份服务器的稳定性 反映在 项目状态报告 中 2 备份服务器管理备份服务器管理 售后售后 2 1 人员及职责人员及职责 各部门配置管理员和项目经理 负责结项后进入售后维护期项目资料的整理 移交工作 项目监理 负责项目移交资料的交接工作 负责核对移交资料与清单的一致性 并将移 交资料进行备份和保存 负责公司备份服务器的权限设置 网络安全 日常维护 测试人员 咨询与应用中心售后服务组负责项目资料文档一致性检查工作 erp 部门负 责本部门的项目资料文档一致性检查工作 2 2 备份范围及备份途径备份范围及备份途径 备份范围包括咨询与应用中心 研发部门 ERP 事业部结项后进入售后维护期项目的所 有资料 包括纸质文档和项目受控库的所有文档 备份工作由各部门配置管理员在本部门的服务器上为移交资料的项目设置共享目录 项 目监理通过网络直接备份到综合管理部服务器上 2 3 备份方式备份方式 各部门配置管理员协助项目经理将项目受控库中资料按类别归档清晰 填写在 电子文 档移交清单 上 纸质文档也需标注清楚 移交给项目监理 2 4 备份资料的管理备份资料的管理 综合管理部备份服务器分布 服务器名称服务器名称 硬盘大硬盘大 小小 备份内容备份内容备注备注 综合管理部发行库 项目结项后配置库压缩包光盘备份 公司日常开发库及配置库备份 QASVR 80G 项目原始 GET 版本 更新 GET 版本 1 更新 GET 版本 2 更新 GET 版本 n 版 本4 2页 码12 19 综合管理部发行库 热备份 项目配置库压缩包 热备份 QABACKUP 80G 项目原始 GET 版本 热备份 更新 GET 版本 1 更新 GET 版本 2 更新 GET 版本 n 公司日常开发库及配置库备份 项目监理收到 电子文档移交清单 后 将项目受控库从移交部门服务器拷贝到综合管 理部服务器 QASVR 上 并核对清单与电子及纸质文档的完整性 核对无误后 安排相关部 门进行项目文档一致性检查 全部检查无误后 项目监理将受控库资料导入到发行库中统一存档 并将项目受控库资 料 GET 到 QASVR 中备份 最后将 GET 版本和项目受控库压缩包刻录成光盘保存 若项目 售后过程中有版本更新 需在两台备份服务器上将项目 GET 版本 发行库及光盘内容全部 进行更新 保持版本一致性 为了保证备份数据的安全性 项目监理还需在 QABACKUP 上对综合管理部发行库 GET 版本和项目受控库压缩包进行热备份 2 5 备份服务器的安全管理备份服务器的安全管理 综合管理部备份服务器 QASVR QABACKUP 的权限设置 网络安全 日常维护统 一由项目监理进行负责管理 2 6 检查措施检查措施 项目监理负责按月及每次更新后对综合管理部两台备份服务器上发行库进行检查 GET 版本和光盘上的项目备份数据每季度检查一次 并对检查结果进行记录 2 7 恢复机制恢复机制 综合管理部发行库及其热备份若因各种原因发生丢失 可以将每次 GET 版本逐一添加到 发行库中 恢复其备份 若整个备份服务器出现问题 可以读取刻录的光盘 恢复所有资料 版 本4 2页 码13 19 附录二 附录二 配置库 配置库 Visual SourceSafe 的 的管理管理 1 建库类型建库类型 公司所有立项项目根据 配置管理计划 需要建立三个配置库 分别是 开发库 建立目的 为了使开发小组成员在开发过程中能够保持同步和资源共享 更好地进行协 同作业 开发库由配置管理员在开发服务器上建立 存放开发过程中的所有工件 配置管理员应 跟据项目配置管理计划确定权限分配 权限不能随意改动 如果需要更改权限 须由项目经 理批准并告知配置管理员方可进行改动 受控库 建立目的 为了保存各阶段所有通过的产品 并对其变更进行跟踪和控制 受控库由配置管理员在开发服务器上建立 受控库中进行的活动包括 存放各阶段通过 的所有产品及以后每次变更的结果 存放和升级基线 存放测试过程中产生的所有 BUILD 发行库 建立目的 在于保存所有可向用户发行产品版本以及已经发布产品版本 发行库由综合管理部项目监理在质量服务器上建立 存放项目移交后所有可向用户发行 的版本以及已经发布的版本的所有项目资料 注 本文以 注 本文以 VSS 库为例 项目组可以根据需要自行决定开发库的种类 但库的结构必须库为例 项目组可以根据需要自行决定开发库的种类 但库的结构必须 参照本文的规定 受控库必须统一使用参照本文的规定 受控库必须统一使用 VSS 库结构库结构 2 1 开发库结构 此部分结构目录 只针对研发二部使用 cvs 开发时 使用的目录 版 本4 2页 码14 19 以上目录为使用以上目录为使用 cvs 的开发库主目录结构 的开发库主目录结构 下级子目录可根据项目情况自由定义 但存 下级子目录可根据项目情况自由定义 但存 放工件必须依据如下规定 放工件必须依据如下规定 项目名称 即资源库建库名称 使用项目的名称的全拼 并且第一个字母大写 例如 长庆钻井项目可命名为 ChangQingZuanJing 版 本4 2页 码15 19 一级目录 projects doc 中存放项目整体架构设计文档 项目总体开发文档 项目总体测 试文档 测试用例 测试报告 测试总结等 一级目录 projects 项目子系统名称 可并列所有子系统 每个子系统命名为项目子 系统的全拼 并且第一个字母大写 每个子系统目录下分为 doc 和 codes Doc 存放该子 系统的开发计划 分析设计文档 包括概要设计 详细设计 ER 图 分析模型 设计模 型 数据模型等 测试文档等 Codes 中存放组件 源代码 打包文件等 具体存放规 则详见 JAVA 技术规范 一级目录 administrator 项目计划 存放项目除 设计 测试阶段 外的所有计划 包括 项目总体计划和各阶段子计划 总体计划 需求计划 实施计划 培训计划 验收计划 风险控制计划 配置管理计划 质量保证计划等 需求 存放项目规格说明书 需求调研报告 包括总体调研 详细调研 需求用例模型 书 用例图 需求规格说明书 用户界面原型及需求跟踪与控制方面的文档等 实施与发布 存放实施数据 培训文档 安装程序 安装指南 用户手册 发布说明 安装包等 质量配置管理 存放项目过程中产生的配置项变更记录 及项目质量相关的记录等 项目跟踪与控制 存放成本 风险 进度等方面的跟踪数据 及存放 月状态报告 周 例会 月度例会 阶段例会的会议记录等 客户方文档 存放客户的各种要求 建议 意见等跟客户相关的资料 版 本4 2页 码16 19 2 2 受控库结构 此部分结构目录 主要用于非受控库结构 此部分结构目录 主要用于非 cvs 开发库及项目受控库 开发库及项目受控库 项目名称 规范 模板 待评审区 可选 个人工作区 可选 软件开发过程 需求 分析设计 编码 测试 实施与发布 项目管理 会议纪要 项目跟踪与控制 月状态报告 项目计划 配置管理 质量管理 客户方文档 其 它 跟踪与控制 售前方案 可选 其它 可选 版 本4 2页 码17 19 以上目录结构说明如下 以上目录结构说明如下 蓝色部分为可选项蓝色部分为可选项 下级子目录可根据项目情况自由定义 但 下级子目录可根据项目情况自由定义 但 存放工件必须依据如下规定 存放工件必须依据如下规定 规范 模板 存放项目组通用的约定 规范 指南性质的文档 和模板 如项目专用模板 程序命名约定 编程指南 设计指南 建模指南 用户界面指南 等 待评审区 可选 存放项目待评审 待测试 待审批的工件 个人工作区 可选 存放当日个人工作工件 完成后方可放入相应目录 也可存放与项 目相关的个人文档资料 售前方案 可选 存放项目销售方案及销售方面资料文档等 需求 存放项目规格说明书 需求调研报告 包括总体调研 详细调研 需求用例模型 书 用例图 需求规格说明书 用户界面原型及需求跟踪与控制方面的文档等 分析设计 存放整体架构设计和各个子系统设计文档 包括概要设计 详细设计 ER 图 分析模型 设计模型 数据模型等 编码 存放组件 源代码 打包文件等 测试 存放测试用例 测试报告 测试总结 BUILD 版本等 实施与发布 存放实施数据 培训文档 安装程序 安装指南 用户手册 发布说明等 其它 可选 存放打包工件或与项目相关的其它资料等 项目计划 存放项目所有计划 包括项目总体计划和各阶段子计划 总体计划 需求计 划 设计计划 编码计划 测试计划 实施计划 培训计划 验收计划 风险控制计划 配 置管理计划 质量保证计划等