435 lines
11 KiB
Markdown
435 lines
11 KiB
Markdown
|
文件编号：YG-CMMI-CM-GD04
|
|||
|
|
发布日期：2023-06-30
|
|||
|
|
现行版本：1.1
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
修订历史记录
|
|||
|
|
|
|||
|
|
日期
|
|||
|
|
2022-08-03
|
|||
|
|
|
|||
|
|
版本
|
|||
|
|
1.0 新增
|
|||
|
|
|
|||
|
|
说明
|
|||
|
|
|
|||
|
|
作者/修改人
|
|||
|
|
王优、刘发、胡玲、张金金
|
|||
|
|
|
|||
|
|
审核
|
|||
|
|
黄德海
|
|||
|
|
|
|||
|
|
批准
|
|||
|
|
姚国全
|
|||
|
|
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
1.1
|
|||
|
|
|
|||
|
|
修订页眉中的商
|
|||
|
|
标引用
|
|||
|
|
|
|||
|
|
李锋
|
|||
|
|
|
|||
|
|
刘娟
|
|||
|
|
|
|||
|
|
向万红
|
|||
|
|
|
|||
|
|
远光软件股份有限公司 发布
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 1 页 共 8 页
|
|||
|
|
|
|||
|
|
目 录
|
|||
|
|
|
|||
|
|
第一章 总则 ........................................................................................................................................... 2
|
|||
|
|
第一条 目的 ........................................................................................................................................................2
|
|||
|
|
第二条 适用范围 ................................................................................................................................................2
|
|||
|
|
第三条 术语和缩略语 ........................................................................................................................................2
|
|||
|
|
第四条 职责分工 ................................................................................................................................................2
|
|||
|
|
第二章 云效构建流程 ............................................................................................................................. 3
|
|||
|
|
第五条 代码提交审批流程 ................................................................................................................................4
|
|||
|
|
第六条 平台代码提交流程 ................................................................................................................................5
|
|||
|
|
第七条 产品代码提交流程 ................................................................................................................................7
|
|||
|
|
第三章 其他 ........................................................................................................................................... 8
|
|||
|
|
第八条 依赖包白名单 ........................................................................................................................................8
|
|||
|
|
第九条 安全代码扫描 ........................................................................................................................................8
|
|||
|
|
第四章 附则 ........................................................................................................................................... 8
|
|||
|
|
第十条 本指南由 DAP 研发中心负责修订、解释 ............................................................................................8
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 2 页 共 8 页
|
|||
|
|
|
|||
|
|
第一章 总则
|
|||
|
|
|
|||
|
|
第一条 目的
|
|||
|
|
|
|||
|
|
为规范财务中台云效系统代码提交流程，促进各部门高效协作，提高研发项目组提交代码的质量和
|
|||
|
|
|
|||
|
|
效率，特制定本指南。
|
|||
|
|
|
|||
|
|
第二条 适用范围
|
|||
|
|
|
|||
|
|
适用于财务中台产品代码提交云效系统涉及的各研发部门。
|
|||
|
|
|
|||
|
|
第三条 术语和缩略语
|
|||
|
|
|
|||
|
|
术语/缩略语
|
|||
|
|
|
|||
|
|
解释
|
|||
|
|
|
|||
|
|
云效是阿里巴巴云原生时代一站式 BizDevOps 平台，A 集团引
|
|||
|
|
|
|||
|
|
入使用，进行端到端的全流程管理。
|
|||
|
|
|
|||
|
|
研发项目组自研程序包。
|
|||
|
|
|
|||
|
|
第三方开源程序包或付费购买的程序包。
|
|||
|
|
|
|||
|
|
云效
|
|||
|
|
|
|||
|
|
二方包
|
|||
|
|
|
|||
|
|
三方包
|
|||
|
|
|
|||
|
|
第四条 职责分工
|
|||
|
|
|
|||
|
|
序号
|
|||
|
|
|
|||
|
|
角色
|
|||
|
|
|
|||
|
|
职责
|
|||
|
|
|
|||
|
|
1
|
|||
|
|
|
|||
|
|
研发项目组
|
|||
|
|
|
|||
|
|
1. 项目经理负责云效代码提交申请；
|
|||
|
|
|
|||
|
|
2. 负责平台/产品功能测试，保证代码质量；
|
|||
|
|
|
|||
|
|
3. 负责输出静态资源到指定目录；
|
|||
|
|
|
|||
|
|
4. 项目组对应的部门经理负责审批代码提交申请。
|
|||
|
|
|
|||
|
|
2
|
|||
|
|
|
|||
|
|
DAP 研发中心-测
|
|||
|
|
试 及 交 付 中 心
|
|||
|
|
（下文简称：测
|
|||
|
|
|
|||
|
|
1. 负责准备测试环境；
|
|||
|
|
|
|||
|
|
2. 负责产品功能的联调测试和自动化测试；
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 3 页 共 8 页
|
|||
|
|
|
|||
|
|
试及交付中心）
|
|||
|
|
|
|||
|
|
3. 平台冒烟通过后，负责更新测试环境，组织产品冒烟。
|
|||
|
|
|
|||
|
|
信创平台部-测试
|
|||
|
|
部（下文简称：
|
|||
|
|
平台测试部）
|
|||
|
|
|
|||
|
|
DAP 研发中心-研
|
|||
|
|
发管理部-配置组
|
|||
|
|
（下文简称：配
|
|||
|
|
置组）
|
|||
|
|
|
|||
|
|
电力行业技术支
|
|||
|
|
持中心（下文简
|
|||
|
|
称：技术支持中
|
|||
|
|
心）
|
|||
|
|
|
|||
|
|
1. 负责准备测试环境；
|
|||
|
|
|
|||
|
|
2. 负责平台功能的联调测试和自动化测试，测试通过后邮件知会相关干系
|
|||
|
|
|
|||
|
|
人。
|
|||
|
|
|
|||
|
|
1. 负责代码本地编译验证并提取依赖包；
|
|||
|
|
|
|||
|
|
2. 负责上传代码、依赖包、静态资源及镜像依赖文件至云效；
|
|||
|
|
|
|||
|
|
3. 负责云效编译并输出镜像。
|
|||
|
|
|
|||
|
|
1. 负责提供部署环境需要的镜像依赖文件；
|
|||
|
|
|
|||
|
|
2. 负责组织在仿真环境和生产环境开展镜像部署；
|
|||
|
|
|
|||
|
|
3. 负责审批云效代码的提交。
|
|||
|
|
|
|||
|
|
电力行业一部
|
|||
|
|
|
|||
|
|
1. 负责组织在仿真环境和生产环境开展测试。
|
|||
|
|
|
|||
|
|
信创平台部-公共
|
|||
|
|
服务部-安全实验
|
|||
|
|
室（下文简称：
|
|||
|
|
安全实验室）
|
|||
|
|
|
|||
|
|
1. 负责对研发项目组提交云效的代码进行安全扫描。
|
|||
|
|
|
|||
|
|
3
|
|||
|
|
|
|||
|
|
4
|
|||
|
|
|
|||
|
|
5
|
|||
|
|
|
|||
|
|
6
|
|||
|
|
|
|||
|
|
7
|
|||
|
|
|
|||
|
|
第二章 云效构建流程
|
|||
|
|
|
|||
|
|
代码提交到云效系统有两种更新方式：
|
|||
|
|
|
|||
|
|
1、 增量更新：按需发起申请，适用于不影响其他组功能使用的代码提交；
|
|||
|
|
|
|||
|
|
2、 全量更新：按迭代或版本进行更新，由技术支持中心发起。更新前必须通过系统测试和安全测
|
|||
|
|
|
|||
|
|
试。
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 4 页 共 8 页
|
|||
|
|
|
|||
|
|
第五条 代码提交审批流程
|
|||
|
|
|
|||
|
|
1、 此流程适用增量更新时使用，全量更新由技术支持中心根据具体问题判断，直接发起。
|
|||
|
|
|
|||
|
|
2、 发起申请：由研发项目组的项目经理申请提交代码到云效。
|
|||
|
|
|
|||
|
|
3、 部门审核：由项目组对应的部门经理判断新提交代码是否影响其他项目组重新编译，只有不影
|
|||
|
|
响或能明确列出影响范围更新清单并通过测试验证的，才能提交技术支持中心负责人审批；平
|
|||
|
|
台代码不仅需要判断对平台其他组是否有影响，还需判断对其他产品是否有影响（是否需要其
|
|||
|
|
他产品调整代码或重新编译），如有影响审批不通过；如需更新，由技术支持中心根据具体问
|
|||
|
|
题判断是否发起全量更新。
|
|||
|
|
|
|||
|
|
4、 技术支持中心审批：由技术支持中心负责人根据更新时间、更新内容等确定是否审批，审批通
|
|||
|
|
|
|||
|
|
过后方可启动提交代码。
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 5 页 共 8 页
|
|||
|
|
|
|||
|
|
5、 启动云效代码提交流程：审批通过后，由配置组提取代码、依赖包和静态资源，启动提交代码
|
|||
|
|
|
|||
|
|
的工作。
|
|||
|
|
|
|||
|
|
第六条 平台代码提交流程
|
|||
|
|
|
|||
|
|
1、 提交代码：由平台研发项目组对准备提交云效的代码、依赖包、静态资源（需同步输出到指定
|
|||
|
|
目录）等进行测试验证，此过程需要本地编译构建成功，通过平台测试部的冒烟测试，同时通
|
|||
|
|
过测试及交付中心的冒烟测试。
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 6 页 共 8 页
|
|||
|
|
|
|||
|
|
平台静态资源路径：
|
|||
|
|
\\10.50.9.101\server\modular whgz\ECP\ECPV8.0.0\finalZipFile
|
|||
|
|
|
|||
|
|
2、 编译构建：由配置组根据平台提供的代码（当前为 boot 包），进行纯环境编译，确认获取依赖
|
|||
|
|
包（二方包、三方包）。如果选择增量更新，由发起者提供当前变更二方包列表、三方包列表
|
|||
|
|
和静态资源列表，如果选择全量更新，则无需提供。
|
|||
|
|
|
|||
|
|
3、 获取镜像依赖文件：由技术支持中心按部署环境提供 dockerfile、配置文件和基础镜像等依赖文
|
|||
|
|
|
|||
|
|
件给配置组。
|
|||
|
|
|
|||
|
|
4、 云效提交：由配置组根据获取的依赖包，清除云效 maven 库相关二方包，提交更新的二方包、
|
|||
|
|
|
|||
|
|
三方包、静态资源和 boot 代码并通过云效编译。
|
|||
|
|
|
|||
|
|
5、 生成并推送镜像：由配置组云效编译并获取镜像依赖文件打包，输出镜像，并将生成的镜像推
|
|||
|
|
|
|||
|
|
送云效镜像库。
|
|||
|
|
|
|||
|
|
6、 仿真环境镜像部署：由技术支持中心组织在仿真环境进行镜像部署。
|
|||
|
|
|
|||
|
|
7、 仿真环境测试：由电力行业一部组织在仿真环境开展功能测试验证。
|
|||
|
|
|
|||
|
|
8、 生产环境镜像部署：由技术支持中心负责将镜像部署到生产环境，并在生产环境进行镜像部署。
|
|||
|
|
|
|||
|
|
9、 生产环境测试：由电力行业一部组织在生产环境开展功能测试验证。
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 7 页 共 8 页
|
|||
|
|
|
|||
|
|
第七条 产品代码提交流程
|
|||
|
|
|
|||
|
|
1、 提交代码：由产品研发项目组对准备提交云效的代码、依赖包、静态资源（需同步输出到指定
|
|||
|
|
目录）进行测试验证。此过程需要本地编译构建成功，通过测试及交付中心的产品联调测试和
|
|||
|
|
自动化测试。
|
|||
|
|
|
|||
|
|
产品静态资源路径：
|
|||
|
|
\\10.50.9.101\server\modular whgz\dap9.0.0master_sp\fmp_resource\finalZipFile
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|
|||
|
|
远光软件股份有限公司
|
|||
|
|
|
|||
|
|
关于云效代码提交管理指南
|
|||
|
|
|
|||
|
|
文件编号
|
|||
|
|
发布日期
|
|||
|
|
|
|||
|
|
现行版本
|
|||
|
|
页 次
|
|||
|
|
|
|||
|
|
YG-CMMI-CM-GD04
|
|||
|
|
2023-06-30
|
|||
|
|
|
|||
|
|
V1.1
|
|||
|
|
第 8 页 共 8 页
|
|||
|
|
|
|||
|
|
2、 编译构建：由配置组根据项目组提交的代码，进行纯环境编译，确认获取依赖包（二方包、三
|
|||
|
|
方包）。如果选择增量更新，由发起者提供当前变更二方包列表、三方包列表、静态资源列表，
|
|||
|
|
如果选择全量更新，则无需提供。
|
|||
|
|
|
|||
|
|
3、 获取镜像所需依赖文件：由技术支持中心按部署环境提供 dockerfile、配置文件和基础镜像等依
|
|||
|
|
|
|||
|
|
赖文件给配置组。
|
|||
|
|
|
|||
|
|
4、 云效提交：由配置组根据获取的依赖包，清除云效 maven 库相关二方包，提交更新二方包、三
|
|||
|
|
|
|||
|
|
方包、静态资源和代码并通过云效编译。
|
|||
|
|
|
|||
|
|
5、 生成并推送镜像：由配置组云效编译并获取镜像依赖文件打包，输出镜像，并将生成的镜像推
|
|||
|
|
|
|||
|
|
送云效镜像库。
|
|||
|
|
|
|||
|
|
6、 仿真环境镜像部署：由技术支持中心组织在仿真环境进行镜像部署。
|
|||
|
|
|
|||
|
|
7、 仿真环境测试：由电力行业一部组织在仿真环境开展功能测试验证。
|
|||
|
|
|
|||
|
|
8、 生产环境镜像部署：由技术支持中心负责将镜像部署到生产环境，并在生产环境进行镜像部署。
|
|||
|
|
|
|||
|
|
9、 生产环境测试：由电力行业一部组织在生产环境开展功能测试验证。
|
|||
|
|
|
|||
|
|
第三章 其他
|
|||
|
|
|
|||
|
|
第八条 依赖包白名单
|
|||
|
|
|
|||
|
|
项目组提交云效的代码，编译所需依赖包，必须在配置组提供的依赖包白名单中，并通过 maven 编
|
|||
|
|
|
|||
|
|
译。
|
|||
|
|
|
|||
|
|
第九条 安全代码扫描
|
|||
|
|
|
|||
|
|
按生产环境更新要求，研发项目组提交云效的代码需通过安全实验室相关工具的安全扫描。
|
|||
|
|
|
|||
|
|
第四章 附则
|
|||
|
|
|
|||
|
|
第十条 本指南由 DAP 研发中心负责修订、解释
|
|||
|
|
|
|||
|
|
商密【中】
|
|||
|
|
|