Jenkins Integration for Jira
Welcome to the Jenkins Integration for Jira documentation!
Background
This project finds its roots in the JIRA Hudson Integration project. That project was plagued by issues effecting large to very large deployments of, at the time, Hudson and now Jenkins. That implementation took a real time approach to showing build data in Jira. However, the larges a Jenkins instance became, the slower the integration became to the point where both Jira and Jenkins would stop performing.
The new implementation is taking a caching approach to showing build data in Jira, this approach greatly simplifies the Jenkins add-on and improves the performance impact of running the integration on both Jira and Jenkins.
Getting Started
Getting started is easy, it’s a simple 4-step process that is highlighted in the Quick Start Guide.
TL;DR: 1 install Jira app, 2 install Jenkins plug-in, 3 Configure Jenkins Site in Jira, 4 Enjoin Insight.
Jenkins builds are linked to Jira issues if a key of an existing Jira issue can be found in the job and build data that was synchronized.
The following elements are inspected to extract Jira issue keys:
- Job display name
- Job description
- Job url
- Build display name
- Build description
- Build trigger cause
- Change-set commit messages
- Git branch names
Any potential issue key located will be verified to exist, and a link between the build is issue is only created if the issue exists in Jira.