如何设置双向 Jira GitHub 集成

这是大多数组织中的常见场景：开发团队使用GitHub存储库，而服务团队使用 Jira Service Management。然而，共享信息具有挑战性，因为两个团队都位于不交叉兼容的平台上。

为了弥补差距，项目经理引入了第三方Jira GitHub 集成帮助两个团队自动共享数据。

在本指南中，我将向您展示如何在 Jira 和 GitHub 之间设置双向集成。

您什么时候需要 Jira GitHub 集成？

按照前面提到的示例场景，开发人员和客户服务团队需要 Jira GitHub 集成来共享数据并集中工作。

假设客户向服务团队提出投诉。在这种情况下，报告代理将创建一个带有描述的 Jira 问题，开发人员也可以在 GitHub 问题上看到该问题。

现在，当开发人员对问题进行更改或问题得到解决时，这些更改也将反映在 Jira 问题上。无需手动更新；无需离开各自的工作管理平台。

使用 Jira GitHub 集成的另一种情况是复制使用 GitHub 任务列表的 Epic-child 关系。当共享来自多层 Epics 的信息时，这有助于在 GitHub 上保持层次结构。

GitHub Jira 集成还有其他用例，但您必须选择正确的 iPaaS 解决方案来探索这些可能性。

如何选择合适的集成工具

在为 Jira 和 GitHub 选择任何集成工具之前，需要考虑以下一些因素。

• 灵活性和可扩展性

  集成解决方案应该能够通过使用可定制的映射或脚本引擎来适应不同的同步场景。这将帮助团队调整工作负载而不会使网络过载。

  
  

• 安全

  您需要一个能够保证安全性的集成工具，因为您要授予它对您的代码库和存储库的访问权限。因此，请始终注意基于角色的访问控制以及身份验证和加密协议。

  
  

• 去中心化

  作为安全性的一部分，您需要隔离系统架构，特别是对于跨公司协作。选择具有单租户架构的集成工具可以让您自主控制公司的同步。

  
  

• 多功能性

  Jira 和 GitHub 的集成解决方案应该能够处理不同的集成场景。无论是简单的映射还是复杂的、基于代码的集成，该工具都应该能够优雅地处理。

  
  

• 可靠性

  集成应该能够处理不断增加的负载，同时保持最大的正常运行时间。如果连接失败，集成应该能够在连接恢复时自动恢复。

  
  

• 支持和错误处理

  当发生错误时，解决方案应提供调试功能。对于高级技术问题，支持团队应该能够提供深入的故障排除和帮助。

一种满足所有这些条件的集成解决方案是Exalate — 双向集成解决方案允许 Jira 和 GitHub 之间的双向同步。

如何使用 Exalate 集成 Jira 和 GitHub

为了开始共享数据并按照您想要的方式控制连接端，您需要在 Jira（本地或云端）和 GitHub 上安装 Exalate。

第 1 步 - 在 Jira 上安装 Exalate

前往Atlassian 市场并搜索“Exalate Jira Issue Sync & More”。

单击“免费试用”按钮，然后从出现的选项中选择“云”。请注意，您还可以安装Exalate在 Jira 服务器或数据中心上，以及码头工人。

选择站点或输入站点地址。然后，单击“开始免费试用”。您将被重定向到 Jira 仪表板以确认免费试用。

瞧！您现在已在 Jira Cloud 上安装了 Exalate。

第 2 步 - 在 GitHub 上安装 Exalate

在 GitHub 市场中搜索“Exalate Two-Way Issue Sync”。

*单击“设置计划”，它将向下滚动到安装面板。单击“免费安装”。然后单击“完成订单并开始安装”。

在授权屏幕上，单击“安装”并选择要安装 Exalate 的组织。您将被重定向到 Exalate 管理控制台。将此链接保存在安全的地方。

\选择是授予 Exalate 访问所有存储库还是选择少数存储库的权限。不用担心，您以后随时可以更改访问权限。

\单击“授权 Exalate”以授予 Exalate 访问您的存储库的权限。

在注册屏幕中输入您的联系方式。点击“同意并提交”即可完成注册。 Exalate 现在会将验证电子邮件转发到您的收件箱。

