As of June 1, 2015, the IDE Connector documentation will no longer be maintained by Atlassian. See https://developer.atlassian.com/blog/2015/06/discontinuing-ide-connectors-support/ for more information. We will also be making this documentation available for our open source community here: http://atlassian-docs.bitbucket.org/

This page tells you how to set up your JIRA and Bamboo servers as task repositories in Eclipse.

On this page:

Prerequisites

Before you can set up your task repositories for the Atlassian Connector for Eclipse, you will need to do the following:

  • Install the Atlassian Connector for Eclipse as described in the installation guide.
  • Check your version of Mylyn. If you do not already have Mylyn, it will be installed automatically when you install one of the Atlassian Connector's features. If you already have Mylyn installed, please check your version of Mylyn. If your version of Mylyn is earlier than 3.8.4, please upgrade to Mylyn 3.8.4 or newer.

Setting Up your Task Repositories

  1. In Eclipse Mylyn, open the 'Task Repositories' view:
    • Click 'Window', 'Show View', 'Other'.
    • Open the 'Tasks' or 'Mylyn' category and select the 'Task Repositories' view.
  2. Click the 'Add Task Repository' icon.
  3. The 'Add Task Repository' screen appears, as shown below:

  4. Now you can select and configure one or more of the task repositories and configure them to match your server(s), as described below.

    Once you have set up a repository, it will appear in the Eclipse 'Task Repositories' view, as shown in this screenshot:

Setting Up a JIRA Task Repository

  1. On the Eclipse 'Add Task Repository' screen, select the 'JIRA' task repository type and click 'Next'.
  2. The 'JIRA Repository Settings' screen appears, as shown below:


  3. 以下の情報を入力します:
    • Server — The location (URL) of your JIRA server.
    • Label — A descriptive name for your JIRA server, e.g. 'JAC'.
    • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
    • User ID — The username you use to connect to your JIRA server.
    • Password — Your password on the JIRA server, matching the above username.
    • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
      (info) If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
  4. If necessary, you can change the additional settings. If in doubt, leave these settings as set by default.
    • The 'Task Editor Settings' section is used to configure the markup language used by the task editor when Mylyn's WikiText extension is installed. By default, the Atlassian Connector for Eclipse will set the markup language to 'Confluence', so that WikiText recognizes Confluence wiki markup as used by JIRA. See the Mylyn WikiText User Guide for more information.
  5. Click 'Finish' to save the changes.
  6. Eclipse Mylyn will prompt you to add a new query for the new JIRA repository. This is where you will choose your JIRA filter, to determine which issues appear in your task list. You can do this now or skip this step and do it later. You can also add more queries later.
  7. The new task repository appears in your Eclipse 'Task Repositories' view. Your JIRA issues will appear in your 'Task List' view.

(info) You can configure one or more JIRA repositories, i.e. you can connect to more than one JIRA server.

(info) If Validate Settings fails, please make sure Remote API is ON on the JIRA side.

 

Setting Up a Bamboo Task Repository

  1. On the Eclipse 'Add Task Repository' screen, select the 'Bamboo' task repository type and click 'Next'.
  2. The 'Bamboo Repository Settings' screen appears, as shown below:


  3. 以下の情報を入力します:
    • Server — The location (URL) of your Bamboo server.
    • Label — A descriptive name for your Bamboo server, e.g. 'Bamboo Extranet'.
    • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
    • User ID — The username you use to connect to your Bamboo server.
    • Password — Your password on the Bamboo server, matching the above username.
    • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
      (info) If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
  4. Click the 'Refresh' button to verify the information you have entered. The connector will attempt to connect to the Bamboo server. It will also retrieve the latest list of build plans from the Bamboo server.
  5. Select the plans that you want the connector to watch. You can either select the plans individually or you can click the 'Favorites' button to choose your favorite plans as defined on the Bamboo server.
  6. Click 'Finish' to save the changes.
  7. The new task repository appears in your Eclipse 'Task Repositories' view.
  8. If necessary, you can now you can adjust the Bamboo settings.
    • Select 'Window', 'Preferences' then open the Bamboo settings panel as shown below:


    • Enter the 'Auto Refresh Interval Rate'. This is the number of minutes that the connector will wait between calls to fetch new information from your Bamboo server, when the connector is set to refresh automatically.
    • Tick or untick the 'Refresh Automatically' checkbox. Untick this option if you do not want the connector to poll the server automatically. In that case, you will need to refresh you Bamboo information manually by synchronizing the Bamboo task repository.
  9. Next step: To see your Bamboo builds, open the 'Bamboo' view. (Select 'Window', 'Show View', 'Other', then open the 'Atlassian' folder.)

