Atlassian Integration Guide : Dragons Stage 2 - JIRA Add-Ons


Beware of fiends and dragons on the gargoyled eaves. You are embarking on stage 2 of the Atlassian Dragon Quest.

In this stage you will set up GreenHopper for agile project management, and Bonfire for agile testing. GreenHopper and Bonfire are plugins (add-ons) that you will install into JIRA.

Time estimate: This stage will take approximately 20 minutes.

On this page:

Step 1. Install GreenHopper

In this step you will install the GreenHopper plugin into JIRA.

  1. Go to your JIRA URL in your browser. For example, http://www.foobar.com:8080/.
  2. Click Administration, then click Plugins > Plugins in the top menu.
  3. The plugin management screen will appear. Click the Install tab.
  4. Enter 'GreenHopper' into the Search the Plugin Exchange text box, and click Search.
  5. Click the GreenHopper plugin name in the list of plugins.
  6. The plugin details will appear. Click Install Now.
  7. Set up your GreenHopper license key:
    • Click Plugins > GreenHopper in the top menu. (Refresh the screen if the option does not appear immediately.)
    • The 'GreenHopper License Information' screen will appear.
    • If you do not already have a GreenHopper license, open a new browser window and go to My Atlassian, then follow the prompts to get an evaluation license key for GreenHopper.
    • Paste your GreenHopper license key into the GreenHopper License textbox on your JIRA screen.
    • Click Add.

Full details are in the GreenHopper Installation Guide.

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

Step 2. Install Bonfire

In this step you will install the Bonfire plugin into JIRA, and add the associated extension for your browser.

  1. Click Plugins > Plugins in the top menu.
  2. The plugin management screen will appear. Click the Install tab.
  3. Enter 'Bonfire' into the Search the Plugin Exchange text box, and click Search.
  4. Click the Atlassian Bonfire plugin name in the list of plugins.
  5. The plugin details will appear. Click Install Now.
  6. Set up your Bonfire license key:
    • Click Plugins > Bonfire License in the top menu. (Refresh the screen if the option does not appear immediately.)
    • The 'Bonfire License' screen will appear.
    • If you do not already have a Bonfire license, open a new browser window and go to My Atlassian, then follow the prompts to get an evaluation license key for Bonfire.
    • Paste your Bonfire license key into the Bonfire License textbox on your JIRA screen.
    • Click Add.
  7. Next you need the Bonfire extension for your browser. Click Bonfire Settings.
  8. The 'Bonfire Settings' screen will appear, as shown in screenshot 1. Click the link to the Bonfire download page.
  9. The 'Get Bonfire' screen will appear. Click Download Bonfire and follow the instructions to download and install Bonfire for your browser.

Screenshot 1 (click to enlarge): Bonfire settings with link to Bonfire extension download page


Full details are in the Bonfire Installation Guide and the Bonfire browser add-on guide.

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

Step 3. Get Started with GreenHopper

The first time you use GreenHopper, you will see the 'getting started' screen, which describes the use of GreenHopper for Kanban and for Scrum teams.

  1. If you are still in JIRA's administration screens, click Exit Administration at the top right of the screen.
  2. Click Agile in the top menu.
  3. The Getting Started with GreenHopper screen will appear, as shown in screenshot 2. If it does not, click AgileGetting Started.
  4. Choose Yes, please or No, thanks to answer the question about collection of anonymous usage data.

Screenshot 2 (click to enlarge): Getting started with GreenHopper

Step 4. Add Two Sprints and Another JIRA Issue

Now that you have GreenHopper you can choose to update your issues via the GreenHopper tabs or via the standard JIRA interface. For this exercise you will do your updates via GreenHopper.

