Jira Cloud integration
Binding a SonarQube project with a Jira Cloud project.
After connecting your SonarQube Server instance with your Jira Cloud instance you are now ready to connect your SonarQube project with a Jira Cloud project. If you haven’t connected your SonarQube instance with Jira Cloud, see Jira Cloud integration on the instance level first.
Permissions
To connect your SonarQube project with a Jira Cloud project:
You need the Administer project permissions. Go to Your Project > Project Settings > Permissions and select the Administer checkbox for specific users and groups.
Unless you are a System Administrator, you need the Grant project administrators binding permissions on the instance level in Administration > Configuration > General Settings > Jira. See Binding steps in SonarQube Server for more information.
Binding your project with a Jira Cloud project
To bind your SonarQube project with a Jira Cloud project
Go to Your Project > Project Settings > General Settings > Jira.
Click Connect to open the connection modal.
In the modal, select a Jira project from a dropdown list. A maximum of 1,000 items is available. Use the search option to quickly find a specific project.
Choose the Jira work types that you can push from SonarQube to Jira Cloud.
Click Connect. Your connection is now saved and you should see the confirmation on the page.
Once your binding between SonarQube project and Jira Cloud project is created you will see the connection details along with options to edit or delete the project binding.
You are now ready to create Jira work items from SonarQube issues. See Managing Jira work items for more information.
Mandatory fields without a default value
The configuration might not support all of your Jira project’s mandatory fields. The following is a list of supported mandatory fields:
Summary
Description
Reporter
Jira work types that have other mandatory fields associated with them, and have no default value, are not supported and are disabled in SonarQube. You can either remove these mandatory fields in Jira or choose a supported work type in SonarQube. At least one supported Jira work type is required to save the configuration.
Editing your project binding with Jira Cloud
By clicking on Edit, you can change the binding of your SonarQube project by connecting it with another Jira Cloud project. Editing the binding is non destructive, meaning that all SonarQube-to-Jira connections will remain intact. To completely reset your project, you must unbind the SonarQube project with Jira Cloud by clicking the delete button.
Unbinding your project from Jira Cloud
Deleting the project binding removes all of your connections and links in the Jira Cloud project. This is a complete reset between your SonarQube project and Jira Cloud.
Troubleshooting
Some Jira work types cannot be selected on the project settings page for Jira. Solution: Jira work types that have other mandatory fields associated with them are not supported and are disabled in SonarQube. You can either remove these mandatory fields in Jira or choose a supported work type in SonarQube.
The Connect button is grayed out on the project settings page for Jira, preventing you from binding your Sonar project with a Jira project, or the Edit and Delete buttons are grayed out on an existing SonarQube-to-Jira connection. Solution: Make sure the System Administrator turns on the toggle for Grant project administrators binding permissions on the Jira administration page for the SonarQube Server instance. See Binding steps in SonarQube Server for more information.
The Jira release widget does not show any insights, even though your team is operating under a version-based release cycle. Solution: Ensure you have releases and versions enabled in your Jira Cloud project. See the Atlassian website for more information.
Related pages
Jira Cloud integration on an instance level
Last updated
Was this helpful?