3DevOps平台第三方服务集成示例

Gitlab集成

DevOps平台集成Gitlab过程大体可以分为以上3个步骤,先要做的是了解Gitlabapi接口,看一下身份认证方式是通过token还是session等,Gitlab的接口有很多我们是不需要的,此时我们就需要看DevOps模板需要哪些,不需要哪些,将需要的接口整理出来,并研究它们的QueryParamBody的格式,验证接口是否可以正确调通,接口通了,我们得到了需要的数据,但是数据格式跟DevOps的模板不符,我们就要进行最后一步,将所得数据映射到DevOps模板就大功告成了。

1)研究GitlabAPI接口

GitlabAPI接口我们可以直接从官网的相关文档查阅,按照官方的说明,自GitLab 9.0起,API V4是首选使用的版本。2017822日发布的GitLab 9.5不支持API V3。在GitLab 11.0中删除了API v3,就是说11版本起Gitlab不再支持v3版本的api,所以我们在集成Gitlab的时候就要考虑集成两个版本的API

2)筛选DevOps平台所需的接口

DevOps平台集成Gitlab仅需要应用到Gitlab的部分接口,如代码库的增删改查,分支、标签的增删改查等,过滤去无用的接口,并以查询分支接口举例。

可见,该请求的身份认证方式是通过token实现的,返回的数据格式如图显示:

DevOps代码分支模板如下图展示,所以要再做一次映射:

3)将返回数据填入DevOps模板并展示

此为集成成功后的Gitlab代码库在DevOps平台中的展示界面,用户可以在此查看代码库的文件内容,分支、标签信息,也可以对比不同分支或标签的差异:

Zentao集成

因为Zentao的接口设计比较特殊,在使用它的api接口来实现集成时遇到了种种问题,故改用了直接操作Zentao数据库来实现服务集成的方法。大体步骤是先研究Zentao的表结构,然后与DevOps相应表做对照,然后做DevOps服务端多数据源实现,直接从Zentao数据库读取数据,映射到DevOps的模板并展示给用户。

1)研究Zentao表结构&将Zentao表数据映射至DevOps模板

Zentaozt_story表举例,如图是禅道的需求表结构:

下图是DevOps工作项模板:

要想在DevOps平台中展示Zentao的需求信息,还要做一次数据映射,集成时,需要先设计DevOps平台的服务端多数据源实现,就是定义一个ZentaoDao实现,同时,Zentao的数据库需要用户来配置,解决方案1:用户可以在配置文件中配置Zentao的数据库地址以及账号密码;解决方案2:用户可以在服务集成处配置Zentao的数据库信息;两种方式的Dao层实现也是有差异的。下面展示方案1ZentaoDao部分实现:

2)数据展示

成功集成后的任务模块展示如图,用户可以在该界面进行任务、需求、bug的增删改查