Stash is now known as Bitbucket Server.
See the

Unknown macro: {spacejump}

of this page, or visit the Bitbucket Server documentation home page.

When Stash is integrated with Atlassian JIRA, you can:

  • see the JIRA issues related to particular commits in Stash, as shown in the screenshot below of the Commits tab for a Stash project.
  • see the JIRA issues related to particular pull requests.
  • click through to the issues in JIRA.
  • use JIRA for delegated user management. See External user directories.

Related pages:

Stash integrates with JIRA by means of an 'application link'. You can set up application links either:

  • during the Stash install process, using the Setup Wizard, or 
  • at any time after installation, as described below.

(warning)   Stash integration with JIRA may require an upgraded version of the FishEye plugin in JIRA. See JIRA compatibility for details about upgrading the JIRA FishEye plugin, and for download links to the upgraded plugin versions.

On this page:

Linking Stash with JIRA

To link Stash to a JIRA server:

Go to the Configure Application Links screen in Stash:

Click Add Application Link:

Complete the application link wizard to connect Stash to your JIRA server. It is recommended that you make use of the automatic link-back from JIRA to Stash.

More detailed information about application links can be found on Configuring Application Links.

You're finished! No other configuration is required. The next time a commit is pushed to a Stash repository, Stash will index all previous commits to that repo and link them to the corresponding JIRA issues. Your JIRA issues will then appear in the changesets and commit lists in Stash. On the JIRA side, the commits associated with a specific issue will now appear in the issue's Source tab.

Where are my issues?

To avoid overloading your server, Stash will trigger issue key indexing for a particular repository on the first push to that repository after you have created a JIRA Application Link.

So if you aren't seeing JIRA issue keys showing up in your "Issues" column, try pushing a small change to the repository and refreshing the page.

Known issues with the JIRA integration

We have tried to make the integration of JIRA with Stash as straightforward as possible. However, we are aware of the following issues:

  • Stash only supports one JIRA server; we only pick the primary one.
  • There is no checking for project or issue-key validity; Stash may link to issues that do not actually exist.

We apologise for the inconvenience. You can watch the 2 issues below to keep track of our progress:

  • No labels
 

 

 

 

 Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.