构建发布系统简介
开发商工作台基于Docker体系和NodeJS构建发布系统,Docker镜像版本为NodeJS Long Term Support (LTS)版(node:lts),根据NodeJS升级计划自动更新默认版本。构建流程如下所示:
构建任务的运行环境
- Linux Debain 9
- Node 14
- CNPM镜像源
项目源码规范
接入发布系统的源码需满足以下条件:
- 支持npm run build命令
- 支持默认将npm run build命令的执行结果存储在项目根路径的build目录。
项目配置
配置文件gbc.json需存储在项目根路径下,如果使用默认配置,则无需放置该文件。
outputPath
- 作用:系统默认要求npm run build命令的执行结果存储在build目录下,若build目录已被其他文件占用,可以修改配置文件gbc.json中的outputPath参数指定npm run build命令的执行结果。
- type:string
- 默认值'build'
部署发布应用
前提条件
服务侧应用发布端包含浙里办APP、治理侧应用发布类型为H5时,系统默认进行代码托管,需要开发商完成应用代码部署。
操作步骤
- 单击左侧导航栏
>发布管理。
- 根据业务需要,在左侧导航栏选择服务侧名称列表或者治理侧名称列表,本示例选择服务侧名称列表,然后在搜索区域输入应用名称,选择应用类型和状态(部署准备中),单击查询。
- 单击目标应用右侧的更多>部署发布。
单击详情应用基础信息、开发商信息或者流程信息(治理侧)。
- 在测试环境模块单击创建版本。
- 在上传代码页面,设置版本名称并上传代码,单击确认。
- 代码编译通过时,可以将应用应用提交验收。。
单击详情查看代码构建状态和时长。
- 代码检查未通过时,单击详情查看源码检测结果,请参见源码检测。
注意
目前系统仅对服务侧应用进行源码检测。
源码检测(服务侧应用)
应用为服务侧应用时,若提交的源代码已经完成源代码构建,但未通过源代码合规检测(应用状态为编译失败)时,禁止直接上线发布,需根据源代码合规检测结果进行修复,修复完成后重新部署代码。若存在某些客观原因导致源代码未通过合规检测,可以提交审批,经相关人员审批后开发商可以将应用部署代码提交给业主单位政府工作人员进行验收。
前提条件
应用为服务侧应用。
注意事项
如存在以下客观情况之一导致源代码未通过合规检测,可以提交审批发起审批流,经相关人员审批后可上线发布:
- 需要紧急上线,修复源代码不合规项次的工作在会在之后的版本迭代中完成。
- 源代码没有问题,合规检测出现误报。
- 其他合理的要求,需要忽略源代码合规检测结果。
提交审批
- 登录开发商工作台。
- 单击左侧导航栏
>发布管理。
- 在左侧导航栏选择服务侧名称列表或者治理侧名称列表,本示例选择服务侧名称列表,然后在搜索区域输入应用名称,选择应用类型和状态(部署准备中),单击查询。
- 单击目标应用右侧的更多>部署发布,在测试环境模块单击详情。
- 代码构建页面显示代码构建时长等信息,单击源码检测。
源码检测包含政务JSBridge检测和外跳链接检测,页面会给出未通过检测的具体原因。
- 对于政务JSBridge文件,开发商工作台会对未通过检测的文件进行拦截。单击未通过检测文件,显示未通过原因,您需要根据未通过原因完成代码修复后,再重新部署发布应用,否则无法将代码提交验收。
- 外跳链接检测未通过时,开发商工作台不进行拦截。单击未通过检测文件,显示未通过原因,外跳链接检测如下:
注意
外跳链接检测中以下三种外跳链接写法系统已添加白名单,予以检测通过。
location.href='https://esso.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl='+url; location.href='https://essotest.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl='+urllocation.href='http://puser.zjzwfw.gov.cn/sso/usp.do?action=zfRedirect&servicecode='+code;
- 如存在客观情况导致源代码未通过合规检测,可以单击提交审批,填写申诉理由,单击确认,经相关人员审批通过后,开发商才能将应用部署代码提交给业主单位政府工作人员进行验收。
- 提交审批后,可以单击查看审批单页面跳转至我发起的任务>申请详情页面,查看申请详情以及审审核进度。
- 审批通过后,返回应用部署页面,测试环境应用列表中应用状态变更为代码编译通过,您可以单击提交验收将应用提交给业主单位政府工作人员审核。
应用提交发布
应用代码编译通过后,可以将代码提交给业主单位政府工作人员进行审核,由业主单位政府工作人员在主工作台进行应用验收和发布审核。
操作步骤
- 登录开发商工作台。
- 单击左侧导航栏
>发布管理。
- 在左侧导航栏选择服务侧名称列表或者治理侧名称列表,本示例选择服务侧名称列表,然后在搜索区域输入应用名称,选择应用类型和状态(部署准备中),单击查询。
- 单击目标应用右侧的更多>部署发布。
- 在测试环境模块单击提交发布,单击确认,由业主单位政府工作人员在主工作台中完成应用验收和发布。
注意
提交验收后开发商工作台中应用状态为待发布审批,IRS主工作台中应用状态为待发布审批,政府工作人员可进行验收和发布或者发起重新部署流程。
后续由业主单位政府工作人员在IRS主工作台完成应用验收和提交发布审核、发布审核操作,发布审核通过后完成应用发布(开发商工作台、IRS主工作台中应用状态同时更新为已发布)。
配置完成(治理侧应用)
前提条件
- 应用为治理侧应用。
- 应用状态为配置中。
操作步骤
- 单击左侧导航栏
>发布管理。
- 单击左侧导航栏治理侧名称列表。
- 在搜索区域通过关键字快速搜索目标服务,应用状态为配置中,然后单击查询。
- 单击目标应用右侧的配置完成,将应用状态更新为已发布。