Is there life after Dragons?

Now that you have successfully set up your Atlassian integrated suite, we have some useful information about what you may want to do next. There's no rush. Get to know the applications and show off your T-shirt for a while first. Then choose any of the points below that may be relevant to you.

On this page:

Using the Free IDE Connectors

This information is useful to developers who use Eclipse or IntelliJ IDEA. You can work with JIRA issues, Bamboo builds and FishEye links directly within your IDE (integrated development environment), using the Atlassian IDE Connectors. The connectors are free.

Atlassian Connector for Eclipse

Installation

You can install the connector directly from the Eclipse software updates manager, or via the Mylyn Connector Discovery wizard, or from a zipped archive. Full instructions are in our installation guide. Here are the instructions for Eclipse 3.5 using the Mylyn Connector Discovery wizard:

  1. Ensure that you have already installed Mylyn 3.2.x. (If you are using an Eclipse package from the Eclipse download site, Mylyn 3.2 is already included in any package except the Classic download.)
  2. In Eclipse Mylyn, open the 'Task Repositories' view. (In Eclipse, click 'Windows', 'Show View', 'Other' and select the 'Task Repositories' view from the 'Tasks' category.)
  3. Click the 'Add Task Repository' icon.
  4. The 'Add Task Repository' screen appears. Click the 'Install More Connectors' button.
  5. The 'Mylyn Connector Discovery' screen appears. Select the Atlassian Connector and click 'Finish' to install it.

Overview

Working with Bamboo builds in Eclipse, you can:


Working with FishEye in Eclipse, you can open a file from Eclipse in FishEye and send your colleagues a FishEye link to your file.

Working with JIRA issues in Eclipse:

Videos and tours

See our website.

Atlassian Connector for IntelliJ IDEA

Installation

You can install the connector from the 'Plugins' menu in IntelliJ IDEA, as described in our installation guide. Here are the instructions in brief:

  1. Open the IDEA plugin manager. (Go to IDEA's 'File' menu and select 'Settings', 'IDE Settings', 'Plugins'.)
  2. Right-click 'Atlassian Connector for IntelliJ IDEA' in the 'Available' plugins tab.
  3. Select 'Download and Install'.

Overview

Working with Bamboo builds in IDEA, you can:


Working with FishEye in IDEA, you can open a file from IDEA in FishEye and send your colleagues a FishEye link to your file.

Working with JIRA issues in IDEA, you can:

Videos and tours

See our website.

Adding Another Atlassian Tool to your Suite

This section tells you about another Atlassian developer tool that you can add to your integrated suite, Clover for code coverage.

Clover for Code Coverage

Clover is a code coverage tool for Java. 'Code coverage' means that Clover measures how much of your Java code is executed by your tests. Clover has several differentiating features, including the ability to optimize your test execution (make your builds faster), measure per-test coverage and produce interactive HTML reports. Clover provides plugins for Eclipse and IntelliJ IDEA.

Installation

Clover offers several different installation options, depending on your development and build tools. The details are in the Clover documentation. Below are the instructions for using Clover within Bamboo. (This configuration will work only for Java projects using Maven 2 or Ant.) Since you have already installed Bamboo, it is very simple to enable the Clover plugin for Bamboo. All you need is a license key:

  1. Go to your Bamboo URL in your browser, e.g. http://www.foobar.com:8085.
  2. Log in to Bamboo with username charlie.
  3. Make sure you are on the 'All Plans' tab of the 'Home' screen. (Click 'Home' in the top navigation bar, then click 'All Plans'.)
  4. Click the name of the plan, 'Main', to open the plan summary.
  5. Click the 'Configuration' tab.
  6. Click the 'Builder' tab.
  7. Click the 'Edit Plan' link.
  8. Select the checkbox labeled 'Use Clover to collect Code Coverage for this build'.
  9. A new section of the screen will open. Select the radio button labeled 'Automatically integrate Clover into this build'.
  10. More reporting options appear. At this stage it is fine to leave them unselected.
  11. Optional – Enter your 'Clover License':
    • If you have a Clover license, enter the license key.
    • If you do not have a Clover license, leave the license field empty. You can use Clover in Bamboo for 30 days without obtaining a license.
  12. Click 'Save'.

Overview

Now that you have Clover in Bamboo, you can run a build and see the code coverage . You can also use Bamboo's report generator to see the  Clover Lines of Code report and the  Clover Code Coverage report.

If you would like to try it out with our sample repository, follow the instructions below.
(info) Please note: Running the build of our sample project will take quite a long time: approximately 20 minutes. This is because the build procedure will download and start the Confluence web application so that it can run the integration tests.

  1. Click 'Build Actions' near the top right of the Bamboo build plan screen, for your Dragons Main plan.
  2. A dropdown menu will appear. Click 'Run Build'.
  3. The build will start. If this is the second time you have run a build, it will be called DRAG-MAIN-2. Have a cup of hot chocolate while the build runs. It will take some time – approximately 20 minutes. Here is a summary of what it will do:
    • Download the Clover plugin for Bamboo.
    • Run the unit tests.
    • Download the Confluence web application. It does this because our sample project is a Confluence plugin.
    • Start a Confluence server in Tomcat on port 1990.
    • Run the integration tests.
    • Shut down Confluence.
    • Collect the Clover artifacts.
    • Finally, report that the build is successful. (Or that it has failed.)
    • When the build has finished, click the build name, e.g. DRAG-MAIN-2, near the top right of the screen.
  4. The 'Build Result' screen will appear. Click the 'Clover' tab.
  5. The 'Clover Code Coverage' screen will appear.

Screenshot 2 (click to enlarge): Clover in Bamboo

Classic Clover

More things you can do with Clover:

  • From within IntelliJ IDEA, view recently-run tests via the Test Run Explorer, see the Java code annotated with coverage information, view coverage cloud and treemap reports, and optimize your test builds.
  • From within Eclipse, view recently-run tests via the Test Run Explorer, see the Java code annotated with coverage information, view coverage cloud and treemap reports, see the unit tests and methods that generated coverage for the currently opensource file, and optimize your test builds.
  • Use Clover for Ant, interactively or in automated builds, with a range of current and historical reports, clouds and charts.
  • Use Clover for Maven 1 or for Maven 2, view a range of historical and custom reports, and optimize your test builds.

Videos and tours

See our website.

Hints after Initial Setup

These hints may be useful in the early days after you complete your initial setup. Click the links to see the details of each hint.

Adding Users to your Atlassian Integrated Suite

During the Atlassian Dragon Quest, you added just one user to your integrated suite: Charlie of Atlassian. Very soon you will want to add more users, and in particular users who are not administrators. You also configured all the Atlassian applications to centralize their user management in JIRA. We recommend that you use JIRA for all user and group management.

Running Bamboo in a Console Window

If you experience problems with running Bamboo as a Windows service you can start Bamboo in a console window instead, by running {BAMBOO_INSTALL}\bin\BambooConsole.bat.

RELATED TOPICS

Here Be Dragons

  • No labels