(info) You can configure one or more Bamboo repositories, i.e. you can connect to more than one Bamboo server.

Bamboo builds are shown in a Bamboo-specific view

Bamboo has its own 'Bamboo' view. This is different from JIRA and Crucible, where issues and reviews are included into your 'Task List' view. Next, take a look at the Bamboo view.

Setting Up your Crucible/FishEye Repositories

The last version of the Connector containing FishEye/Crucible support is 2.3.0.

Setting Up a Crucible Task Repository

Single server for both Crucible and FishEye = single task repository

If you have a single server for both FishEye and Crucible, you should set up the Crucible task repository and then select the 'Crucible Server Contains FishEye Instance' option as described below. Due to Mylyn requirements, you cannot set up two separate task repositories for the same URL.

  1. On the Eclipse 'Add Task Repository' screen, select the 'Crucible' task repository type and click 'Next'.
  2. The 'Crucible Repository Settings' screen appears, as shown below:


  3. 以下の情報を入力します:
    • Server — The location (URL) of your Crucible server.
    • Label — A descriptive name for your Crucible server, e.g. 'Extranet Crucible'.
    • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
    • User ID — The username you use to connect to your Crucible server.
    • Password — Your password on the Crucible server, matching the above username.
    • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
      (info) If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
  4. Click the 'Validate Settings' button to verify the information you have entered.
  5. Choose a 'Review Activation' setting. These settings determine what happens when you open a source code file from within the Crucible review editor in Eclipse. For example, you may open a Crucible review within Eclipse. The review will open in an Eclipse editor view, and its 'Review Files' section will show the files in the review. You can then click a file to open it in an Eclipse editor. The options are as follows:
    • 'Always' — The Crucible review will be automatically activated if you open a file from the Crucible review editor.
    • 'Never' — The Crucible review will never be automatically activated.
    • 'Prompt' (default) — When you open a file from the Crucible review editor, the connector will ask you whether you want to activate the Crucible review. This is the default setting.
  6. If your Crucible server is linked to a FishEye server:
    • Put a tick in the checkbox labeled 'Crucible Server Contains FishEye Instance'.
    • Set up your FishEye mappings, as described in the FishEye section of this documentation.
  7. Click 'Finish' to save the changes.
  8. Eclipse Mylyn will prompt you to add a new query for the new Crucible repository. This is where you will choose your Crucible filter, to determine which reviews appear in your task list. You can do this now or skip this step and do it later. You can also add more queries later.
  9. The new task repository appears in your Eclipse 'Task Repositories' view. Your Crucible reviews will appear in your 'Task List' view.

(info) You can configure one or more Crucible repositories, i.e. you can connect to more than one Crucible server.

Setting Up a FishEye Task Repository

Single server for both Crucible and FishEye = single task repository

If you have a single server for both FishEye and Crucible, you should set up the Crucible task repository and then select the 'Crucible Server Contains FishEye Instance' option as described above. Due to Mylyn requirements, you cannot set up two separate task repositories for the same URL.

