软件版本管理系统要求规范
- 格式:doc
- 大小:106.07 KB
- 文档页数:14
软件版本管理规范软件版本管理是软件开发过程中非常重要的一环,它对于保证软件的稳定性、可靠性和持续改进至关重要。
本文将介绍软件版本管理的规范,并提供一些最佳实践方法。
1. 版本管理概述软件版本管理是指对软件开发过程中产生的各个版本进行有效的记录、追踪和控制的过程。
通过版本管理,开发人员可以更好地管理和控制软件的迭代过程,快速回溯和解决问题,并进行版本发布和部署。
2. 版本控制系统选择为了进行有效的软件版本管理,选择合适的版本控制系统是至关重要的。
目前,常用的版本控制系统包括Git、SVN等。
在选择版本控制系统时,应考虑团队规模、项目需求、安全性和易用性等因素。
3. 分支管理策略分支是版本管理中的一个重要概念,它可以用来组织和管理不同功能或者不同版本的代码。
在进行分支管理时,应采用适当的策略,例如主分支只用于发布稳定版本,开发人员在从主分支拉取新分支进行开发等。
4. 版本命名规范为了方便追踪和识别版本,应采用一致的版本命名规范。
常用的版本命名规范包括主版本号、次版本号和修订号,例如1.0.0。
在进行版本升级时,应遵循一定规则,例如主版本号的升级表示不兼容的变更,次版本号的升级表示向下兼容的功能性变更,修订号的升级表示修复bug或者进行优化。
5. 版本发布和部署流程版本发布和部署是软件开发中的关键环节之一。
为了确保发布和部署的顺利进行,应建立相应的流程和规范。
例如,在进行版本发布前,应进行相关测试,包括单元测试、集成测试和回归测试等。
发布后,还应做好版本的文档更新、用户通知和性能监控等工作。
6. 版本记录和变更日志为了追踪和记录每个版本的变更情况,应建立完善的版本记录和变更日志。
版本记录可以包括版本号、发布日期、变更内容、责任人等信息,而变更日志则可以详细描述每个版本的新增、修改和删除的功能点。
7. 版本回退和紧急修复在软件开发过程中,可能会出现某个版本存在严重问题的情况,需要进行回退或者紧急修复。
为了应对这种情况,应建立相应的应急处理流程和规范,例如定期备份代码、建立热修复机制等。
软件更新与版本管理规范随着科技的不断发展,软件的更新成为了保持软件持续优化和功能完善的重要手段。
为了更好地管理软件的版本和保障软件的稳定性与安全性,制定一套软件更新与版本管理规范显得尤为重要。
本文将从软件更新的必要性、版本管理的原则以及实施规范等方面进行论述。
一、软件更新的必要性1.1 提高软件性能:通过软件更新,可以修复软件中的漏洞、缺陷以及意外崩溃问题,从而提高软件的稳定性和性能。
1.2 优化软件功能:软件更新可以为软件添加新功能、改进用户体验,并能适应新的操作系统和硬件环境等。
1.3 安全性提升:随着网络安全威胁的增多,及时的软件更新可以修复已知的安全漏洞,并保障软件和用户数据的安全。
二、版本管理的原则在软件开发和维护过程中,版本管理起着至关重要的作用。
遵循以下原则可以更好地管理软件的版本。
2.1 版本编制规范:采用统一的版本编制规范,例如使用主版本号、次版本号和修订号的形式进行标识,清晰明确软件的版本信息。
2.2 版本控制策略:引入版本控制工具,如Git、SVN等,实现对软件源代码、二进制文件以及相关文档等的版本控制,确保版本变更可跟踪、可控制。
2.3 版本发布流程:建立完善的版本发布流程,包括需求评审、开发、测试、交付等环节,确保每个版本的质量和稳定性。
2.4 版本文档编制:每个版本发布时都应编写相应的版本文档,包括版本说明、功能列表、BUG修复情况等,以帮助用户更好地了解和使用软件。
三、软件更新与版本管理的实施规范3.1 制定软件更新策略:根据软件的特性和需求,制定合理的软件更新策略。
例如,可以设定定期的更新时间、自动更新或手动更新等方式。
3.2 进行软件更新测试:在发布更新版本之前,务必进行充分的软件更新测试。
包括功能测试、性能测试、兼容性测试等,确保更新后的软件能够正常运行。
3.3 时间敏感性更新规范:对于一些时间敏感性的软件更新,例如紧急修复漏洞等,需要制定相应的更新规范和流程,确保及时响应和快速处理。
版本管理规范一、引言版本管理是软件开辟过程中非常重要的一环,它能够有效地管理软件的版本、变更和发布,确保团队成员之间的协作顺畅,同时也能够提高软件开辟的质量和效率。
本文将介绍版本管理规范的制定目的、适合范围和基本原则,以及具体的版本管理流程和规范要求。
二、目的版本管理规范的目的是为了规范团队成员在软件开辟过程中的版本管理行为,确保软件开辟过程的可控性和可追溯性,提高团队协作效率,减少版本冲突和错误,保证软件的稳定性和可靠性。
三、适合范围本版本管理规范适合于所有软件开辟项目,包括但不限于需求分析、设计、编码、测试和发布等阶段。
四、基本原则1. 版本命名规范:版本号应采用主版本号.次版本号.修订号的格式,例如1.0.0,其中主版本号表示重大功能更新或者架构变更,次版本号表示功能增加或者改进,修订号表示错误修复或者小的改动。
2. 版本控制工具:团队成员应使用统一的版本控制工具进行代码管理,常用的版本控制工具有Git、SVN等。
3. 分支管理策略:根据项目的需要,合理规划分支管理策略,例如主分支用于发布稳定版本,开辟分支用于新功能的开辟,修复分支用于错误修复等。
定性,同时记录版本发布的相关信息,如发布日期、发布内容等。
5. 变更管理:对于每一次代码变更,都应记录变更的内容、原因和责任人,并及时通知相关人员。
五、版本管理流程1. 创建新的版本:在开始新的开辟任务之前,团队成员应基于主分支创建新的开辟分支,并根据任务的名称或者编号进行命名。
2. 开辟和测试:团队成员在各自的开辟分支上进行开辟和测试工作,确保代码的质量和功能的完整性。
3. 合并和冲突解决:当开辟任务完成后,团队成员将代码合并到主分支,并解决可能浮现的冲突。
4. 版本发布:在主分支上完成代码合并和冲突解决后,进行版本发布前的测试和审核工作,确保版本的质量和稳定性。
5. 变更管理:对于每一次代码变更,团队成员应及时记录变更的内容、原因和责任人,并通知相关人员。
XXXX公司技术文件软件版本管理规范XXXX公司二○一八年一月目录第1章引言 ............................................................................................................. - 1 -1。
1 目的 ......................................................................................................... - 1 -1.2 适用范围 .................................................................................................... - 1 -1。
3 术语定义和缩写词 ................................................................................. - 1 -1。
4 统一大小写 ............................................................................................. - 1 -1.5 参考资料 .................................................................................................... - 1 -第2章版本规范 ..................................................................................................... - 2 -2。
1目的标识、控制和追踪软件开发和实施过程中产生的各种软件产品版本。
2适用范围适用于软件源代码、产品版本的管理。
3职责3.1测试管理确保项目版本按照正确的版本管理规范执行和使用。
3.2配置管理员负责定期检查各项目对版本管理规范的执行度;根据发展需要对规范进行完善。
3.3配置管理员负责项目软件产品版本管理规范的推行,指导项目组成员使用版本命名规范进行版本管理。
4软件版本管理规范4.1版本命名规范版本:主版本号.子版本号.维护版本号.Tag.测试版本号(1)主版本号:使用1位数字,从1开始;当功能模块有较大的变动或子版本号满,即可升级,比如增加多个模块或者整体架构发生变化。
此版本号变更需经项目委员会审批。
主版本号改变,则子版本号、测试版本号、Tag和维护版本号重置;(2)子版本号:使用1位数字,从0开始;当功能有一定的增加、变化或测试版本号满,即可升级,比如增加了对权限控制、增加自定义视图等功能。
此版本号变更需经高级项目经理审批。
子版本号改变,则测试版本号、Tag和维护版本号重置;(3) 维护版本号:为可选项,两位数字,从1开始,系统交付用户使用后,功能有少量的增加或变化,或是对已发布系统的缺陷修复或一些小的变动(如改变几个程序文件),则通过升级维护版本号的方式来发布。
维护版本号改变,则测试版本号和Tag重置;(4)Tag分为三类,分别为:Alpha、Beta、Release;Alpha版: 简称(A),内部测试版,一般只在内部运行,不对外公开;主要是项目组成员对产品进行测试,检查产品是否存在缺陷、错误,验证产品功能与说明书、用户手册是否一致;Beta版: 简称(B),当软件进入模拟生产环境测试阶段或发布给典型用户进行测试;该版本相对于Alpha版已有了很大的改进,消除了严重的错误,但还是存在着一些缺陷,需要经过进一步的测试,以便在正式发行前进行改进和完善。
该版本也称为待发行版;4.3软件产品包命名规范<标签名>_yymmdd[_S/C](1) [_S/C]为可选项,_S表示服务器端应用系统,_C表示客户端应用系统;示例:。
软件开发版本控制规范详解在软件开发过程中,版本控制是非常重要的一环。
它能够帮助开发团队有效地协同工作、管理代码及项目的变更。
本文将详细介绍软件开发版本控制的规范,包括命名规则、分支管理、代码审核以及发布流程等内容。
一、命名规则在版本控制中,合理的命名规则能够使开发人员快速识别和定位不同的版本。
下面是一些常用的命名规则示例:1. 主版本号(Major Version).次版本号(Minor Version).修订号(Revision Number):例如1.0.0。
2. 年份.月份.修订号:例如2023.09.01。
3. 使用语义化版本(Semantic Versioning):例如v1.0.0-alpha.1。
团队可根据实际需要选择适合自己的命名规则,但需要确保团队成员之间的统一和沟通畅通。
二、分支管理有效的分支管理可以帮助团队并行开发不同的功能和修复bug,同时减少代码冲突的发生。
下面是一些常用的分支管理策略:1. 主分支(Master):用来保存稳定的正式版本,只能从其他分支合并,不能直接在该分支上修改代码。
2. 开发分支(Develop):用来集成各个开发人员的代码,是日常开发工作的主要分支。
3. 功能分支(Feature):用来开发新功能的分支,从开发分支上创建,开发完成后合并回开发分支。
4. 修复分支(Bugfix):用来修复线上问题的分支,从主分支上创建,修复完成后合并回主分支和开发分支。
5. 发布分支(Release):用来准备发布正式版本的分支,从开发分支上创建,进行代码审核、打包、测试等工作,完成后合并回主分支。
团队可根据具体项目和团队规模选择适合的分支管理策略,并在团队中建立相应的分支管理流程。
三、代码审核代码审核是保证软件质量的重要环节,它能够发现和纠正潜在的问题,提升代码的可维护性。
下面是一些常用的代码审核规范:1. 代码静态分析工具:使用静态代码分析工具,如Lint、SonarQube等,对代码进行自动检查,并根据检查结果进行修改。
软件版本管理规范第一章目的本规范详细规定软件项目版本管理的对象、存储目录、分支、权限、维护等内容,使软件项目版本管理流程化并规范化,确保在系统开辟和实施过程中项目的完整性和一致性。
1. 第二章合用范围所有系统开辟及实施项目的软件项目都应进行版本管理。
项目中所有正式文档和代码都应纳入配置库(可使用工具建立配置库,本文所述使用的是 SVN )进行版本管理。
2. 第三章职责配置库管理员:负责配置库的日常维护和管理;监督开辟及测试部门及时提交版本管理对象(即配置项)。
此岗位可由开辟或者测试人员兼任。
3. 第四章内容4.1. 版本管理对象包括但不限于:项目总体计划可行性研究报告开辟计划需求说明书需求设计原型设计说明书系统开辟变更申请单系统管理手册用户操作手册培训计划培训记录源程序支持系统运行的配置文件存储过程脚本测试计划测试用例测试脚本测试报告上线计划上线申请版本维护日志4.2. 配置库的目录结构每一个项目在配置库中应拥有惟一的项目名称。
配置库目录结构与项目内部的目录结构建议按下列格式创建。
配置库目录结构规划:┠tags(发布)┃├v1.0.0_T1_2022909┃ ├v1.0.0.33899_T1_20221009┃├v1.0.0_R1_20221109┃├v1.1.0_T1_20220229┃└v1.1.0_R1_20220229┠trunk(主版本)┃└projectA┃ ├sr c┃├ MY_MOOC┃ ├do c┃ ├too l┃├。
┖branches(分支)├SY_ABC├TJ_ABC├WH_MOOC其中,项目内部的目录结构:|– projectA|–src (保存该项目的源程序)|–doc (保存项目相关文档)|–000.项目管理 (保存项目过程管理相关文档)|–010.项目计划 (保存项目计划相关文档)|–020.项目需求 (保存项目需求相关文档)|–030.系统设计 (保存项目设计相关文档)|–030.系统测试 (保存项目代码测试相关文档)|–040.系统实施 (保存项目部署实施相关文档)|–050.系统运维 (保存项目运维文档,包括培训、用户手册等)|–060.技术资料 (保存项目技术文档,包括第三方技术资料等)|–。
软件版本管理规范软件版本管理规范是指对软件开发过程中的版本进行管理的一系列规定和措施。
版本管理规范的目的是为了保持软件开发过程的稳定性和可控性,确保软件的质量和可靠性。
一、版本号命名规范1. 版本号由主版本号、次版本号和修订版本号组成,格式为“主版本号.次版本号.修订版本号”。
2. 主版本号表示重大功能改变或架构改变,增1。
3. 次版本号表示新增功能或重要的bug修复,增1。
4. 修订版本号表示小的改动或bug修复,增1。
5. 版本号从1开始,多次迭代后主版本号不变,次版本号递增,修订版本号保持从1开始递增。
二、版本控制规范1. 使用版本控制工具对源代码进行管理,例如Git、SVN等。
2. 每个项目创建独立的分支,主分支用于稳定版本发布,开发分支用于功能开发和bug修复。
3. 每个开发人员在自己的独立分支上进行开发,开发完成后将代码合并到开发分支,测试通过后再合并到主分支。
4. 每个版本发布前,对代码进行全面的测试,包括单元测试、集成测试和系统测试。
三、文档管理规范1. 每个版本发布前,编写相应的版本发布说明文档,包括版本改动内容、新增功能、修复bug等。
2. 所有的文档都要进行版本管理,与代码版本相对应。
3. 每个版本发布后,要及时更新相应的文档,包括用户手册、API文档等。
四、发布规范1. 每个版本发布前,要进行严格的测试,确保软件的质量和稳定性。
2. 每个版本发布时,要记录发布日期、发布人、版本号等信息。
3. 发布后要及时更新版本控制工具,将发布的版本标记为稳定版本。
五、变更管理规范1. 每个版本开发过程中,要及时记录相关的变更信息,包括功能变更、bug修复等。
2. 对于关键的变更,要在团队内进行讨论和评审,并及时通知相关人员。
总之,软件版本管理规范是保持软件开发过程稳定和可控的重要手段。
通过合理的版本号命名、版本控制、文档管理、发布规范和变更管理,能够更好地管理软件版本,提高软件开发的效率和质量。
信息系统软件版本管理办法第一章总则第一条为加强软件版本管理,规范软件版本管理工作流程,提高版本运行维护质量,保证信息系统安全可靠高效地运行,特制定本办法;第二条本办法涉及的软件包括在线运行的软件和拟投产的软件;软件版本管理对象包括应用软件版本以及相关操作系统、数据库、中间件等基础软件;第三条软件版本管理是信息系统开发管理和日常维护管理工作的一个重要组成部分,本办法作为软件版本管理的重要依据,软件版本管理归口管理部门、业务支撑部门、风险管理部门、内审部门及各软件供应商要认真履行各自职责,严格执行软件版本管理的各项流程和规定,保障信息系统的安全稳定运行;第四条任何未经版本归口管理部门许可的软件版本不允许在生产环境使用;在商务合同中若涉及信息系统软件版本,应确认为版本归口管理部门允许使用的软件版本;因使用未经许可的软件版本而造成系统故障影响正常业务交易,相关部门及各厂商要承担相应的责任;第五条本办法由信息技术部负责解释和修订,自发文之日起开始执行;第二章组织与职责第六条软件版本管理实行总行集中管理体系;第七条信息技术部是信息系统软件版本的归口管理部门;第八条稽核监控部是信息系统软件版本管理的内审部门;第九条风险管理部是信息系统软件版本管理的风险控制部门;第十条信息系统软件版本管理工作还涉及软件提供商,软件提供商包括软件最终提供商、代理商和维保服务商以下简称厂商;第一节归口管理部门职责第十一条归口管理部门负责制定和完善的软件版本管理办法;第十二条归口管理部门负责制定信息系统软件版本管理工作的工作计划、工作要求和技术规范,并组织实施;第十三条归口管理部门负责审批业务支撑部门上报的版本变更申请,组织进行资料审核和上线测试,安排试运行工作及全行推广实施;第十四条归口管理部门负责建立软件版本信息库,发布软件版本管理各类信息;建立版本预警体系,发布软件版本缺陷信息和版本预警信息;第十五条归口管理部门负责与业务支撑部门、风险管理部门、内审部门、厂商协调信息系统软件版本管理的相关工作;第三节业务支撑部门职责第十六条版本管理业务支撑部门负责业务类需求的日常收集和集中收集;第十七条版本管理业务支撑部门负责发起新版本的试运行申请;第十八条版本管理业务支撑部门负责协助归口管理部门审核新版本发布资料包括申请、厂家及仿真环境测试报告、版本说明文档、升级方案、测试方案等,并协助归口管理部门开展新版本试运行测试工作;第十九条版本管理业务支撑部门负责自查并督促其下属机构履行职责,严格执行版本管理相关制度和流程;第四节风险管理部门职责第二十条版本管理风险管理部门负责重大版本发布前的风险评估;第五节内审部门职责第二十一条版本管理内审部门负责监督和检查版本管理归口管理部门、业务支撑部门、风险管理部门和厂商是否严格执行版本管理的相关制度与流程;第五节厂商义务第二十二条信息系统厂商应严格遵守软件版本管理的规章制度、技术规范;第二十三条信息系统厂商应根据业务发展及运行维护的需要及时更新版本,保证在线运行的软件版本是允许使用的版本;第二十四条信息系统厂商应配合软件版本归口管理部门进行软件仿真测试,及时提供各类运行维护及仿真测试所需的文件资料和技术咨询,并对这些材料的真实性、可靠性和实时性负责;在不具备相应仿真测试环境的情况下,厂商有义务提供仿真环境配合开展测试;第二十五条信息系统厂商应配合进行试运行工作;厂商应根据版本变更情况选择能够测试所有升级功能点的分支机构,并结合用户量、安全性等的要求向提出试验点建议;第二十六条信息系统厂商应配合做好信息系统软件版本管理工作,建立本厂家信息系统软件版本管理资料库信息,协助软件版本归口管理部门做好版本预警信息的发布与管理,提供必要的技术资料和技术支持;第二十七条信息系统厂商应指定专门的版本管理联系人与软件版本归口管理部门衔接,以便配合进行软件的升级实施和及时跟踪处理升级过程中或者升级后出现的各种故障;第二十八条信息系统厂商有义务在升级过程中按照的要求配合完成各项工作,包括协助软件版本归口管理部门模拟重现升级或试运行期间出现的和软件版本相关的故障;第二十九条信息系统厂商有义务在工程招标书中,承诺按照版本管理相关制度和流程履行投标方的义务;第三章版本管理内容与流程第三十条信息系统软件版本分为版本和补丁;版本是指软件系统中的核心部分发生结构性变化、应用部分新增若干功能而生成的软件版本;补丁是指软件系统中不涉及核心部分的变化,只是应用部分的故障修复或功能完善而生成的软件版本;第三十一条版本管理的各项工作必须按照规定的操作流程执行,各相关部门应认真履行本部门的职责,做好部门之间的衔接和协调;第三十二条版本管理工作内容主要包括需求管理、认证管理、变更管理、评估管理和信息管理;其中,需求管理是通过收集、整理和分析版本的新特性需求或未修复缺陷,引导厂家新版本开发,确定待认证的版本;认证管理是依据技术规范,对厂家待认证版本的符合性和可用性进行认证,并对已认证版本进行更新或废止管理;变更管理是对生产运行版本变更的技术审核和流程管控;评估管理是对生产运行版本的版本能力、缺陷等方面的评价和管理;信息管理是对全行软件版本信息及版本管理工作各环节输出信息的动态管理,主要包括信息的收集、整合、关联、更新、价值挖掘和全行共享,是版本管理各项工作的基础;第一节需求管理第三十三条版本需求管理主要分为业务类需求管理和运行维护类需求管理两大类,两大类需求的特点如下:(一)业务类需求:包括对原有业务模型、业务流程进行变更完善的需求,对新业务模式、新业务功能的支撑需求以及与业务推广能力相关的需求等;(二)运行维护类需求:包括运维监控类需求、系统软件版本缺陷和问题解决需求等与运行维护工作直接相关的需求;第三十四条运行维护类需求由信息技术部系统运行中心以下简称运行中心牵头收集整理,业务类需求由信息技术部系统开发中心以下简称开发中心牵头收集整理,最终由软件版本归口管理部门负责进行统一梳理后落实到建设项目中,组织技术规范的修订;第三十五条需求收集分为两种:日常收集和集中征集;(一)日常收集:业务类需求由需求提交部门发起,开发中心收集整理,运行维护类需求由运行中心不定期向综合部提交新需求并填写软件版本需求汇总表见作为附件;(二)集中征集:在专项治理工作中,由专项治理工作归口管理部门发起、在规定时期内征集各方需求,然后统一汇总整理,向需求归口管理部门提交新需求并填写软件版本需求汇总表见作为附件;第二节认证管理第三十六条软件新版本的认证过程包括仿真环境测试和生产环境试运行测试;第三十七条仿真环境测试主要测试内容包括:版本差异化测试新增功能测试、功能变更测试、故障修复有效性测试、新版本回归性验证测试即原有功能点的测试、新版本的升级过程测试、性能测试、业务功能测试等;由厂商自行组织的内部测试也应涵盖上述测试内容;第三十八条原则上,业务类需求导致的新软件版本由信息技术部开发中心组织进行仿真环境测试;运行维护类需求导致的新软件版本由信息技术部运行中心组织进行仿真环境测试;如果新版本包含以上两方面的需求,则由软件版本归口管理部门统一组织新版本的仿真环境测试;新版软件正式开始测试前,厂商应向上述部门提交相关技术资料和说明书;说明书中应包含以下内容:(一)软件版本变更的原因及必要性,新版软件与旧版软件的差异性说明、新增功能说明、新版软件对硬件环境的要求、涉及第三方的软件版本说明;(二)维护手册及有关资料变更部分;(三)新版软件对所在平台及所承载业务的影响以及对相连的系统的影响以及相关接口包括第三方接口变化的说明文档;(四)新版本的历史应用情况,已知缺陷、隐患或与需求含商务需求、设计需求、业务需求、运维需求等不符之处并列出解决方案;(五)对新版软件进行测试的测试方案,包括测试所用的软硬件环境、测试项目及具体测试方法步骤、测试环境要求及预期结果;(六)详细的升级方案及针对各种异常情况的应急预案,升级失败的应急回退方案等;(七)厂商内部测试情况报告;第三十九条对于信息系统软件新版本的仿真环境测试原则上应在提供的仿真环境中进行,对不具备测试条件的,厂商须提供相应的仿真环境;厂商应在测试前,配合进行仿真环境的准备工作;仿真环境应能对版本进行尽量完整的测试;第四十条对于仿真环境下无法测试的测试用例,经归口管理部门审核后可在试运行阶段再进行测试;第四十一条因版本质量问题导致不能完成测试或测试报告结论为不通过的,需由厂商修改问题后重新测试;测试完成后测试单位应向软件版本归口管理部门提交新版本的测试报告XX系统XX版本测试报告见;测试报告文档应包含内容:(一)测试原因(二)测试环境拓扑图(三)测试所需软硬件及其他工具可选(四)基本连接和配置可选(五)测试项目及具体测试方案(六)测试结论包含测试情况如何,该版本功能是否完善,是否符合申请内容以及升级建议等第四十二条对于测试中不满足要求的项目,厂商应给出相应的改进承诺和时间表;第四十三条完成版本测试后,业务支撑部门应向软件版本归口管理部门提出试运行建议申请,并填写XX系统XX版本试运行建议表详见附表四,由软件版本归口管理部门发布新版本的试运行通知;第四十四条信息系统的试运行升级申请应至少在升级日期前七个工作日提交到软件版本归口管理部门,软件版本归口管理部门在收到升级申请后的四个工作日内完成批复,试运行准备时间不少于三个工作日;在紧急情况下,试运行申请至少提前四个工作日提交到软件版本归口管理部门,软件版本归口管理部门在收到申请后两个工作日内完成批复,试运行准备时间不少于两个工作日;升级方案所需要的内容具体参见;第四十五条软件版本归口管理部门组织审核测试报告、升级方案及试运行资料,并填写XX系统XX版本试运行资料审核报告详见;第四十六条重大版本变更厂商在试运行升级时应派专人在现场给予技术支撑,协助定位解决问题;第四十七条软件版本归口管理部门负责组织开展试运行工作,密切关注新版本的运行情况,业务支撑部门应按照试运行测试要求和用例进行完整测试,及时填报测试结果;原则上,试运行时间应不少于三个月;试运行结束后,提交XX系统XX版本试运行报告详见;第四十八条试运行测试完成、确认新版本安全稳定后,由信息技术部在运维管理系统发布新版本相关信息;第四十九条在新版本运行期间若出现涉及危害平台安全、影响业务运行、对客户感知造成重大影响的问题,由业务支撑部门填写XX系统XX版本软件变更申请表见,软件版本归口管理部门在两个工作日内审核回复,组织厂商、信息技术部执行版本回退或修复工作;第五十条厂商应在版本升级后五个工作日内提交版本升级故障分析报告;第五十一条厂商用于投标的软件版本以及新工程中使用的软件版本,均需由厂商向软件版本归口管理部门提出新版本测试申请,按本节管理要求开展测试认证;软件版本归口管理部门和总行验收领导小组应在工程验收时对其使用的软件版本进行检查、把关,确认工程项目中所使用的软件版本是经过测试认证的;第三节变更管理第五十二条版本变更主要指版本和补丁的投入与使用,管理工作主要包括版本升级、补丁输入的申请与审批、版本升级方案含应急措施、测试用例等的制定与审批、升级成功后的资料移交和更新等;第五十三条软件版本升级按发起方不同分为两种:(一)软件版本归口管理部门安排布置的版本升级任务,主要是为了满足总行提出的对全行信息系统的基础建设或维护的需求;(二)业务支撑部门主动提交的版本升级申请XX系统软件变更申请表见,主要是为了满足某个业务需求;第五十四条为了保证平台安全稳定运行,原则上每种平台每月升级次数不超过一次,承载不同业务的平台不安排在同一时间升级;第五十五条软件版本归口管理部门发布批准使用新版本的信息后,总行各业务部室或分支机构可以根据实际情况更换新版本;第五十六条升级方案包含但不限于以下内容:(一)升级目的(二)升级内容(三)各方工作人员职责(四)升级各步骤的时间估算(五)升级涉及范围及对业务的影响(六)具体升级步骤1.升级准备工作及注意事项2.升级操作详细步骤3.升级应急预案和应急预案启动条件4.业务测试用例(七)升级完成核对的内容及步骤(八)备品、备件的升级升级时间、地点、方式(九)运行观察(十)资料归档第五十七条升级过程中间出现升级方案中未预料到的业务中断或中断时间超出预定时间等异常情况时,软件升级工作应立即停止,按照升级方案中的应急预案进行操作,并逐级上报;第五十八条在升级结束后业务支撑部门将升级完成情况汇总,填写XX系统XX版本使用情况汇总表见,在升级完成一周后上报软件版本归口管理部门备案;第五十九条升级结束后,厂商必须向移交:(一)各级用户密码;(二)监控和应用软件的安装程序必须经过测试;(三)设备的详细配置资料;(四)设备维护手册的追加与变更;第四节评估管理第六十条评估管理是对生产环境运行版本的评估,主要包括版本能力、版本缺陷和预警等的管理和评价;版本评估结果是对已认证版本进行更新或废止的重要依据;第六十一条版本变更后,软件版本归口管理部门需跟踪新版本的使用情况,组织版本运行评估工作,对新版本满足业务功能、运行维护管理等需求的能力进行评估;如果新版本能力不足、且认证库中已存在满足需求的版本,则可将此已认证版本作为目标版本适时实施版本变更;如果新版本能力不足、且认证库中不存在满足需求的版本,则将关于新版本使用中所出现问题的评估结果提交版本管理归口管理部门;软件版本归口管理部门对评估结果进行分析,对于当前暂不需要解决的版本遗留问题进行汇总;否则输出至需求归口管理部门进行处理;第六十二条预警定义:预先对因设备软硬件版本缺陷而可能导致业务系统或设备含在线设备和拟投产运行的设备不能正常运行的因素进行警示并防范;版本缺陷的预警管理是保证在线安全、稳定运行的重要措施之一;第六十三条软件版本归口管理部门根据全行在线版本的业务和维护支撑能力、缺陷发生数量及影响、版本变更次数及原因、上线时间等因素,于每年12月20日之前提交年度版本运行评估报告;第五节信息管理第六十四条建立软件版本信息管理体系,实现全行软件版本信息及版本管理工作各环节输出信息的收集、整合、关联、共享、价值挖掘和动态管理;第六十五条软件版本归口管理部门按照统一的版本信息模型,每月初通过运维管理系统提交“全行软件版本使用情况汇总表”见并对汇总信息进行入库和维护更新管理;第六十六条软件版本归口管理部门及时发布版本信息,以便各分支机构和总行各业务部室正确选择使用的版本;各相关单位负责收集、整理、分析辖区内软件版本相关信息,并进行及时更新;版本信息库上包括但不限于以下所示:(一)各厂商的软件版本的状况,包括:版本编号、功能变更说明书、上线测试报告、核准上线日期等;(二)各厂商的软件版本在生产环境中的运行情况,包括:投入运行时间、版本分布情况、主要设备配置、版本的问题等;(三)版本问题登记,包括:软件版本、问题发生时间、原因、现象、影响、排除方法、排除时间及善后处理意见等;(四)其它相关资料,包括:技术标准、企业规范、新业务、新功能的需求汇总、论文资料等;第六节版本管理流程第四章监督与检查第六十七条版本管理内审部门将适时组织检查信息系统的软件版本管理工作情况,并及时通报检查结果;结合本年度全行在线版本管理各项工作情况,于每年底发布全行年度在线版本管理工作情况通报;对于因版本管理不善或使用未经许可的软硬件版本而造成的业务中断故障、用户投诉及经济损失等,内审部门将视具体情况对相关部门、负责人或直接责任人给予通报批评,并反映在部门考核指标中;第六十八条归口管理部门在进行“外包商服务质量评估”时,应将厂家软件版本运行评估情况及对版本管理工作的支撑情况作为评估内容之一,并将评估结果作为采购评标的重要考虑因素;在维保合同中应增加版本管理工作相关要求的条款,并进行相关考核;对于因厂家原因造成的业务中断故障及由此产生的损失,将视具体情况对相关厂家给予处罚并追究相关责任;附表一:XX业务软件需求汇总表附表二:软件版本测试申请表附表三:XX系统XX版本/补丁测试报告XX系统软件版本/补丁测试报告1.测试概况测试目的2.测试环境网络结构图3.测试内容对测试情况的描述4.测试结论测试通过或测试不通过,测试不通过请说明原因;附表四:XX业务XX版本试运行建议表附表五:XX业务XX版本试运行资料审核报告附表六:XX业务系统试运行报告附表七:XX软件变更申请表附表八:XX业务系统软件版本使用情况汇总表。
项目软件版本号管理规范编制审核批准日期日期日期2022.9.5内部资料,注意保密修订内容创建文档修订时间2022.9.5版本号V1.0修订人Revc.c 2/8一 . 目的1.1 软件版本按照一定的规则保存所有版本,避免发生版本丢失或者混淆等现象,并且可以快速准确的查找到任何版本。
1.2 软件版本规范有利于公司各部门之间的对接工作,有利于公司内部资料统一管理。
1.3 本文档是为规范研发部软件版本管理而制定的。
二 . 范围2.1 本文档为研发部软件开辟版本提供有关版本管理规范的相关内容,包括:2.2 版本标识方法及管理2.3 版本升级2.4 文档及源码的备份制度2.5 所有研发部软件工程师成员都必须遵照项目软件管理规范操作,公司内部使用按照文档及源码存放备份制度。
三 . 版本管理3.1.1 每一个归档版本都有两个版本号:内部版本号和外部版本号。
版本号使用 VP 规则, V(Version)是指外部版本号(研发测试版本), P(Patch)是指补丁版本号(可选)。
3.1.2 版本号命名: V/B+主版本号+次版本号+修订版本号+日期版本号Revc.c 3/83.2.1 主版本号:当功能模块有较大的变动,比如增加模块或者是整体架构发生变化。
此版本号由项目决定是否修改。
3.2.2 次版本号:相对于主版本号而言,次版本号的升级对应的只是局部的变动,但该局部的变动造成程序和以前版本不能兼容,或者对该程序以前的协作关系产生了破坏,或者是功能上有大的改进或者增强。
此版本号由项目决定是否修改。
3.2.3 修订版本号:普通是 Bug 的修复或者是一些小的变动或者是一些功能的扩充,要时常发布修订版,修复一个严重 Bug 即可发布一个修订版。
此版本号由项目经理决定是否修改。
3.2.4 日期版本号:用于记录修改项目的当前日期,每天对项目的修改都需要更改日期版本号。
此版本号由开辟人员决定是否修改。
如: V8.1.0.XXX (上一级版本号有变动时,下级要归零)如此时版本号为: V8.1.0.XXX ,此时为内部测试阶段3.3.1 开辟人员修复了测试人员提交的 bug 并经测试人员测试验证关闭bug 之后,发布到外网时,此时就进入了软件的下一个阶段,版本号可改为:Revc.c 4/8V8.1.1.XXXX ,如当前日期跟上一个版本号的日期不一样,版本号可改为:V8.1.1.XXX。
软件版本管理目录1.引言 (1)1.1.目的 (1)1.2.范围 (1)1.3.术语定义 (1)1.4.参考资料 (2)1.5.版本控制记录 (2)1.6.版本更新记录 (2)2.版本管理 (4)2.1.版本标示方法 (4)2.1.1.正式版本 (4)2.2.目录结构 (5)2.3.文档的存放 (6)2.3.1.开发文档的存放 (6)2.3.2.源代码的存放 (6)2.3.3.SQL的语句存放 (7)2.3.4.发行文档的存放 (7)2.4.配置管理流程 (7)2.5.权限控制的管理 (8)3.更新管理 (9)3.1.源程序的修改 (9)3.2.版本升级 (10)3.2.1.版本升级原则 (10)3.2.2.新版本发布 (11)3.3.文档的变更 (11)4.备份管理 (12)1.引言版本控制就是对软件开发过程中所创建的配置对象不同版本进行管理,保证任何时间都可以取到正确的版本以及版本的组合。
版本控制的主要功能是记录开发过程中的每一次修改,让开发的工作可以随时检查过往历史记录和获得正确版本,是系统的成长记录。
1.1. 目的本文档的编制是为了规范产品部、研发部、测试部对软件产品版本的管理。
1.2. 范围本文档为产品部、研发部、测试部的管理员提供有关版本管理规范的相关内容,包括:●版本标识方法●软件系统数据的存放●文档的修改控制●文档的备份制度1.3. 术语定义SCM软件配置管理(Software Configuration Management)缩写SVM软件版本管理(Software Version Management)缩写SVN一个开源的版本控制系统Subversion.文档一种数据媒体和其上所记录的数据。
配置管理标识和确定系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。
软件配置软件的具体形态在某时刻的瞬时影像。
配置项软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册,源码。
基线软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果。
1.4. 参考资料《软件版本管理规范》浪潮集团山东通用软件有限公司《泰豪软件开发软件版本管理制度》《tortoise SVN的使用手册》1.5. 版本控制记录1.6. 版本更新记录2.版本管理2.1. 版本标示方法为了使工作规范化、统一化,研发本部各部门实行的版本标识管理方法。
2.1.1.正式版本软件版本号由四部分组成,X.Y.Z.DATA_希腊字母,X:主版本号,用来表示提供给客户的产品功能的主要增强。
在一个极端的例子中,主版本号的上升用来说明产品现在已经拥有了一个全新的功能类。
从市场和许可权的角度来看,主版本号的升级相当于购买一个完全独立的产品。
从开发者角度来看,一个主版本号的迭代差不多总是反映了一个新的独立分支或是其主干还可以延续主版本的生命期。
Y:特征版本号,用来表示产品新增了一些特征,或者是在原来文档中描述的特征上作了重要的修改。
用来确定特征版本号什么时候需要修改的一个衡量标准就是产品功能说明书。
产品的特征版本升级是在主版本之间保持产品竞争力的一种重要机制。
Z:缺陷修复版本号,用来表示在该版本上所做的缺陷维护行为的等级。
版修复版本是稳定市场和最小化客户技术支持费用负担的一种重要机制。
Alpha版: 此版本表示该软件在此阶段主要是以实现软件功能为主,通常只在软件开发者内部交流,一般而言,该版本软件的Bug较多,需要继续修改。
Beta版: 该版本相对于α版已有了很大的改进,消除了严重的错误,但还是存在着一些缺陷,需要经过多次测试来进一步消除,此版本主要的修改对像是软件的UI。
RC版: 该版本已经相当成熟了,基本上不存在导致错误的BUG,与即将发行的正式版相差无几。
Release版: 该版本意味“最终版本”,在前面版本的一系列测试版之后,终归会有一个正式版本,是最终交付用户使用的一个版本。
该版本有时也称为标准版。
一般情况下,Release不会以单词形式出现在软件封面上,取而代之的是符号(R)。
例如:1.1.1.051021_beta.第一个1为主版本号,第二个1为子版本号,第三个1为阶段版本号,第四部分为日期版本号加希腊字母版本号,希腊字母版本号共有5种,分别为:base、alpha、beta、RC、release。
2.2. 目录结构由于各部门的实际情况不同,目录结构很难统一,但为了能更好地管理各部门部文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放比较清晰,有利于版本管理。
具体目录如下表格所示:2.3. 文档的存放2.3.1.开发文档的存放文档归档流程:2.3.2.源代码的存放2.3.3.SQL的语句存放各子系统SQL文件放入…..\.......\SQL下,对于不同的数据库,分别建立不同的子目录,如WAT、SYB、MSS、ORC、DB2等。
公共SQL文件直接放入…\SQL 下即可,不同数据库的特殊SQL分别放入对应的子目录下。
2.3.4.发行文档的存放发行文档是指产品交付用户使用所必须的文件。
包括:产品可执行文件,用户使用说明书,联机帮助(HLP);资源文件(BMP,ICO等),环境配置文件等。
2.4. 配置管理流程流程说明:1.开发人员完成所负责代码模块的编写任务后,提交到项目经理处;2.项目经理向测试部提交测试任务;3.配置管理员准备测试所需环境;4.测试员开始测试并提供实时测试BUG;5.开发人员处理测试人员提供的BUG,并提交测试员进行回归测试,直至BUG 关闭;6.测试完成后,测试人员提供测试报告;7.根据项目情况决定是否发布新版本;8.配置管理员与各成员确定好新版本的各项信息;9.配置管理员发布新版本。
2.5. 权限控制的管理为保障文档的安全性,一致性,以及防止意外修改,必须对不同的文档设置不同的访问权限。
文档权限类别:只读权限,读写权限。
文档类别:DOC,SRD,RELEASE。
用户类别:开发人员、测试人员、分析设计人员、部门经理、配置管理员、安装盘制作人员、问题及需求管理人员、用户文档编写人员等。
为了控制不同的使用权限,根据要求在服务器上分别建立不同的用户,针对不同的配置项所在目录分配不同的权限。
为了便于各部门的管理,应以表格的形式列出人员与管理对象的访问关系(用户权限清单)。
3.更新管理3.1. 源程序的修改当开发小组在开发同一产品时,应能保障:各成员间的修改不会互相覆盖;程序员的修改能及时反映到产品的最新版本中。
建议首先在相应子系统的下一级建一目录,如checkout,存放正在修改的文档及修改登记表。
当某个程序员要修改某一文档时,遵循以下程序:1)接收维护任务;2)查看需要修改的文件(如PBL及SQL等)是否正在被其它人员修改(检查checkout目录下是否存在要修改的文件或后缀已改为该程序员姓名简写);3)如果有人在修改该文件,等待或与相应的开发员联系,重复2。
否则继续;4)将该文件复制到checkout目录下,在修改登记表中登记;或将该文件的后缀改为本人姓名简写;5)将该文件拷贝到自己的私有目录;6)根据要求修改源文件;7)根据要求测试,并进行相关项的回归测试;8)交测试人员测试,如未通过,重复6,如通过则继续;9)在checkout目录中删除该文件,并在修改登记表中标注修改完成;10)将修改完毕的文件通过电子邮件或其它手段送交版本管理员,版本管理员将文件复制到相应的路径;如遇特殊情况(版本管理员出差),程序员可将修改完毕的文件复制到相应的路径下,或将后缀改回正式。
11)回复下达者,报告维护任务完成。
3.2. 版本升级3.2.1.版本升级原则版本升级应严格纳入版本管理的控制之下。
应当谨慎地控制版本的升级,保障高版本的向下兼容性,或提供严格定义的升级方法。
主版本号(1):当功能模块有较大的变动,比如增加多个模块或者整体架构发生变化。
此版本号由项目决定是否修改。
子版本号(1):当功能有一定的增加或变化,比如增加了对权限控制、增加自定义视图等功能。
此版本号由项目决定是否修改。
阶段版本号(1):一般是Bug 修复或是一些小的变动,要经常发布修订版,时间间隔不限,修复一个严重的bug即可发布一个修订版。
此版本号由项目经理决定是否修改。
日期版本号(140606):用于记录修改项目的当前日期,每天对项目的修改都需要更改日期版本号。
此版本号由开发人员决定是否修改。
希腊字母版本号(beta):此版本号用于标注当前版本的软件处于哪个开发阶段,当软件进入到另一个阶段时需要修改此版本号。
此版本号由项目决定是否修改。
3.2.2.新版本发布新版本的发布包括主版本号和次版本号的升级,一般不包括内部版本号的升级。
流程如下:1)接收新版本发布任务,接收本次发布的版本代号。
2)在指定目录中,根据本次发布的版本号建立相应的子目录,将current下的所有内容拷贝至新建目录下。
3)可在新建目录下建立readme.txt,并加入相应的内容。
3.3. 文档的变更文档变更流程:4.备份管理为了保证文档的最大可恢复性,要随时及定期地进行备份工作。
1)随时备份:①开发人员每天都要将自已当日修改的源文件在本地机器上进行备份。
②开发负责人每天要将所有源文件在本地机备份。
③建议备份采用循环备份。
2)定期备份①备份形式为硬盘备份和光盘备份。
硬盘备份时,要备份在独立的硬盘上;光盘备份时,要将光盘存放在可靠的地方。
②备份周期视各部门的具体情况而定。
如果处于开发阶段,每周应对所有的源程序项进行备份,一般为每周周五;如果处于其它阶段,根据具体情况而定,但周期不能超过两周。
③备份要由版本管理员负责,备份原则应是保证文档的最大可恢复性。