Since QuickBuild 10, a two-way solution is provided to integrate with Atlassian JIRA Cloud. The integration features:
- Hyperlink the JIRA keys in commit messages to corresponding JIRA Cloud pages
- Generate an issues report from commit messages
- Create an issue to JIRA based on a customized step condition
- View SCM changes for each issue
- View related builds for each issue
- View related builds for each project
To collect the issues information, you need first add JIRA Cloud tracker setting in QuickBuild. The tracker setting can be defined from Configuration settings -> Issue Tracker -> JIRA Cloud:
Then, fill in the required information:
The token can be generated from: https://id.atlassian.com/manage/api-tokens
See more about API token at the following page:
After doing these, the issues keys mentioned in commit messages will be hyperlinked:
and an issues report tab will be displayed in Build tab:
You can also create a issue based on build status or any conditions you want by adding a Create Issue Step just like any other steps in configuration workflow.
The only thing we want to mention here is that if you have some custom fields which are required when creating issue, you need specify them in Extra Attributes:
The format for extra attributes is JSON, for example:
To view project builds, issue related builds or issue related changes in Jira Cloud. First, we need add mappings for Jira Project and QuickBuild configurations.
Go to QuickBuild administration page, and then Plugin Management tab, find Jira Cloud Integration:
add the mappings in the plugin setting:
In Jira Cloud, open Jira Settings page, click Apps, then Manage Apps:
From the bottom of the page, there is a link named Settings
Click and enable Development Mode so you can install the app not from Atlassian market place.
After enable the development mode, you can add QuickBuild integration by uploading app:
The QuickBuild integration URL is:
Please replace your-quickbuild-server with your actual server url.
NOTE your quickbuild instance should be accessible from internet.
If the installation is successful, you will see QuickBuild listed in the list:
Go to your project page, you will see QB Builds in the project sidebar:
Click QB Builds will show you the latest builds related to this project:
For a specific issue, the integration can also show you the related builds for that issue,
and related SCM changes: