This page last changed on Mar 14, 2011 by ggaskell.
JIRA's FishEye integration allows you to browse your source-control repository from inside JIRA, provided you are using Atlassian FishEye with your source-control repository. FishEye integration is implemented as a plugin (drop-in extension) to JIRA, which ships with JIRA.
FishEye integration allows you to:
 | For JIRA to successfully integrate with FishEye, the FishEye web server must first be set up to receive remote API calls. A FishEye administrator can do this by visiting the FishEye web server's 'Server Settings' page (which can be accessed from FishEye's 'Administration' area) and setting the 'Remote API' setting to 'On'. See Configuring the FishEye Web Server for more information. |
|
|
Integrating JIRA with FishEye or Crucible
To begin integrating JIRA with either FishEye or Crucible, an application link between your JIRA server and FishEye or Crucible server must be created first.
Creating an Application Link Between a JIRA and a FishEye/Crucible Server
You require JIRA System Administration permissions in order to perform this procedure.
To create an application link between a JIRA and a FishEye/Crucible server:
- Go to your JIRA URL in your browser, e.g. http://jira.mycompany.com:8080.
- Click 'Administration' in the top navigation bar to open the JIRA Administration console.
- Click 'FishEye Configuration' in the 'Global Settings' section of the left-hand navigation panel. The 'JIRA FishEye Plugin' page will appear.
- Click 'create an Application Link'. The 'Configure Application Links' page will appear.
- Create an application link between your JIRA server and the appropriate FishEye/Crucible server. (See the first procedure on Adding an Application Link from step 2 for details.) While doing so, be aware of the following:
- The 'Server URL' is the URL of your FishEye server, e.g. http://coopers:8060 or http://fisheye.foobar.com:8060.
 | Integrating FishEye with JIRA You can also configure FishEye to integrate with JIRA, which enables you to view JIRA data from within FishEye. Please see JIRA Integration in FishEye in the FishEye documentation for instructions. |
Associating a FishEye Repository or Crucible Project with a JIRA Project
You may wish to associate a specific FishEye repository or Crucible project with a JIRA project. To do this, you need to create an 'entity link' between your JIRA project and a FishEye repository/Crucible project.
Associating JIRA projects with FishEye repositories or Crucible projects is recommended as it greatly improves JIRA's responsiveness when your users view the 'Source' or 'Review' tabs on JIRA issues. Otherwise, JIRA must scan for all FishEye repositories/Crucible projects which are accessible to a user, whenever that user views these tabs on a JIRA issue.
This process is mandatory if your FishEye/Crucible server has no publicly accessible repositories/projects and JIRA's application link to this FishEye/Crucible server uses OAuth outgoing authentication.
You can only perform this procedure once an application link has been established between your JIRA and FishEye/Crucible servers (above).
To create an application link between a JIRA and a FishEye/Crucible server:
- Go to your JIRA URL in your browser, e.g. http://jira.mycompany.com:8080.
- Click 'Administration' in the top navigation bar to open the JIRA Administration console.
- Click 'Projects' link in the 'Project' section of the left-hand navigation panel.
- Click the name of the JIRA project that you want to associate with a FishEye repository/Crucible project. The JIRA project's configuration page will appear.
- Locate the 'Application Links' option and click 'Configure Application Links'. The page for configuring links from your JIRA project to the entities of applications (already linked on your JIRA server) will appear.
- Create an entity link between your JIRA project and the appropriate FishEye repository/Crucible project. (See the procedure on Linking your JIRA Project to another Entity from step 4 for details.)
|