Atlassian Integration Guide : Dragons Stage 6 - Get JIRA and FishEye Talking


You are embarking on stage 6 of the Atlassian Dragon Quest. You have reached a place filled with flames and serpents and dragons.

In this stage you will configure JIRA and FishEye, so that you will be able to see code commits in JIRA and see JIRA issues in FishEye.

Time estimate: This stage will take approximately 15 minutes.

On this page:

Step 1. Configure your JIRA Settings in FishEye/Crucible

When running the FishEye setup wizard, you connected JIRA to FishEye/Crucible. Now you will update that application link and enable subtasks for Crucible. This is required for creating JIRA issues from Crucible reviews. You will also enable the remote API in FishEye.

  1. Go to your FishEye URL in your web browser. For example: http://localhost:8060/fisheye
  2. Click the downward-pointing arrow next to your username ('Charlie of Atlassian') then click Administration in the dropdown menu.
  3. Click Application Links in the left-hand panel.
  4. The 'Configure Application Links' screen will appear, showing a connection to your JIRA server. Click JIRA Settings next to the JIRA application link.
  5. The 'Update JIRA Server' screen will appear. Enter the following information:
    • Select the Include in Activity Streams checkbox.
    • Click the Test button in the 'Subtask Settings' section. The options 'Subtask Settings' section will change, allowing you to complete the following fields.
    • Select the Subtask Type: Technical task
    • Enter the Subtask Resolution Action ID: 2
    • Leave the Subtask Resolution at its default value: Cannot Reproduce
    • Select Allow Unassigned: Yes
  6. Click Save.
  7. Click the Server link in the left-hand menu under 'Global Settings'.
  8. The 'Server Settings' screen will appear. Click Edit Settings.
  9. The 'Edit Web Settings' screen will appear. Select the On radio button next to Allow remote API calls.
    (In some browsers, the label 'Allow remote API calls' is missing. The radio buttons are under the field labelled 'Ajp13 Bind Address'.)
  10. Click Update.

Screenshot 1 (click to enlarge): Application link to JIRA in FishEye

Step 2. Link your FishEye and JIRA Projects and Subscribe JIRA to FishEye's Gadgets

