如何集成 Jira 和 Harness Drone

第 1 步：在 Jira 中创建 OAuth 凭据

要将 Harness Drone 与 Jira 项目集成，您需要创建 OAuth 凭据。请按以下步骤创建这些凭据：

1. 在 Jira 中，单击应用，然后单击管理您的应用

2. 选择创建 OAuth 凭据

3. 单击创建新凭据按钮

4. 填写以下字段：

a. 应用名称：Drone

b. 服务器基本网址：https://www.drone.io

c. 在权限下勾选部署

5. 单击创建新凭据按钮。您将获得一个新的凭据条目。

第 2 步：在 Harness Drone 中设置密钥

接下来，您需要在 Harness Drone 中配置 Jira 凭据，以便执行集成和更新工作单。

1. 登录到您的 Harness Drone 帐户，然后选择用于集成的存储库

2. 依次选择设置和密钥

3. 单击新建密钥按钮

a. 第一个密钥应采用“Jira OAuth 凭据”中的客户端 ID 值。您可以将其命名为“jira_client_id”

b. 第二个密钥需采用“Jira OAuth 凭据”中的密钥的值。您可以将其命名为“jira_client_secret”。

现在，您应该已在 Harness Drone 中定义了两个密钥。

第 3 步：将 Jira 插件添加到您的 Harness Drone 管道中

执行后，管道将更新提交消息中提及的 Jira 工作单，其中包括状态、进度以及已部署到哪个环境。为此，请按以下步骤编辑管道并添加 Jia Software 插件。

需要以下属性：

1. 名称

2. 图像 — 插件/Jira

3. client_id — 应为第 2 步中创建的密钥（以下示例中的“jira_client_id”）

4. 项目 — 应与 Jira 项目的名称相同（以下示例中的“DRONE”）。请注意，项目名称区分大小写

5. 实例 — 可以从 URL- https://xxxxxx.atlassian.net 获取的 Atlassian 帐户的子网域（本例中为“droneio”）

6. 环境 — 应为以下任一值：未映射、开发、测试、暂存或生产

将插件添加到管道后，您可以触发执行并自动更新 Jira 工作单。

第 4 步：触发 Harness Drone 管道执行

自动运行 Harness Drone 管道的常见方法是提交变更，从而触发执行。要更新工作单的状态，您需要在提交消息中提供工作单 ID。

请按以下步骤进行操作：

1. 创建要在管道执行期间更新的 Jira 工作单

2. 更改工作单代码后，在提交消息中添加工作单 ID。在以下示例中，工作单名为“Autocomplete username and password”，ID 为“DRONE-4”。

3. 管道随即应开始执行。以下示例涉及更新生产环境。

管道完成后，您应该会在 Jira 中看到状态。

第 5 步：在“Jira 部署”页面上查看工作单状态

在“Jira 部署”页面上，您应能根据 Drone 管道所更新的进度来查看工作单的状态。

如果单击显示更多信息，则可查看工作单部署的完整历史记录和状态。

第 6 步：在 Jira 看板中查看工作单状态

在 Jira 看板上，如果您打开工作单，则将在“发布”字段下看到最新的部署状态。在以下示例中，最新的部署是在生产环境中进行。

凭借与领先供应商和市场应用的集成，Atlassian 的 Open DevOps 能让您构建自己想要的 DevOps 工具链。要了解更多信息，请查阅我们的 DevOps 集成。