软件三库管理规范

规定了公司软件开发库、受控库、产品库（以下简称三库）的管理规范。参照文件《软件三库管理制度》术语和定义GitLab：一个库房管理系统，使用Git作为代码管理工具，并在此基础上搭建起来的web服务。Jenkins：基于Java开发的一种连续集成平台，用于监控连续重复的工作。SPM：公司研发部开发的连续集成工具，用于集成软件部署包。Releaser：公司研发部开发的基于SPM的软件部署包宣布工具。KiwiTCMS：公司研发部基于开源代码改进的测试用例管理系统，用于测试计划和测试用例的创办和保护、以及测试执行的记录。职责3.1软件三库管理职责软件开发库由项目组管理，软件受控库由研发部管理，软件产品库由质量部管理。3.2软件管理员职责具备软件配置管理知识；熟悉研制项目的配置管理；熟悉公司结构、软件三库管理规定、表记规定和软件配置管理计划。管理内容与方法4.1建立软件三库开发库开发库代码部分和说明部分基于GitLab建立，依照软件项目分配库房。项目组长任库房Master，负责需求说明的管理、成员管理、问题追踪、分支Merge、任务分配、Tag表记等工作。项目组成员任库房Developer，负责设计和交付说明的管理、问题检查、分支保护等工作。测试组成员任库房Reporter，负责测试说明的管理、报告问题、问题回归等工作。开发库部署包部分基于Jenkins和SPM建立，依照软件项目分配库房。项目组成员负责保护自动测试脚本和版本生成脚本。Jenkins管理员（计算机）任库管理员，负责自动检查代码编译结果，执行版本生成脚本将经过检查的工程生成待测软件部署包，执行自动测试脚本考据软件部署包，将经过考据的软件部署包打上表记，放入库房。另任库管理员，负责出入库管理、配置项管理等工作。受控库受控库代码部分基于GitLab建立，依照软件项目分配库房。软件经理任库房Master，负责将经过完满测试的开发版本打上Tag表记，在GitLab上作为独立牢固的分支，该分支不接受更正，有效受控。受控库部署包部分基于Jenkins和SPM建立，依照软件项目分配库房。Jenkins管理员（计算机）任库管理员，负责将打上Tag表记的代码版本生成软件部署包，打上同样的Tag表记，放入库房。该部分目录及目录下文件一旦生成，不可以删除或更正，有效受控。受控库说明部分存在于公司内部的公共服务器。另任库管理员，负责出入库管理、配置项管理等工作。受控库测试用例部分基于KiwiTCMS建立，依照软件项目分配库房。项目组长拥有测试计划审查权限，测试组长拥有测试用例编写和测试用例审查权限，测试组成员拥有测试用例编写权限。产品库产品库存在于公司内部公共服务器，依照软件项目分配库房。另任库管理员，利用Releaser工具将经过申请的打上Tag的受控版本生成软件产品包，负责各产品的出入库管理、配置项管理等工作。4.2拟定三库管理规定内容要求软件三库管理规定：入库控制相关人填写入库申请，负责人审批，库管理员操作或检查入库，详见三库管理要求（第、、节）。接见控制各库房设置权限管理，一般来说，恩赐库管理员写权限，恩赐相关人读权限，详见三库管理要求（第、、节）。出库控制相关人填写出库申请，负责人审批，库管理员操作出库，经过安全介质交予相关人，详见三库管理要求（第、、节）。库间变换库间变换依照入库控制的要求。更正控制详见三库管理要求（第、、节）。配置状态报告详见受控库和产品库管理要求（第、节）。配置审查详见受控库和产品库管理要求（第、节）。保护规程GitLab平台搭建在服务器上，Jenkins平台搭建在服务器上，产品库位于服务器（群晖NAS），采用RAID技术便于数据重构，每晚0点各平台数据库对现有数据进行自动备份。每三个月对三库服务器进行检查保护，以便从紧急状态恢复。相关要求软件三库管理规定相关要求：配置项选择配置项选择由项目组鉴别。配置表记各库采用适应性表记，表记规范详见三库管理要求。版本控制代码版本由GitLab自动管理，部署包版本由Jenkins自动管理，产品包版本由产品库管理员管理。基线建立和更正（基线的基本划分和更正）采用GitLab平台的里程碑看法，里程碑要求分自主升级与项目组要求两部分。软件刊行软件刊行必定经过测试、申请、审批。4.3安全控制库管理员在入库、出库、更正、刊行时，推行介质鉴别、病毒检查和权限审查。4.4软件开发库管理要求入库内容软件开发库入库内容应是项目确定的软件配置项。项目组依照料客方要求和研制项目特点明确软件配置项的种类、格式和内容，对软件规模和复杂度不大的项目，可将软件配置项种类作适应的合并，但应保证内容完满。库属性软件开发库属性一般应包括的内容：配置项（配置表记、配置项地址），开发人，入库时间，更正人，更正时间，提取人，出库时间，以及提取原因，其他。入库控制将吻合项目表记、版本等软件配置要求的软件配置项入库，并依照库属性的相关要求做入库记录。接见控制软件开发库代码部分和说明部分的接见控制基于GitLab权限体系实现，部署包部分的接见控制基于服务器的权限体系实现。出库控制软件开发库出库应依照以下要求进行：按规定的权限出库：如无极特其他情况，代码部分不一样意出库；实需出库的情况，须经项目组长和软件经理审批；部署包部分和配置项部分的出库经项目组长审批，由项目组配置管理员操作出库。登记出库原因、去向和用途、使用人等信息；记录出库项、提取人和出库时间等信息。更正控制软件开发库的更正应依照以下要求进行：按规定的权限推行更正：项目组相关人建立Git分支，完成更正后提交由GitLab自动备份，在Jenkins发起集成，提交部署包给测试组成员，完成更正测试后将结果反响给项目组，项目组长审查经过，将该分支Merge到主分支，并在Jenkins倡导集成；应客户特别需求更正的分支不应Merge到主分支，经过测试后直接转入受控库；项目组成员相应更正配置项；利用GitLab的@功能向相关人实时宣布更正信息，以便相关人做相应更正；特别紧急的情况，可口头通知此后需在GitLab的Issue平台记录；Git分支及更正的配置项须吻合表记、版本的要求，标记对应版本的里程碑：Bug修复型更正须以hotfix/开头，需求蠕动型更正须以feature/开头。转受控库在软件开发过程中，经过公司认可的测试或评审的软件配置项转入受控库。受控库的代码和部署包一般拥有release/的tag表记，公司内部使用的保留develop表记，应客户特别需求集成的保留feature表记；受控库的说明拥有XXX项目YY说明表记。4.5软件受控库管理要求入库内容软件受控库的入库内容是经过测试或评审的软件配置项以及公司和顾客方认可的其他内容。库属性软件受控库属性最少应包括以下内容：配置项（配置表记、配置项地址），开发人、开发时间，评测人、评测时间，入库赞同人、入库时间，更正说明、更正人、更正赞同人、更正时间、更正申请号，出库目的、提取人、出库时间、出库赞同人，以及其他。入库控制当开发库中的软件配置项完成评测时，开发人提出入库申请；受控库管理员审查入库项的表记、版本以及测评发现的问题可否归零；受控库管理员相关入库信息进行登记。接见控制软件受控库代码部分的接见控制基于GitLab权限体系实现，部署包部分和说明部分的接见控制基于服务器的权限体系实现。出库控制提取人提交出库（或复制）申请；相关负责人审批；受控库管理员对相关出库信息进行登记。更正控制不对受控库配置项推行更正，所有更正以升级的形式实现，将升级后的相关配置项依照入库规则进行入库，并实时向相关人员宣布更正信息。升级表记吻合规定：核心升级，第一位升一级；依赖升级，第二位升一级，bug修复和需求蠕动，第三位升一级；alpha表记对内，beta表记对外。配置状态报告受控库管理员在配置项更正时向公司的相关部门报告配置状态，并向生产、使用、维护相关人员宣布受控库配置信息。配置审查在研制阶段结束从前对受控库进行配置审查：研发部指定配置审查人员；配置审查人员拟制配置审查计划，并获赞同；推行配置审查；项目组对审查发现的不吻合项进行整改；配置审查人员考据整改情况；将配置审查及考据结果通知软件经理。转产品库在定型（判断）通过后，将软件受控库中的软件配置项转入软件产品库，其他相关项纳入档案管理，其保留期应与系统服役期保持一致。4.6软件产品库管理要求入库内容软件产品库入库内容是供交付、生产、检验查收、保护的软件产品和其他软件工作产品。库属性软件产品库属性一般应包括以下内容：配置项（配置表记、配置项地址）开发人、开发时间，入库时间、入库赞同人，评测时间、评测人，评审组长、评审时间，更正说明、更正人、更正赞同人、更正时间、更正申请号，刊行人、刊行版本、刊行时间，出库目的、出库时间、提取人、出库赞同人，以及其他。入库控制开发人提出入库申请；产品库管理员对入库项进行表记和版本审查；公司代表（或授权人）应会同顾客方代表共同赞同入库；产品库管理员相关入库信息进行登记。出库控制软件产品库中的项出库（或复制）时，由使用部门或提取人提交出库（或复制）申请；公司代表（或授权人）审批；产品库管理员对相关出库信息登记。更正控制不对产品库配置项推行更正，所有更正以升级的形式实现，将升级后的相关配置项依照入库规则进行入库，并实时向相关人员宣布更正信息。公司会严格控制升级，升级表记吻合规定：核心实现升级，第一位升一级；依赖实现升级，第二位升一级，bug修复、配置更正、需求蠕动等，第三位升一级。配置状态报告产品库管理员在配置项更正时向公司的相关部门和顾客方代表报告配置状态，并向生产、使用、保护相关人员宣布