jira与jenkins集成是可落地的标准化实践，关键在于理清触发路径和数据流向，明确“谁触发谁、传什么、怎么用”，优先保障双向认证稳定，再按需选择代码提交或jira事件作为主触发路径，并通过rest api实现结构化状态与字段同步。
直接在 Jira 里看到构建结果、在 Jenkins 里自动关联需求、状态变更触发发布——这种联动不是理想状态，而是可落地的标准化实践。关键不在堆插件，而在理清触发路径和数据流向。
明确集成目标：不是“连上就行”，而是“谁触发谁、传什么、怎么用”
先想清楚你最想解决哪个环节：
- 开发提交代码后，自动更新 Jira 需求状态（比如从 “In Progress” → “Code Review”）
- Jira 中把需求拖到 “Ready for Test” 列，Jenkins 自动跑一轮冒烟测试
- 构建失败时，Jira 对应的需求/缺陷自动加标签、改状态、甚至创建子任务
- 发布成功后，Jira 需求状态变为 “Done”，并带链接跳转到部署记录
不同目标对应不同技术路径，别一上来就全配，容易卡在权限或 webhook 超时上。
基础连接：Jira 和 Jenkins 双向认证必须稳
这是所有联动的前提，出错率最高：
- 在 Jira 中创建 API Token（路径：头像 → Settings → Atlassian Account → API tokens → Create and copy），不要用密码
- Jenkins 端安装 Jira Plugin（非 Jira Cloud 插件，除非你用的是 Jira Cloud）；Server/Data Center 版本用原生 Jira Plugin 即可
- 配置地址时注意协议和端口：Jira Server 地址是
https://jira.example.com，不是https://jira.example.com/browse；Jenkins 管理页 → 系统配置 → Jira → 添加站点，填入 URL、用户名、API Token，点“Test Connection”确认绿色成功 - 确保 Jenkins 服务器能直连 Jira 内网地址（如果 Jira 在内网，Jenkins 也得在同一网络段或打通防火墙）
触发方式选一种主路径，避免混合混乱
推荐从“代码提交触发”起步，稳定且无需额外维护 Jira 操作习惯：
-
Git 提交消息带 Jira Key：如
git commit -m "FUSE-123 fix login timeout"，Jenkins Pipeline 自动识别并关联 - Pipeline 中用
withCredentials调 Jira REST API 更新状态，例如：sh 'curl -X PUT -H "Content-Type: application/json" \ -u "$JIRA_USER:$JIRA_TOKEN" \ -d \'{"update":{"comment":[{"add":{"body":"Build #${BUILD_NUMBER} passed."}}]}}\' \ "https://jira.example.com/rest/api/3/issue/FUSE-123" - 若需 Jira 主动触发 Jenkins（比如测试人员点一下就跑回归），用 Jira Trigger Plugin + Webhook：Jira 端创建 Webhook，URL 填
http://jenkins.example.com/jira-trigger-webhook-receiver/，事件选 Issue Updated，并在 Jenkins Job 的构建触发器中勾选 “Build when an issue is updated in JIRA”
状态与数据同步：用字段而非仅靠评论
光在 Jira 评论里写“已部署”意义有限。真正有用的是结构化同步：
- 在 Jira 中为项目添加自定义字段，如 “Latest Build ID”、“Deploy Environment”、“Last Test Result”，Jenkins Pipeline 跑完后用 REST API 写入这些字段值
- 利用 Jira 的 JQL 做聚合查询，例如：
project = FUSE AND "Last Test Result" = "FAILED" ORDER BY updated DESC，快速定位阻塞项 - Jenkins 构建日志里自动渲染 Jira 链接：
[FUSE-123](https://jira.example.com/browse/FUSE-123)，点击直达需求页
不复杂但容易忽略