First you will create two 'sprints', also known as 'milestones'. A sprint is a short period of time, two weeks for example, in which your developers focus on a particular set of tasks. Then you will create a new issue and include it in one of the sprints. Finally you will add your existing issue to the same sprint.

  1. Click AgilePlanning Board.
  2. The planning board will appear, showing the 'DRA-1' issue that you have already created. Click the Add button above the version cards, near the top right of the planning board.
  3. The 'Add Version' screen will appear. Add a sprint with the following information:
    • Version Name: 2.0.S1
    • Description: Version 2.0 Sprint 1
    • Leave the default values for the other fields.
    • Click Create and Close.
  4. Follow the above steps to add another sprint with the following information:
    • Version Name: 2.0.S2
    • Description: Version 2.0 Sprint 2
  5. Your two new sprints will appear as boxes on the right of the planning board, underneath the 2.0 box. Now you need to include the two sprints into the existing version 2.0. Click the sprint box for sprint 2.0.S1.
  6. Within the sprint box click the gear icon (top right) and select Toggle visibility, or double click the sprint title bar, to expand the box.
  7. The Parent is currently set to 'none'. Click Parent.
  8. A dropdown list will appear. Select 2.0.
  9. The '2.0.S1' sprint will become part of version 2.0 – the gap between the boxes will disappear and a small downward and rightward-pointing arrow will appear next to the heading '2.0.S1'.
  10. Edit the Parent for sprint 2.0.S2 in the same way.
  11. You now have two sprints within version 2.0. Next you will add a new issue, also known as a card. Click New Card  on the planning board. Enter the following values:
    • Card type: Bug
    • Priority: Blocker
    • Summary: Exploding flame extinguishers
    • Version: Unscheduled
    • Component: Unknown
    • Original estimate: 2d
    • Assignee: charlie
  12. Click Create and Close, to create the issue.
  13. You will see your planning board again. It currently shows no cards. Click the version number dropdown near the top left of the screen (currently showing '2.0.s2') and select Unscheduled to see all the cards.
  14. Click the card for issue DRA-1, drag the card to the right and drop it onto the box for sprint 2.0.S1.
  15. Drag DRA-2 to sprint 2.0.S1 as well.
  16. Your planning board will now be empty, because it is currently showing cards for version 'Unscheduled'. Click the version number 2.0.S1 at the top of the version 2.0.S1 box on the right. You should now see your two cards 'DRA-1' and 'DRA-2'.
  17. Click the version number 2.0  at the top of the version 2.0 box on the right. Notice the following points:
    • The value in the version number dropdown box at the top of the planning board also changes to '2.0'.
    • Your two issue cards are included in version 2.0 as well as in sprint 2.0.S1.
    • You can double click the title bar of each version box, to minimise or expand the box.
  18. Mark one of your issues as complete:
    • Click the down arrow next to 'Planning Board' and select Task Board.
    • Your task board will appear, with your two issue cards in the 'To Do' column on the left. Click the card for DRA-2, drag it to the right and drop it in the Done column.
    • The 'Transitioning Issue' screen will appear. Select Close Issue and click Update.
    • The 'Close Issue' screen will appear. Click Close Issue.

Screenshot 3 (click to enlarge): The GreenHopper task board for version 2.0

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

Step 5. Apply the Scrum Template to your Project and Add a Story

GreenHopper includes a project template for the Scrum methodology. The template adds custom fields, such as ranking fields and story points, to your project. It also allows you to create stories, epics and technical tasks. In this step you will apply the Scrum template to your project and create a story.

  1. Go back to your planning board, then click Tools > Configuration.
  2. The project configuration screen will appear. Click the General tab.
  3. Select Scrum from the Project Template dropdown menu.
  4. Click Change template on the confirmation window.
  5. Next you will create a new story. Go back to your planning board and click New Card. Enter the following values:
    • Card type: Story
    • Priority: Major
    • Summary: As a dragon slayer I would like to wield an extremely big sword
    • Version: 2.0
    • Component: Unknown
    • Business Value: 10
    • Assignee: charlie
    • Story Points: 10
  6. Click Create and Close. You will see your planning board again. If your new story does not appear on the board, click the version number 2.0 at the top of the version 2.0 box on the right so that the board shows all cards for version 2.0.

Screenshot 4 (click to enlarge): The GreenHopper planning board with story

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

Step 6. Add the GreenHopper Gadget to your JIRA Dashboard

Now you will add the GreenHopper 'Agile' 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 'agile' 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 GreenHopper Agile 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 'GreenHopper Agile Gadget':
    • Start typing 'Dragons' in the Project or Saved Filter box and select Dragons (DRA) from the dropdown list that appears.
    • Leave the default value for Display chart values and Display chart legend.
    • Click the dropdown arrow next to Refresh Interval and select Every 15 Minutes.
    • Click Save.
    • Click the version dropdown arrow next to Unscheduled and select 2.0.
    • The gadget will display the 'Hours' burndown chart. Click the Issues tab to see the issues burndown chart.
      (The burndown charts will become more interesting when you have more issues in your project.)
  7. Choose a different colour for your GreenHopper Agile Gadget:
    • Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
    • Select the green 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.

Step 7. Create a Bonfire Test Session

You can use Bonfire to create issues directly in JIRA while manually testing a web application. First you will add a test session, where you can plan and track your testing.

  1. Click Projects at the top left of your JIRA screen.
  2. The 'Summary' page for the 'Dragons' project will appear. Click the Test Sessions tab in the left-hand panel.
  3. The 'Test Sessions' page will appear. Click Create Session and enter the following information:
    • Name: Find the exploding fire extinguishers
    • Assignee: charlie
    • Related Issue: DRA-2
    • Additional Information: Exploding fire extinguishers are dangerous. Let's find them all!
  4. Click Create to add the test session.
  5. Click the name of your new test session: Find the exploding fire extinguishers.
  6. The session details will appear. Click Start.
  7. Now you need to go to the page in the application that you are testing. For this exercise, you will use Bitbucket as your test case. Open a new window or tab in your browser and go to the Bitbucket website.
  8. A side panel will open on the left, asking for information about your JIRA Server. (If the side panel does not open, click the Atlassian Bonfire icon  in the top right corner of your browser.) Enter the following information:
    • Server URL – Enter the URL of your Dragon Slayer JIRA site. For example: http://www.foobar.com:8080/
    • Username: charlie
    •  Password – Enter Charlie's password.
    • Click Save.

