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的“后台管理”->“凭据管理”页面。
新建应用:
- 应用名称:
Bitbucket App
- 鉴权方式:
Client Credentials
- 权限:
开发
(读写)
在列表中拷贝ClientId和Secret备用。
然后,进入PingCode的“应用市场”->“全部应用”->“Bitbucket”,点击“查看”。
添加 Webhook:
- 名称:
PingCode
- Client ID:
刚才拷贝的ClientId
- Client Secret:
刚才拷贝的Secret
在列表中拷贝URL备用。
最后,进入Bitbucket的`Repository settings` > WebHooks
页面,Add webhook。
- URL:
刚才拷贝的URL
- 选择事件:勾选
Repository.Push
、Pull Request.Created
、Pull Request.Approved
、Pull Request.Merged
和Pull 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中吧。