配置 JIRA
DevOps Insights 该服务将于 2026 年 8 月 31 日停止提供并终止。Continuous Delivery 将于 2027 年 2 月 12 日在以下区域停止提供:au-syd、ca-tor、us-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能,该区域内的相关功能可能会提前停用,并停止接受新实例。 了解更多
JIRA 是跟踪与软件相关的问题和错误的工具。 JIRA 工具集成会在 Jenkins 或 Delivery Pipeline 运行部署时,更新项目的问题。
要让 JIRA 工具集成跟踪问题,您必须在提交消息中使用 JIRA 智能提交。 如需进一步了解 JIRA Smart Commits,请参阅《 使用 Smart Commits 》。
配置 JIRA 以计划、跟踪和交付质量代码:
-
如果您在创建工具链时配置此工具集成,请在“可配置的集成”部分中,单击 JIRA。
-
若您已拥有工具链并需向其中添加此工具集成,请在控制 IBM Cloud 台中点击菜单图标 (
)> 平台自动化 > 工具链。 在“工具链”页面上,单击某个工具链以打开其“概述”页面。
a. 单击 “添加工具”。
b. 在“工具集成”部分中,单击 JIRA。
-
如果您有 JIRA 项目且想要与其进行连接,那么对于 JIRA 类型,请单击现有:
a. 输入 JIRA 项目的 JIRA 项目密钥。 您可以在 JIRA 项目的 URL 中找到项目密钥。
b. 输入 JIRA 实例的基本 API URL。 您可以从 JIRA 实例的标头中找到 API URL。 单击管理图标并单击系统。
c. 如果要连接到专用 JIRA 实例,或者要接收来自公用 JIRA 实例的可跟踪性信息,请输入 JIRA 用户名和密码。
d. 要通过创建所参考问题的标签和注释来跟踪项目的代码更改部署,请选中跟踪代码更改的部署复选框。 请确保您使用 JIRA 智能提交来参考 GitHub 提交中的 JIRA 问题。 如果您未选择此选项,那么 JIRA 工具集成将忽略任何提交。
-
如果您想要创建 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 工具集成将忽略任何提交。
-
单击创建集成。
-
在“工具链的概述”页面上的 第三方工具 卡上,单击 JIRA 以查看您连接到的 JIRA 项目的仪表板。
使用 API 配置 JIRA
JIRA工具集成支持以下配置参数,您可在 创建、读取和 更新工具集成时通过 工具链 HTTP API和SDK 使用这些参数。
必须在请求主体中使用 jira 值指定 tool_type_id 属性。
| 参数 | 用途 | 类型 | Terraform 自变量 | 描述 |
|---|---|---|---|---|
| API_URL | 必需,可更新 | 字符串 | API_URL | 您 JIRA 实例的基础 API:URL。 |
| enable_traceability | 可选的,可更新的,Default: false |
布尔值 | enable_traceability | 通过在提交、拉取请求和相关问题上创建标签、标记和评论,来跟踪代码变更的部署情况。 |
| 密码 | 可选,可更新 | 密码 | API令牌 | JIRA 帐户的 API 令牌。 对于公共项目是可选的。 您可以将工具链私钥引用用于此参数。 有关更多信息,请参阅 在 Continuous Delivery中保护敏感数据。 |
| 项目键 | 必需,可更新 | 字符串 | 项目键 | JIRA 项目的项目键。 |
| 用户名 | 可选,可更新 | 字符串 | 用户名 | JIRA 帐户的用户名。 对于公共项目是可选的。 |