Screenshot 5 (click to enlarge): Bonfire side panel preparing to test an application (Bitbucket, in this case)


Full details are in the Bonfire user's guide.

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

Step 8. Report a Bug via Bonfire

 Now you will find a bug in the application that you are currently testing, and use Bonfire to add an issue to JIRA. For this exercise, the application being tested is Bitbucket.

  1. Make sure that you are still in the browser window that shows the Bitbucket website.
  2. Click Attach Screenshot in the left-hand panel that Bonfire has added to your browser window.
  3. A thumbnail picture of the screen appears under 'Attach Screenshot', and the right-hand panel of the browser window becomes your screenshot annotation tool. Use your mouse to drag a square around the Bitbucket icon (a picture of a blue bucket) at the top left of the Bitbucket screen. See screenshot 6.
  4. Enter the following information in the Bonfire panel on the left of the window:
    • Summary: I think I found one
    • Description: A bucket will explode when rapidly filled with dragon fire!
    • Fix version/s: 2.0
  5. Click Create Issue. Bonfire will add a new issue 'DRA-4' to JIRA.
  6. Go back to the JIRA browser window showing the test session details, and refresh the page. The new issue 'DRA-4' will appear in the activity list.
  7. Click Complete.
  8. A dialog box will appear. Select the All checkbox.
  9. Click Complete Session.

Screenshot 6 (click to enlarge): Creating a bug with Bonfire


 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 3 gadgets:

  • The GreenHopper 'Agile Gadget'
  • The 'Assigned to Me' gadget
  • The 'Projects' gadget

Screenshot 7 (click to enlarge): JIRA dashboard with 3 gadgets

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

Don your chain mail and move to the next stage

Attachments:

GreenHopperPlanningBoardDefault.png (image/png)
GreenHopperPlanningBoardv20.png (image/png)
GreenHopperPlanningBoardv20.png (image/png)
JIRADashboard3Gadgets.png (image/png)
JIRADashboard3Gadgets.png (image/png)
GreenHopperPlanningBoardDefaultV2.png (image/png)
GreenHopperPlanningBoardUpdatedV2.png (image/png)
JIRADashboard3GadgetsV2.png (image/png)
GreenHopperPlanningBoardDefault.png (image/png)
GreenHopperPlanningBoardStory.png (image/png)
GreenHopperPlanningBoardUpdated.png (image/png)
JIRADashboard3Gadgets.png (image/png)
JIRADashboard3Gadgets.png (image/png)
GreenHopperPlanningBoardDefault.png (image/png)
GreenHopperPlanningBoardStory.png (image/png)
GreenHopperTaskBoardv20.png (image/png)
GreenHopperTaskBoard-v5.png (image/png)
GreenHopperPlanningBoardStory-v5.png (image/png)
JIRADashboard3Gadgets-v5.png (image/png)
GreenHopperPlanningBoardDefault-v6.png (image/png)
GreenHopperTaskBoard-v6.png (image/png)
GreenHopperPlanningBoardStory-v6.png (image/png)
GreenHopperPlanningBoardDefault-v7.png (image/png)
GreenHopperTaskBoard-v7.png (image/png)
GreenHopperPlanningBoardStory-v7.png (image/png)
JIRADashboard3Gadgets-v7.png (image/png)
JIRADashboard3Gadgets-v7.png (image/png)
GreenHopperPlanningBoardStory-v7.png (image/png)
GreenHopperTaskBoard-v7.png (image/png)
GreenHopperPlanningBoardDefault-v7.png (image/png)
GreenHopperPlanningBoardStory-v6.png (image/png)
GreenHopperTaskBoard-v6.png (image/png)
GreenHopperPlanningBoardDefault-v6.png (image/png)
JIRADashboard3Gadgets-v5.png (image/png)
GreenHopperPlanningBoardStory-v5.png (image/png)
GreenHopperTaskBoard-v5.png (image/png)
GreenHopperTaskBoardv20.png (image/png)
GreenHopperPlanningBoardStory.png (image/png)
GreenHopperPlanningBoardDefault.png (image/png)
JIRADashboard3Gadgets.png (image/png)
GreenHopperPlanningBoardUpdated.png (image/png)
JIRADashboard3GadgetsV2.png (image/png)
GreenHopperPlanningBoardUpdatedV2.png (image/png)
GreenHopperPlanningBoardDefaultV2.png (image/png)
GreenHopperPlanningBoardv20.png (image/png)
BonfireSettings.png (image/png)
GHGettingStarted.png (image/png)
GreenHopperTaskBoard-v7.png (image/png)
GreenHopperPlanningBoardStory-v7.png (image/png)
BonfireIcon.png (image/png)
BonfireBitbucket.png (image/png)
BonfireBitbucketAnnotate.png (image/png)
JIRADashboard3Gadgets-v7.png (image/png)