转到您的收件箱并打开此验证链接。单击出现的屏幕上的“验证 Exalate 实例”。验证后，您将被重定向到 Exalate 控制台。

出现的下一个屏幕将通知您验证已成功。单击“继续”继续。

输入从 GitHub 生成的您的个人令牌。按照屏幕上的说明在“令牌”字段中生成个人访问令牌。

单击“登录”完成安装过程。繁荣！您已准备好开始建立联系。

第 3 步 - 连接您的实例

Exalate 的美妙之处在于它允许您从 Jira 或 GitHub 启动连接。两个平台上的过程相似，界面也相同。

单击“启动连接”。在指定字段中输入目标实例 URL。如果您没有 URL，请单击“我没有 URL”切换开关。

Exalate 支持 Jira GitHub 集成的两种配置模式：

基本模式（用于简单的预构建配置）和脚本模式（用于高级脚本配置）。

让我们从基本模式开始。

选择您希望传入问题所在的项目，然后单击“下一步”。

确认您具有管理员访问权限，然后单击“启动”。

您将被自动重定向到远程实例。选择一个存储库并单击

“确认”。输入问题密钥并单击“Exalate”继续。

欢呼！您已设置第一个基本连接。

现在让我们进入脚本模式。如前所述，启动连接并验证目标实例 URL。但不要选择基本模式，而是选择脚本模式。

输入连接名称和描述，然后单击“下一步”。然后选择项目并单击“启动”。

将邀请码复制到剪贴板。转到另一侧并单击“接受邀请”。

输入剪贴板中的邀请码，然后单击“下一步”。然后，选择一个存储库并确认。

恭喜！您已成功设置脚本模式连接。

第 4 步 - 配置您的连接

返回 Exalate 仪表板，转到连接，然后单击“编辑连接”图标。

在“规则”选项卡上，您将看到“传出同步”和“传入同步”的脚本引擎。这就是奇迹发生的地方。您可以使用 Groovy 语言自定义连接。

第 5 步 - 创建自动同步触发器

接下来是“触发器”选项卡。在这里，您可以查看自动同步的所有活动触发器。

要设置触发器，请单击“+ 创建触发器”按钮。

接下来，选择实体类型并输入查询。要设置 GitHub 触发器，请使用GitHub 高级搜索语法并指定存储库。 Jira 触发器使用 Jira 查询语言 (JQL)。

第 6 步 - 开始同步

设置触发器后，您现在可以开始编写用于连接 Jira 和 GitHub 实例的规则。您还可以使用控制台中的堆栈跟踪来跟踪错误。

使用简单的同步规则来了解连接的工作原理。了解基础知识后，您可以添加更多规则或编辑已有的规则。

常见的 Jira GitHub 集成场景

• 公共 Git 存储库项目：拥有公共代码的开发人员可以使用 GitHub 进行项目管理和问题跟踪。集成 Jira 和 GitHub，将项目拉入 Jira，让您可以私下监控公共讨论。从公共代码库分配问题、决定操作并将所选字段同步回 GitHub。这确保了与开源社区的协作，同时保持内部讨论的机密性。

  
  

• 客户服务和工程协作：客户服务在 Jira 中记录问题，其中一些问题需要工程人员关注。通过 Jira-GitHub 集成，相关问题会自动转移到 GitHub。一旦解决，解决方案就会在 Jira 中更新，从而使客户服务能够向客户传达修复信息。

  
  

• 产品开发和质量保证：质量团队确保产品符合全球法律标准。他们跟踪并解决法律问题，同时持续监控产品质量。通过集成，法律和质量相关问题会自动发送给 GitHub 中的开发团队。当开发人员解决问题时，质量团队会通过 Jira 自动更新。

• 
  

要点

在工作管理系统之间移动数据可能是一项艰巨的任务。但借助 Exalate 等可靠且安全的第三方解决方案，团队可以无缝共享信息。

配置与 Exalate 的连接是一个简单的过程。您可以使用无代码基本模式或基于代码的脚本模式。如果您想批量控制票证，您可以使用自定义触发器批量 Exalate。

如果您有特定的用例并想了解如何使用 Exalate 实施它， 请预订与集成工程师的免费会话并查看它的实际应用！