If you do not have a Crucible server, you can hook up your FishEye server as an Eclipse task repository without the additional Crucible functionality.

  1. On the Eclipse 'Add Task Repository' screen, select the 'FishEye' task repository type and click 'Next'.
  2. The 'FishEye Repository Settings' screen appears, as shown below:


  3. 以下の情報を入力します:
    • Server — The location (URL) of your FishEye server.
    • Label — A descriptive name for your FishEye server, e.g. 'FishEye Atlassian Developer'.
    • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
    • User ID — The username you use to connect to your FishEye server.
    • Password — Your password on the FishEye server, matching the above username.
    • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
      (info) If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
  4. Click the 'Validate Settings' button to verify the information you have entered.
  5. Click 'Finish' to save the changes.
  6. The new task repository appears in your Eclipse 'Task Repositories' view.
  7. Now you need to map your source code to your FishEye repository and FishEye project.
    • Select 'Window', 'Preferences' then open the 'Repository Mappings' panel as shown below:


    • Click the 'Add' button to add a new mapping. The 'Add Mapping' screen appears, as shown below:


    • Enter the 'SCM Path' — Supply the path to your source code as used locally by the project.
    • Select the FishEye/Crucible 'Server' as configured in your task repositories. (See instructions above.)
    • The connector will retrieve a list of FishEye repositories from the server you have supplied. Select the appropriate 'Source Repository' to map your local project to the FishEye repository.

(info) Some notes about the FishEye integration:

  • You can configure one or more FishEye repositories, i.e. you can connect to more than one FishEye server.
  • We have chosen to configure FishEye servers as standard Mylyn task repositories. They are not really regular repositories like JIRA or Crucible, because there are no tasks associated with a FishEye task repository. We are using the task repository concept to take advantage of various infrastructural facilities available in Mylyn and to make user experience more consistent with the rest of the Atlassian products. See More about Configuring FishEye Repositories in Eclipse.

 

 

関連トピック

 

  • ラベルなし

10 Comments

  1. Anonymous

    It seems that Crucible connector (shown in 3rd step at Setting Up your Task Repositories) is missing...

    -- Rafal Magda

    1. Anonymous

      Yes,I same.

  2. Anonymous

    The JIRA Plugin works only with user/password authentication and I cannot use it therefore. Is it planned to support authentication by certificates?

  3. Anonymous

    I'm also attempting (and failing) to use certificate login - any news?

  4. Anonymous

    Same here. It's not logging in when requesting information. I can get basic info, but not ticket info.  If I use the eclipse browser, the queries show that I'm not logged in.. I have to log in first before they work.

  5. Anonymous

    Hello everybody, can anybody help me?

    I've downloaded newest version of eclipse, atlassian connector from market place and connected JIRA task with eclipse. so far so good (smile). But now I need to intergrate it with fisheye and I can't find it in eclipse.

    I go by tutorial here: SettingUpaFishEyeTaskRepository

    first step is: 

    1. On the Eclipse 'Add Task Repository' screen, select the 'FishEye' task repository type and click 'Next'. 

    but I dont have FishEye in that list, just Bamboo and JIRA.

    1. On this page:

      The last version of the Connector containing FishEye/Crucible support is 2.3.0

       

       

    2. Hi,

      There is a red box saying that "The last version of the Connector containing FishEye/Crucible support is 2.3.0".  

      Unfortunately there is no more support for Fisheye and Crucible in the Connector. 

      Please also note that you can download newer version of the Connector  (3.2.2 based on JIRA REST API) from the following update site: http://update.atlassian.com/atlassian-eclipse-plugin/rest/e3.7

      Cheers,
      Jacek 

  6. Hi gurus,

    I am trying to integrate Eclipse (Kepler) to JIRA v6.2 but I get the following error: com.atlassian.jira.rest.client.RestClientException: com.sun.jersey.api.client.UniformInterfaceException: Client response status: 404

    I can reach the server using the browser but not with Eclipse. Could you help me please?

    Thanks,

    Bogdan

    1. Hi Bogdan,

      Please ask the question at https://answers.atlassian.com/ and we will try to help you.

      Cheers,
      Jacek