iris操作手册
版本时间更新内容提交人
V0.12019-05-09初稿编写辛鹏辉
V0.22019-07-11修改完善辛鹏辉
V0.32019-07-12增加系统访问地址辛鹏辉
V0.42019-08-06修改bundle入驻截图及文字辛鹏辉
目录
感谢您选用《iris无线持续交付平台》,本平台为解决无线链路研发周期内的集成、测试、发布问题,为用户提供高效的交付平台,提高产出效率。
任何意见及建议,欢迎您随时提出。
iris系统访问地址:
iStore系统访问地址:
https://istore.fat.qa.pab.com.cn/ 请连接PAB-WDT网络接入
详细介绍了该系统的操作规程,对于熟悉计算机一般操作的人员来说,阅读本手册应能掌握该系统的使用方法
本手册是为使用iris系统的业务团队、运营运维人员编写。使用者应具备基本的计算机操作知识。在使用该系统之前,应该首先阅读本手册,以避免误操作。
本系统建议运行在Chrome下,在其他浏览器下页面可能略有不同,本手册以Chrome为基准进行示例。
1系统概述
1.1系统开发背景
银行系统下有许多业务团队,各团队或多或少都和App有所交集,有依赖App的,有服务App的,有开发App的,虽然职责不同,但都在无线研发链路中砥砺前行。我们期望通过iris平台能够为更多的无线研发团队解决研发生命周期中场景效率问题,帮助团队提升研发效率。
1.2系统功能简介
Iris无线持续交付平台涵盖iOS构建发布、Android构建发布、Hybrid构建发布、iStore、运营后台、质量管理体系、APM、iris-benchmark,平台覆盖App构建发布、Hybrid构建发布、质量管理、APM、App验证平台、行业标准比照平台,运用这些能力为无线研发赋能。
1.3名词解释
手机软件。指安装在智能手机上的软件,为用户提供丰富的体验。
如:平安口袋银行、一卡通、口袋银行家、车E通、汽融助手、口袋易贷、个贷处理等。
相对独立的业务或功能模块。如:RN、H5。
1.3.3版本
App对外部展示的Version。
1.3.4发布计划
针对某个App版本创建的一整套发布流程集。
1.3.5发布单
针对某个发布计划建立一个具体的发布流程清单。一个发布计划可以包含多个发布单。
1.3.6堡垒包
发布生产包之前的小范围验证生产包。
1.4工作流程综述
Hybrid发布流程图如下:
Native发布流程图如下:
1.5系统要求
系统为B/S模式,开发基于Chrome核心,支持Chrome浏览器查看,其他浏览器可能会存在一些不可知的问题。
2系统权限
2.1权限设计
系统涉及了众多App,各个团队的情况不甚相同,使用的场景不同。因此,需要针对不同的App以及用户赋予不同的权限。确保系统用户的场景准确性以及权限正确性。采用最小化授权方式,控制风险。
2.2权限图
MCD权限表
用户角色应用接入发布用户权限质量管理体系APM监控运营后台
应用接入修改接入信息创建版本创建发布计划SIT发布UAT发布UAT测试验证结果上报生产发布全局用户权限修改项目内用户权限修改自动化测试测试信息收集UAT测试控制日志监控&分析数据监控用户反馈数据报表配置平台
超级管理员√√╳╳╳╳╳╳√√╳╳╳╳╳╳╳╳
项目经理╳√╳╳╳╳╳╳╳√╳√╳√√√√╳
版本经理╳╳√√√√╳√╳╳╳√╳√√√√√
测试人员╳╳╳╳√√√╳╳╳√√√√√√√╳
项目组成员╳╳╳╳╳╳╳╳╳╳╳√╳√√√╳╳
运营人员╳╳╳╳╳╳╳╳╳╳╳╳╳√╳√√╳
其他临时用户╳╳╳╳╳╳╳╳╳╳╳╳╳√╳╳╳╳
3系统操作
3.1App接入
3.1.1申请接入(前期)
在初期,App的接入由我们团队来负责,请接入方按照如下内容提供App信息,发送给孔令迁,抄送李志伟、辛鹏辉、陈旭伟。
我们在收到对应信息后将会尽快予以录入,完成后会邮件通知业务方。格式如下:
-------------------------------------------------------邮件示例----------------------------------------------------------
收件人:孔令迁KONGLINGQIAN026@pingan.com.cn
抄送:李志伟(金服银行科技中心) <LIZHIWEI077@pingan.com.cn>; 辛鹏辉<xinpenghui973@pingan.com.cn>; 陈旭伟(金服银行科技中心)CHENXUWEI741@pingan.com.cn
主题:【iris入驻申请】xx团队xxApp申请入驻iris交付平台申请
正文:
xx团队xxApp申请入驻iris交付平台申请
App名称Xxxx
App
icon
商店图标,大小不超过1Mb
部门信息Xxx
App资源配置IDXxx
平台类型iOS&Android或单个平台,需描述清楚
iOS:AppIdAppstore的ID
iOS:发布帐号发布生产的帐号及登录交换token
iOS:代码地址Git@开头的代码仓地址
iOS:版本经理发布iOS的版本经理
iOS:项目经理负责该项目的负责人,同时进行bundle管理接入
Android:代码地址Git@开头的代码仓地址
Android:版本经理发布iOS的版本经理
Android:项目经理负责该项目的负责人,同时进行bundle管理接入
Android:测试人员负责质量保证的人员
XX团队iris业务对接联系人:xxx 邮箱:xxx@pingan.com.cn电话:13900000000
----------------------------------------------------------示例完毕----------------------------------------------------------
3.1.2自行接入(后期)
参考如下数据内容
App名称Xxxx
App
icon
商店图标,大小不超过1Mb
部门信息Xxx
App资源配置IDXxx
平台类型iOS&Android或单个平台,需描述清楚
iOS:AppIdAppstore的ID
iOS:发布帐号发布生产的帐号及登录交换token
iOS:代码地址Git@开头的代码仓地址
iOS:版本经理发布iOS的版本经理
iOS:项目经理负责该项目的负责人,同时进行bundle管理接入
Android:代码地址Git@开头的代码仓地址
Android:版本经理发布iOS的版本经理
Android:项目经理负责该项目的负责人,同时进行bundle管理接入
Android:测试人员负责质量保证的人员
登入系统,点击【App列表】,点击右侧【添加App】,进入如下页面:
按照表格内信息对应填写,完成入驻,完成示例如下:
当我们完成App入驻后,该App的项目经理就可以进行bundle的管理工作。
点击【App列表】进入App接入列表,在对应App行中的bundle列中点击【管理】进入bundle管理列表,该App的项目经理可以点击右上角【添加bundle】进行bundle的增加。
操作如下:
点击右上角【添加bundle】进入如下页面:
在此页面录入bundle信息,根据工程属性进行类型选择,目前大多数的为非Poppy的非源码方式构建。
3.3App构建发布
3.3.1Android构建发布
3.3.1.1Android构建配置
版本经理进入【App列表】页面,在对应App的Andriod平台点击【操作】,在弹出框内选择【构建配置】,配置构建脚本目录以及输出包目录。
3.3.1.2新建版本
版本经理用户进入【App列表】页面,在对应App的Andriod平台点击【操作】,在弹出框内选择【+】增加版本
3.3.1.3新建发布计划
版本经理用户进入【App列表】页面,在对应App的Andriod平台点击【操作】,在弹出框内选择【去发布】创建发布计划
点击【去发布】后的页面如下:
3.3.1.4新建发布单
点击发布计划页面内左侧【新建发布单】,建立新的发布单,在弹出框内输入代码分支和版本名称。
新建发布单后页面如下:
3.3.1.5发布sit
在新建的发布单内进行sit发布,点击【SIT发布】,我们可以看到进度条的变化,待构建完成后可以看到对应的二维码,用手机扫码可以直达iStore下载页面。
流程同SIT发布
当测试人员对UAT包进行验证,确认本次发布单中的UAT验证通过,同意进入生产发布。此时测试人员可以上传UAT测试结果,点击页面内UAT测试列下的【操作】,出现如下页面:
测试人员上传相应的测试报告,对UAT情况予以说明结果。
通过的情况下,页面如下:
在UAT通过后,版本经理方可进行PROD的发布,此时页面如下:
此时你可以点击【生产发布】,这时将会进行生产堡垒包的构建,构建完毕后页面如下:
此时构建出的包为预发布的堡垒验证包,为了确保生产发布的包是正确的,建议此时进行堡垒包验证,验证完毕后点击【预发包验证】提交验证结果。
验证完毕后,进行申请发布状态,如下所示:
点击【申请发布】,此时会通过邮件向项目负责人发出发布申请,请联系对应的负责人进行邮件审批,审批通过后点击【上传审批结果】将审批结果或邮件上传。
审批结果上传确认后,点击【上传RMS】将对应的apk上传到rms备用,Andriod发布完成。
3.3.2iOS构建发布
3.3.2.1iOS证书管理
版本经理用户进入【App列表】页面,在对应App的iOS平台点击【操作】,在弹出框内选择【证书管理】,进入证书列表页面,可以查看到对应的已安装证书。
点击右上角【添加证书】进入添加页面,按照提示上传对应的文件即可,成功后返回前一页面进行安装。
3.3.2.2iOS构建配置
版本经理用户进入【App列表】页面,在对应App的iOS平台点击【操作】,在弹出框内选择【构建管理】,进行构建
3.3.2.3新建版本
版本经理用户进入【App列表】页面,在对应App的iOS平台点击【操作】,在弹出框内选择【+】增加版本
3.3.2.4新建发布计划
版本经理用户进入【发布】或【首页】页面,在对应iOS图标上点击【新建发布计划】,选择App,选择对应的版本,点击【确定】创建发布计划。
3.3.2.5新建发布单
点击发布计划页面内左侧【新建发布单】,建立新的发布单,在弹出框内输入代码分支和版本名称。
新建发布单后页面如下:
3.3.2.6发布sit
在新建的发布单内进行sit发布,点击【SIT发布】,我们可以看到进度条的变化,待构建完成后可以看到对应的二维码,用手机扫码可以直达iStore下载页面。
流程同SIT发布
当测试人员对UAT包进行验证,确认本次发布单中的UAT验证通过,同意进入生产发布。此时测试人员可以上传UAT测试结果,点击页面内UAT测试列下的【操作】,出现如下页面:
测试人员上传相应的测试报告,对UAT情况予以说明结果。
通过的情况下,页面如下:
在UAT通过后,版本经理方可进行PROD的发布,此时页面如下:
此时你可以点击【生产发布】,这时将会进行生产堡垒包的构建,构建完毕后页面如下:
此时构建出的包为提交到appstoreconnect的testflight包,为了确保生产发布的包是正确的,建议此时进行testflight验证,验证完毕后点击【预发包验证】提交验证结果。
验证完毕后,进行申请发布状态,如下所示:
点击【申请发布】,此时会通过邮件向项目负责人发出发布申请,请联系对应的负责人进行邮件审批,审批通过后点击【上传审批结果】将审批结果或邮件上传。
审批结果上传确认后,点击【通知提审】将邮件发给相关人员进行提审。
3.4bundle构建发布
3.4.1创建发布计划
进入【首页】或【发布】页面,点击Hybrid图标中的【新建计划】,弹出如下新建bundle发布计划框,选择对应的App以及bundle,点击【确定】创建新的发布计划。
3.4.2新建发布单
在发布计划页面点击左侧【新建发布单】,在弹出框内选择正确的支持版本和分支,同时可以进行增量或全量发布的选择。
3.4.3SIT发布
在新建的发布单内,可以进行SIT环境的发布,点击【sit发布】构建发布SIT包。
3.4.4UAT发布
同SIT发布,点击【UAT发布】构建发布UAT包。
3.4.5UAT测试
测试人员对UAT包进行验证测试,验证完成后点击【操作】上传验证结果。
验证通过后页面如下:
在UAT验证通过后,可以进行申请发布。申请发出后请及时联系审核人邮件审批,之后进入系统如下页面:
点击【上传审批结果】,上传发布申请结果。
同意发布后可点击【生产发布】,对外正式发布插件。
3.5运营平台
3.5.1配置中心
4故障排查
4.1bundle管理问题
4.1.1添加bundle
添加内容失败时请先检查对应的数据信息是否准确,若确认准确无误,请联系iris团队寻求帮助。
4.1.2bundle代码仓地址
代码仓地址请使用git@开头的地址信息予以录入。
4.2App管理问题
4.2.1修改App接入信息
App接入信息内的App资源配置ID以及平台类型不可修改,其他信息若修改失败时请先检查对应的数据信息是否准确,若确认准确无误,请联系iris团队寻求帮助。并提供对应的页面截图。
该ID关联testflight地址,请务必确认数据的准确性,否则可能影响你的testflight验证。
4.3App构建问题
若构建失败,在如下页面点击时钟小图标,可以进入日志页面查看对应的日志信息,以便排查失败原因,若有iris系统故障问题,请联系iris团队寻求帮助。
4.4bundle构建问题
若构建失败,在如下页面点击时钟小图标,可以进入日志页面查看对应的日志信息,以便排查失败原因,若有iris系统故障问题,请联系iris团队寻求帮助。
5帮助与支持
5.1联系方式
业务对接:
孔令迁 <KONGLINGQIAN026@pingan.com.cn>; 辛鹏辉
技术支持:
李志伟(金服银行科技中心) <LIZHIWEI077@pingan.com.cn>; 杨立浩(金服银行科技中心)
5.2技术支持
工作日内随时支持各接入团队的技术咨询,版本发布时建议提前联系iris团队同步留守支持。
网友评论