Integrating with JIRA
JIRA is an issue tracking product, developed by Atlassian, used for bug tracking, issue tracking and project management. Each time a commit is made, a simple tag-based syntax is used to manipulate or edit tickets in JIRA (on push for Git repos).
Setting up integration
From the Settings section in your repo, go to Integration, then select Jira. You are required to add your Jira URL, username, and your password or API token (Jira Server uses the former and Jira Cloud the latter).
After successfully authenticating your JIRA credentials select the JIRA project you would like to integrate with Beanstalk. Please note: you need to have admin privileges for your Jira account to enable this integration.
After this, finish the setup by clicking the "Activate" button.
Using JIRA with Beanstalk
To tag a ticket in JIRA you'll need to add keywords to your commit messages that will update tickets in JIRA. For example:
Updated site header [#185]
The #185 will add this log message as a comment to ticket #185. You can also change various properties.
You can use additional tags to edit or manipulate cases as well. For example:
New feature is implemented and tested [#185 assign:chris trans:resolve]
This commit message will add a comment to the issue, set responsible user, and execute a transition in JIRA. Assign option matches first name only, if there are two users with same name, it will match by first letter of alphabet on last name.
Example JIRA tags
- assign - Sets the issue assignee
- trans - Sets the transition to execute
- Valid values are dependable on your JIRA workflow
- Invalid transition values will be ignored
- tag - add a label to the issue
Please note: Only the Beanstalk account owner and admins are allowed to activate integrations.