集成 Jira Software 和 Bitbucket 前后应该了解的6件事

咖啡和甜甜圈、Jira Software Server 和 Bitbucket Server 有什么共同之处？这两样东西放一起可以带来出色的体验，甚至可以说，两样东西少了哪一样都会令人觉得遗憾。在 Atlassian ，我们对咖啡和甜甜圈了解的十分透彻......我是说，Jira Software 和 Bitbucket ，因为我们每天都把它们俩放在一起配合使用，解决我们工作流程中繁忙的任务。

使用这两种工具的团队应该将这两者整合起来使用（过程非常简单）。这样做，可以为你带来一套强大的功能，方便了管理员和最终用户。除了我们文档中提供的详细资料外，还需要了解一些更高层面的事情，以便充分利用这两者的集成。

集成之前 - 需要了解的事情

1. 即使您有多个 Jira Software Server 实例，也可以使用 Bitbucket Server 或 Data Center 单个实例为整个组织提供支持。 

Bitbucket Server 或 Data Center 具有高度的可扩展性，可以一次性与多个 Jira Software 实例本地集成。您的团队可以了解 Bitbucket ，并采用通用的版本控制实践，而不会有需要同时整合项目管理工具的压力。

实例应该使用独特的项目名称。如果不小心在两个实例中有两个项目使用了相同的名称，Bitbucket 会将集成标记为“ PRIMARY ”。

2. 权限就是权限。

Jira Software 和 Bitbucket 不但在数据架构方面采用了类似的方式，而且在安全执行方面也是如此，更易于维护，并让管理员安心。例如，假设您在 Jira Software 制定了权限方案，禁止特定用户转换某些问题。而这些用户可以访问 Bitbucket （因为集成的原因，这里也可以转换问题），但是您并没有在这里设置等效的权限方案。

不用担心。Jira Software 和 Bitbucket 尊重彼此的权限设定。在此情况下，这些用户将被阻止通过 Bitbucket 转换这些问题。同样，如果 Jira Software 用户没有获得授权访问 Bitbucket 实例，那么他们也无法查看 Jira Software 内部链接的 Git 提交、分支或拉请求。

3. 问题关键字 + 分支 + 提交 = 可追溯性和可见性

问题关键字实际上是将 Jira 和 Bitbucket 作为一个集成对使用的关键。在分支名称中包含相关的问题关键字（例如“ feature-DEV-12345 ”）和提交信息，在这两者之间创建了一个双向链接。因此，当您在 Jira Software 中查看问题时，可以看到与该问题关键字相关联的所有提交和分支，反之，在 Bitbucket 中也是这样。

使用问题分支模式是将其并入工作流程最简单的方法。在每个 Jira Software 问题中，您会看到一个“创建分支”按钮（对，和您想得一样），指导您一步步在 Bitbucket 中创建分支，而问题关键字已经在分支建议名称中了。

绝对需要全面可追溯性的团队（审计，还有其它人吗？）经常使用 Git Hook ，验证提交消息和分支中是否存在问题关键字，如果没有的话，则加以拒绝。如果您对编写自定义 Git hook 不感兴趣，可以在 Atlassian Marketplace 上找到其他的。

集成之后 - 充分利用工具

Jira 和 Bitbucket 在很多细节方面都有融合，即使我们也很难一下子全部记住。为充分利用这些工具，请确保完成以下三件事情。

1. 创建适合团队的工作流程。

Bitbucket Server 和 Jira Software Server 集成后，您可以自定义分支模型、工作流触发器和 Git hook ，创建适合各个团队的工作流程，同时执行整个公司范围的权限和限制等标准。

分支模型——您可以为 Bitbucket 服务器实例指定分支类型及其命名约定。例如，您可以决定选择分支类型特性、漏洞修复、修复程序和发布版本以及默认前缀。完成设置后，无论何时您从问题创建新分支，Jira Software 都会根据问题类型和分支模型，设置预先填充的分支名称和类型。因此，如果 Jira Software 问题类型是“ bug ”，那么根据其创建的分支将默认使用 bugfix 命名约定。

工作流程触发器——当发生某个事件时，这些规则会在以下情况下自动将 Jira Software 问题从一种状态转换到另一种状态：创建拉取请求、新提交或类似事件。这意味着即使开发者正在埋头写代码，团队成员和利益相关者也总是能看到最新的状态。

合并限制和 Git 钩子——很容易配置规则，如果特定要求未得到满足，可以防止用户合并或推送代码。Bitbucket Server 附带几个规则——比如需要绿色的 CI 构建，或者所有的提交都有 GPG 签名——但是您也可以添加自己的规则。开发流程中任何自定义规则或要求都可以通过自定义合并限制、 Git 钩子甚至 webhook 来解决。让工作流程为您服务，而不是相反。

不要重复造轮子，Atlassian Marketplace 拥有超过 250 个 Bitbucket Server 插件和钩子。

2. 在最适合您角色的环境中及时更改 Jira 问题。

对于开发者来说，没有什么比正专注于手头的事情，而流程被突然打断更令人沮丧了。幸运的是，Jira-Bitbucket 集成可帮助您处理诸如查找、转换、添加注释或创建新的 Jira Software 问题等项目日常任务。

Bitbucket Server 代码库快捷方式和 Jira 问题链接——在 Bitbucket Server 中单击链接的 Jira 问题关键字，会弹出 Jira Software 问题对话框，提供所有信息并能够立即作出转换。同样，代码库快捷方式在级别提供到任何相关资产的链接，例如 Jira Software board、Confluence 空间、Bamboo 计划或任何其他对您很重要的资源。

智能提交——通过在提交信息中提供特殊命令，您可以对相关的 Jira Software 问题进行评论、转换甚至记录时间，而无需离开终端窗口。

在拉请求中创建一个 Jira 问题 ——在拉请求期间发现一些需要重构的代码？创建一个 Jira Softwrae 问题，直接从 Bitbucket 中的拉请求注释中跟踪该项任务。

3. 了解发布中心。

对于所有的产品经理、发布经理和其他利益相关者来说，Release Hub 是您的朋友。如果您的团队使用了我们到目前为止讨论过的所有提示，那么您可以确信所有的 Jira Software 问题都是最新的，并且有完整的信息。您可以在 Release Hub 看到全部信息，Release Hub 能为您提供评估发行版本状态的一站式服务。

Release Hub 提供了各发行版本所有问题的汇总。将所有这些信息集中到一个地方，Jira Software 可以帮助您评估发布版本的健康状况，并回答诸如“此版本中所有代码是否已经过审核？”  或  “此版本中是否还有任何未决拉取请求”？等问题。任何有权访问 Release Hub 的人员都可以检查正在进行的工作状态。无需构建自定义报告或举行额外的状态会议。

整合到一起

Jira Software 和 Bitbucket 可能永远不会像咖啡和甜甜圈那样令人垂涎欲滴，但是它们的结合会变得更别强大，并且帮助您的团队更快地前进。

如果您想亲自看看 Jira Software Server 和 Bitbucket Server 如何更好地协同工作，不妨现在就尝试一下 Bitbucket Server 或 Data Center 。