IBM Cloud Docs
配置 JIRA

配置 JIRA

JIRA 是跟踪与软件相关的问题和错误的工具。 JIRA 工具集成会在 Jenkins 或 Delivery Pipeline 运行部署时，更新项目的问题。

要让 JIRA 工具集成跟踪问题，您必须在提交消息中使用 JIRA 智能提交。 要了解有关 JIRA 智能提交的更多信息，请参阅 使用智能提交。

配置 JIRA 以计划、跟踪和交付质量代码：

  1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 JIRA。

  2. 如果您有一个工具链并要将此工具集成添加到其中，请从IBM Cloud控制台单击菜单图标汉堡包图标>平台自动化>工具链。 在“工具链”页面，单击工具链打开其“概述”页面。 或者，在应用程序“概述”页面的“持续交付”卡上，单击查看工具链。 然后，单击概述。

    a. 单击添加工具。

    b. 在“工具集成”部分中，单击 JIRA。

  3. 如果您有 JIRA 项目且想要与其进行连接，那么对于 JIRA 类型，请单击现有：

    a. 输入 JIRA 项目的 JIRA 项目密钥。 您可以在 JIRA 项目的 URL 中找到项目密钥。

    b. 输入 JIRA 实例的基本 API URL。 您可以从 JIRA 实例的标头中找到 API URL。 单击管理图标并单击系统。

    c. 如果要连接到专用 JIRA 实例，或者要接收来自公用 JIRA 实例的可跟踪性信息，请输入 JIRA 用户名和密码。

    d. 要通过创建所参考问题的标签和注释来跟踪项目的代码更改部署，请选中跟踪代码更改的部署复选框。 请确保您使用 JIRA 智能提交来参考 GitHub 提交中的 JIRA 问题。 如果您未选择此选项，那么 JIRA 工具集成将忽略任何提交。

  4. 如果您想要创建 JIRA 项目，那么对于 JIRA 类型，请单击新建：

    a. 输入要用于新项目的 JIRA 项目密钥。 此密钥用作项目 URL 中的唯一标识。

    b. 输入 JIRA 项目的名称。

    c. 输入 JIRA 实例的基本 API URL。 您可以从 JIRA 实例的标头中找到 API URL。 单击管理图标并单击系统。

    d. 输入要用于此项目的 JIRA 项目主管的用户名。 要将某人指定为 JIRA 项目主管，该人员必须在 JIRA 中具有项目主管许可权。

    e. 输入此 JIRA 实例的管理员用户名。

    f. 输入此 JIRA 实例的管理员密码。

    （例如， 要通过创建所参考问题的标签和注释来跟踪项目的代码更改部署，请选中跟踪代码更改的部署复选框。 请确保您使用 JIRA 智能提交来参考 GitHub 提交中的 JIRA 问题。 如果您未选择此选项，那么 JIRA 工具集成将忽略任何提交。

  5. 单击创建集成。

  6. 在“工具链的概述”页面上的 第三方工具 卡上，单击 JIRA 以查看您连接到的 JIRA 项目的仪表板。

使用 API 配置 JIRA

JIRA 工具集成支持以下配置参数，当您 创建，读取和 更新 工具集成时，可以将这些参数与 工具链 HTTP API 和 SDK 配合使用。

必须在请求主体中使用 jira 值指定 tool_type_id 属性。

JIRA 工具集成参数
参数 用途 Type Terraform 自变量 描述
API_URL 必需，可更新 字符串 API_URL JIRA 实例的基础 API URL。
enable_traceability 可选、可更新、"Default: false 布尔值 enable_traceability 通过在提交、拉取请求和引用问题上创建标签、标记和注释，跟踪代码更改的部署情况。
密码 可选，可更新 密码 api_token JIRA 帐户的 API 令牌。 对于公共项目是可选的。 您可以将工具链私钥引用用于此参数。 有关更多信息，请参阅 在 Continuous Delivery中保护敏感数据。
项目键 必需，可更新 字符串 项目键 JIRA 项目的项目键。
用户名 可选，可更新 字符串 用户名 JIRA 帐户的用户名。 对于公共项目是可选的。