In this step you will link your FishEye 'Dragons' repository to your JIRA 'Dragons' project via a project link. This will enable the hyperlink on JIRA issue keys in FishEye and the summary popup window that appears when you move your cursor over a JIRA issue key. You will also make your FishEye gadgets available for use in JIRA.

  1. Make sure you are still in the FishEye administration screens.
  2. Click Repositories in the left-hand menu under 'Repository Settings'.
  3. The 'Repositories' screen will appear. Click the cog icon next to your 'Dragons' repository and select Application Links from the dropdown menu.
  4. Click Add Link and select your JIRA server from the dropdown menu.
  5. Click Create. Your FishEye repository is now linked to your JIRA project.
  6. Now you will make your FishEye gadgets available in JIRA, so that users will be able to add any FishEye gadget to their JIRA dashboard. Go to your JIRA browser window and click Dashboards in JIRA's top navigation bar.
  7. Click Add Gadget.
  8. The 'Gadget Directory' popup window will appear. Click Gadget Subscriptions.
  9. The 'Gadget Subscriptions' popup window will appear. Click Add Subscription.
  10. The 'Add Subscriptions' popup window will appear. Copy the base URL for your FishEye site (for example, http://coopers:8060/fisheye or http://www.foobar.com:8060/fisheye) and paste it into the text box on the screen.
  11. Click Add Subscription.
  12. Click Finished.
    (tick) The FishEye gadgets are now available in your JIRA gadget directory. You have not yet added them to your JIRA dashboard. We will do that in a later step.

Step 3. Configure the FishEye Plugin in JIRA

The FishEye plugin for JIRA is bundled as part of the JIRA package, so there is no need to install it. Now you will configure the plugin for your installation and configure JIRA to trust FishEye.

  1. Click Administration in JIRA's top navigation bar.
  2. The JIRA Administration console will open. Click Plugins > FishEye Configuration.
  3. JIRA's FishEye configuration screen will appear. Click the Edit link next to FishEye/Crucible Server.
  4. Select Yes next to Enable Crucible Integration and click Update.
  5. Click the Edit button at the end of the 'Global Configuration' section.
  6. Select Both next to Review Search Method and click Update.
  7. Click Application Links Configuration at the bottom of the screen.
  8. Click Trusted Applications in the 'Outgoing Authentication' column for your FishEye/Crucible link. If prompted, log in to FishEye as charlie.
  9. Click Modify  and enter the following information:
    • IP Patterns – Enter the IP addresses of your FishEye/Crucible site, one address per line. For example:

      127.0.0.1
      172.20.5.95
    • Leave the other fields at their default values.
  10. Click Apply.
  11. Click Incoming Authentication in the left-hand menu.
  12. Go to the 'Trusted Applications' tab, click Modifyif prompted, and enter the following information.
    • IP Patterns – Enter the IP addresses of your JIRA site, one per line. For example:

      127.0.0.1
      172.20.5.95
    • URL Patterns: Enter exactly the following paths, one per line:

      /secure/CreateSubTaskIssueDetails.jspa
      /browse/
      /rest
      /plugins/servlet/applinks/whoami
      /plugins/servlet/streams
      /rpc/soap
      /sr/jira.issueviews:searchrequest
      /secure/RunPortlet
      
  13. Click Update and then Close.

Try It Out!

  • There is now a 'Source' tab on your JIRA issues. Open your DRA-1 issue and click the new Source tab. The tab shows the changesets related to the issue. These are the changesets where the JIRA issue key was included in the commit message.

    Screenshot 2 (click to enlarge): Source tab on a JIRA issue
  • There is now also a 'Source' tab on your JIRA project. Open your Dragons project to see the new tab. (Click the dropdown arrow next to Projects in the top navigation bar, then click the Dragons (DRA) project.) The 'Source' tab shows the most recent changesets related to any issue in the project.
  • You can click through from JIRA to view a changeset or other repository views in FishEye. To try it, go to the Source tab on your 'DRA-1' issue and click the changeset number or the repository name ('Dragons').
  • In FishEye, you can see a popup summary of issue information for an issue key. Try it by moving your cursor over DRA-1 in your FishEye view. You can also click through from FishEye to JIRA by clicking the issue key.

    Screenshot 3 (click to enlarge): Popup summary of JIRA issue in FishEye

Full details are in the JIRA documentation.

Problems? Please raise a support ticket for the product you're stuck on, or see answers from the community.
Victory? Please continue.

Step 4. Add a FishEye Gadget to JIRA

Now you will add the 'FishEye Recent Changesets' gadget to your Dragon Development Dashboard.

  1. Click Dashboards at top left of your JIRA screen.
  2. Your 'Dragon Development Dashboard' will appear. Click Add Gadget.
  3. The 'Gadget Directory' will appear, showing a list of the available gadgets for your JIRA dashboard. Enter 'recent' into the search box at top right of the Gadget directory screen.
  4. The list of gadgets will change, to show only the gadgets that match your search term. Find the FishEye Recent Changesets gadget and click Add it Now. The gadget will be highlighted for a short time and the button's wording will change to 'Adding', while JIRA adds the gadget to the dashboard.
  5. Click Finished to go back to your dashboard.
  6. Configure the 'FishEye Recent Changesets' gadget:
    • Enter 'Dragons' in the Repository field.
    • Leave all the other fields at their default values and click Save.
  7. Choose a different colour for your 'FishEye Recent Changesets'gadget:
    • Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
    • Select the orange square in the row of colours.

Problems? Please raise a support ticket for the product you're stuck on, or see answers from the community.
Victory? Please continue.

Victory!

Your JIRA dashboard now has 5 gadgets:

  • The 'FishEye Recent Changesets' gadget
  • The 'Confluence QuickNav' gadget
  • The 'Assigned to Me' gadget
  • The 'Projects' gadget
  • The GreenHopper 'Agile' gadget

Screenshot 4 (click to enlarge): JIRA dashboard with 5 gadgets

Problems? Please raise a support ticket for the product you're stuck on, or see answers from the community.
Victory? Please continue.

Grab a bigger sword and move to the next stage

Attachments:

JIRAIssueSourceTab.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRADashboard4Gadgets.png (image/png)
JIRADashboard4Gadgets.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRADashboard4Gadgets.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRADashboardStage6.png (image/png)
JIRADashboardStage6.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRADashboardStage6.png (image/png)
JIRADashboardStage6-v5.png (image/png)
FishEyeCrucibleAppLinks.png (image/png)
FishEyeCrucibleAppLinks-v6.png (image/png)
JIRAIssueSourceTab-v6.png (image/png)
JIRAProjectSourceTab-v6.png (image/png)
JIRADashboardFishEye-v6.png (image/png)
JIRAIssueSourceTab-v7.png (image/png)
FishEyeJIRAIssueHover.png (image/png)
JIRADashboardFishEye-v7.png (image/png)
JIRADashboardFishEye-v7.png (image/png)
FishEyeJIRAIssueHover.png (image/png)
JIRAIssueSourceTab-v7.png (image/png)
JIRADashboardFishEye-v6.png (image/png)
JIRAProjectSourceTab-v6.png (image/png)
JIRAIssueSourceTab-v6.png (image/png)
FishEyeCrucibleAppLinks-v6.png (image/png)
FishEyeCrucibleAppLinks.png (image/png)
JIRADashboardStage6-v5.png (image/png)
JIRADashboardStage6.png (image/png)
JIRAProjectSourceTab.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRADashboard4Gadgets.png (image/png)
dragon_06.png (image/png)
dragon_badge07.png (image/png)
FishEyeCrucibleAppLinks-v6.png (image/png)
JIRAIssueSourceTab-v7.png (image/png)
FishEyeJIRAIssueHover.png (image/png)
JIRADashboardFishEye-v7.png (image/png)