pingcode logo
功能日记

App上架:Bitbucket


PingCode应用市场迎来新成员Bitbucket App。

Bitbucket 是一款基于 Git 的代码托管与协作工具,提供Cloud、Server和数据中心三种托管方式。而Bitbucket App是由PingCode官方开发的一款工具,它可以将Bitbucket的Commit、Branch、Pull Request关联到PingCode的工作项中。

Bitbucket App的使用效果是这样的:

使用效果

1)在PingCode的工作项中查看关联的开发数据:

2)在PingCode的工作项中查看关联的Branch:

3)在PingCode的工作项中查看关联的Commit:

4)在PingCode的工作项中查看关联的Pull Request:

下面我们就来看一下如何配置Bitbucket App。

配置过程

首先,进入PingCode的“后台管理”->“凭据管理”页面。

新建应用:

  1. 应用名称:Bitbucket App
  2. 鉴权方式:Client Credentials
  3. 权限:开发(读写)

在列表中拷贝ClientId和Secret备用。

然后,进入PingCode的“应用市场”->“全部应用”->“Bitbucket”,点击“查看”。

添加 Webhook:

  1. 名称:PingCode
  2. Client ID:刚才拷贝的ClientId
  3. Client Secret:刚才拷贝的Secret

在列表中拷贝URL备用。

最后,进入Bitbucket的`Repository settings` > WebHooks页面,Add webhook。

  1. URL:刚才拷贝的URL
  2. 选择事件:勾选Repository.PushPull Request.CreatedPull Request.ApprovedPull Request.MergedPull Request.Declined

点击新建即可。

使用方式

配置完成后,只需在相关代码仓库的分支名中提及PingCode工作项编号,即可让该Branch和提及的工作项关联。(工作项编号在工作项弹框的左上角,如本文的图1)

例如分支名为:sunjingyun/#PLM-110/#PLM-111,那么这个Branch将自动和#PLM-110、#PLM-111这两个工作项进行关联。

同样的,向代码仓库推送Commit时,在message里提及工作项编号,即可让该Commit和提及的工作项关联。

例如message为:feat(scope): #PLM-112 #PLM-113 add some features,那么这个Commit将自动#PLM-112、#PLM-113这两个工作项进行关联。

如果Branch已经和工作项关联,那么向这个Branch推送的所有Commit将自动和这个工作项关联。

同样的,向代码仓库创建Pull Request时,如果源分支已经和工作项关联,或者title中提及了工作项,那么Pull Request将自动与工作项关联。

例如:Add features #PLM-114 #PLM-115,那么这个Pull Request将自动和#PLM-114、#PLM-115这两个工作项进行关联。

赶快来配置Bitbucket App,把开发数据显示到PingCode中吧。