JIRA实践系列-JIRA与阿里云效对接指南

妖狐艹你老母 2022-09-04 03:54 275阅读 0赞

> JIRA实践系列-JIRA与阿里云效对接指南，拧出部分重点关联接口，便于快速上手。

## 一、API对照关系 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">api名称</th> 
   <th align="left">云效</th> 
   <th align="left">JIRA</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">创建项目</td> 
   <td align="left">CreateDevopsProject</td> 
   <td align="left">/rest/api/2/project</td> 
  </tr> 
  <tr> 
   <td align="left">更新项目</td> 
   <td align="left">UpdateDevopsProject</td> 
   <td align="left">/rest/api/2/project/{projectIdOrKey}</td> 
  </tr> 
  <tr> 
   <td align="left">获取项目</td> 
   <td align="left">GetDevopsProjectInfo</td> 
   <td align="left">/rest/api/2/project/{projectIdOrKey}</td> 
  </tr> 
  <tr> 
   <td align="left">创建任务</td> 
   <td align="left">CreateDevopsProjectTask</td> 
   <td align="left">/rest/api/2/issue</td> 
  </tr> 
  <tr> 
   <td align="left">更新任务</td> 
   <td align="left">UpdateTaskDetail</td> 
   <td align="left">/rest/api/2/issue/{issueIdOrKey}</td> 
  </tr> 
  <tr> 
   <td align="left">添加附件</td> 
   <td align="left"></td> 
   <td align="left">/rest/api/2/issue/{issueIdOrKey}/attachments</td> 
  </tr> 
  <tr> 
   <td align="left">任务查询</td> 
   <td align="left">GetTaskDetailBase</td> 
   <td align="left">/rest/api/2/issue/{issueIdOrKey}</td> 
  </tr> 
 </tbody> 
</table>

## 一、云效API文档1 ##

[协作平台 Project API - 项目、任务、迭代等][Project API -]

### 云效-SDK ###

<dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-devops-rdc</artifactId>
        <version>1.0.8</version>
    </dependency>

### 云效-项目相关API ###

*  创建项目 CreateDevopsProject
 *  更新项目 UpdateDevopsProject
 *  获取项目项列表 GetProjectOption
 *  添加项目成员 InsertProjectMembers

### 云效-任务相关API ###

*  创建任务 CreateDevopsProjectTask
 *  更新任务 UpdateTaskDetail
 *  获取任务详情 GetTaskDetailBase

## 二、JIRA API文档2 ##

JIRA API文档3 : [JIRA API文档][JIRA API]

更详细介绍参考：[JIRA REST API调用方式][JIRA REST API]

## 三、两者初略对比 ##

阿里云效提供的api内容不太全，相对粗糙一点，比如附件相关的并没有说明；JIRA这方面则做的比较细致，均提供完整的指导说明。

总体感受即：

*  JIRA流程很规范，第一眼看很复杂，第一眼看德国大众的JIRA系统时，要懵掉，一个小表格，竟然容纳了那么多的按钮。
 *  云效流程简洁，用起来很简单，符合咱的使用习惯。各有千秋。但是对开发者来说，云效并不友好，从其sdk可知，已经换了n多个，各版本间有点割裂的感觉。

--------------------

1.  [协作平台 Project API - 项目、任务、迭代等 ][Project API -] ↩︎
2.  [JIRA REST API调用方式 ][JIRA REST API] ↩︎
3.  [JIRA API文档][JIRA API] ↩︎

[Project API -]: https://help.aliyun.com/document_detail/180891.html?spm=a2c4g.11186623.6.1242.13c0439aT9nDXN
[JIRA API]: https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-projects/#api-rest-api-2-project-projectidorkey-get
[JIRA REST API]: https://blog.csdn.net/loongshawn/article/details/83029612