This page last changed on Jan 04, 2011 by alui.


You are embarking on stage 7 of the Atlassian Dragon Quest. Remember, the most important piece of equipment is your shield. If you must make a choice between a sword and a shield, take the shield!

In this stage you will configure JIRA and Crucible, so that you will be able to create a review, add comment to the review and then create a JIRA issue from that review comment. You'll also add a Crucible gadget to your JIRA dashboard.

Time estimate: This stage will take approximately 45 minutes.

On this page:

Step 1. Enable Sub-Tasks for Crucible

In this step, you will configure your FishEye/Crucible-JIRA application link to enable sub-tasks for Crucible. This is required for creating JIRA issues from Crucible reviews.

  1. Go to your FishEye/Crucible URL in your web browser, e.g. http://localhost:8060/.
  2. Click the username (i.e. 'Charlie of Atlassian') then 'Administration' from the dropdown menu, to go to the FishEye/Crucible Admin screens.
  3. Click 'Application Links' in the left-hand panel.
  4. Click 'JIRA Settings' next to your 'Dragons JIRA' application link.
  5. The 'Update JIRA settings' screen will appear. Select the 'Use Basic Authentication' checkbox and enter the login details for charlie.
  6. Click the 'Test' button in the 'Subtask Settings'. The page will refresh, however the 'Subtask Settings' section will display different controls. Enter the following information:
    • Subtask Type – Select 'Technical task'.
    • Subtask Resolution Action ID: 2
    • Subtask Resolution – Leave unchanged.
    • Allow Unassigned – Leave unchanged.
  7. Click 'Save'.

Screenshot 1 (click to enlarge): Crucible-JIRA application link with sub-tasks configured

Full details are in the Crucible documentation.

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Step 2. Create a Crucible Project and Link Your Crucible Project to Your JIRA Project

Next, you will create a Crucible project and link it to your JIRA project.

  1. Go to your FishEye/Crucible URL in your web browser, e.g. http://localhost:8060/.
  2. Click the username (i.e. 'Charlie of Atlassian') then 'Administration' from the dropdown menu, to go to the FishEye/Crucible Admin screens.
  3. Click 'Projects' in the left-hand panel.
  4. The 'Projects' screen will appear. Click 'Create a New Project'.
  5. The 'Edit Project' screen will appear. Enter the following information:
    • Name: Dragons
    • Key: DRA
    • By default, allow anyone to join reviews after creation – Select this checkbox.
  6. Leave all other fields at their default values and click 'Save'.
  7. The 'Projects' screen will appear again, displaying your 'Dragons' project.
  8. Click 'Application Links' in the 'Operations' column next to your 'Dragons' project.
  9. The 'Dragons Application Links' screen will appear. Click 'Add Link' and click 'Dragons JIRA (JIRA)' in the dropdown menu that appears.
  10. The 'Enter link details' screen will appear. Enter the following information:
    • Key: DRA
    • Alias: Dragons
  11. Click 'Create'.

Screenshot 2 (click to enlarge): Crucible Dragons Project linked to JIRA Dragons Project

Full details are in the Crucible documentation.

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Step 3. Create a Review

In this step, you will create a Crucible review from the dashboard activity stream and create a comment in that review.

  1. Click the 'Dashboard' tab in FishEye/Crucible.
  2. Click the 'Activity' tab on the dashboard, if it is not already active, to display the activity stream.
  3. Find changeset '153936' committed by 'drosen' in the activity stream. Click the cog icon next to the date for the commit and click 'Create Review' in the menu that appears.
  4. The 'Edit Review Details' screen will appear. Click 'Start Review'.
  5. Click 'Confirm' at the warning screen. The 'DRA-1' review screen will appear.
  6. Click 'ExampleMacro.java' under 'trunk/src/main/java/com/atlassian/dragons' in the file tree on the left. The code for this file will appear in the right panel.
  7. Scroll down to line 21 in the code and click the '21'.
  8. A text area will open for you to enter a comment. Add the comment as follows:
    • Enter the following text in the text area: This comment does not mention dragons. Please amend the text.
    • Defect – Select this checkbox
  9. Click 'Post' to post your review comment. The review comment will appear.

You can now view your review in the 'Reviews' tab on your 'DRA-1' JIRA issue. Open your 'DRA-1' issue and click the 'Reviews' tab. The tab shows the reviews related to the issue, i.e. the reviews involving changesets related to the issue.

Screenshot 3 (click to enlarge): Reviews tab on a JIRA issue

Step 4. Create a JIRA Issue from a Crucible Review

Next, you will reopen JIRA issue DRA-1 so that you can create subtasks for it, then create the JIRA subtask from the comment in your Crucible review, and resolve the issue via Crucible.

  1. Go to your JIRA URL in your web browser, e.g. http://localhost:8080/.
  2. Click the arrow next to 'Issues' in the top navigation bar. Click the 'DRA-1' issue under the 'Recent Issues' in the dropdown that appears.
  3. Click 'Reopen issue'
  4. The 'Reopen issue' screen will appear. Click 'Reopen issue'.
  5. Go to your FishEye/Crucible URL in your web browser, e.g. http://localhost:8060/.
  6. The FishEye/Crucible dashboard will appear. Click 'commented' in the 'commented on DRA-1' text in the activity stream.
  7. The review comment will appear. Click the 'Create Issue' link in the comment panel.
  8. The 'Create Issue' panel will appear. Leave the 'Summary' and click the 'Assign to Me'.
  9. Click 'Create'. The page will refresh. The key of your new issue (DRA-4) will be displayed in the review comment with a status of 'Open'.
  10. Click the issue key, 'DRA-4'. The issue will be displayed in JIRA on your page.
  11. Click the back button of your browser to view your review again.
  12. Click the 'Resolve' link next to the issue key in your review comment. The status of the issue in the review comment will change to 'Closed'.
  13. Click the issue key, 'DRA-4'. The issue will be displayed in JIRA on your page with a status of 'Closed'.

Screenshot 4 (click to enlarge): Closed JIRA issue displayed in a Review comment

Step 5. Add a Crucible Gadget to JIRA

Now you will add the 'Crucible Charts' gadget to your Dragon Development Dashboard.

  1. Go to your JIRA URL in your web browser, e.g. http://localhost:8080/.
  2. Click 'Dashboards' at top left of your JIRA screen.
  3. Your 'Dragon Development Dashboard' will appear. Click 'Add Gadget'.
  4. The 'Gadget Directory' will appear, showing a list of the available gadgets for your JIRA dashboard. Enter 'Crucible' into the search box at top right of the Gadget directory screen.
  5. The list of gadgets will change, to show only the gadgets that match your search term. Find the 'Crucible Charts' 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.
  6. Click 'Finished' to go back to your dashboard.
  7. Configure the 'Crucible Charts' gadget:
    • Enter 'DRA' in the 'Crucible Project Key' field.
    • Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
    • Click 'Save'.
  8. Choose a different colour for your 'Crucible Charts' gadget:
    • Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
    • Select the dark blue square in the row of colours.

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Victory!

Your JIRA dashboard now has 6 gadgets:

  • The 'Crucible Charts' gadget
  • The 'FishEye Charts' gadget
  • The Confluence 'Activity Stream' gadget
  • The 'Assigned to Me' gadget
  • The 'Projects' gadget
  • The GreenHopper 'Agile' gadget

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



Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Grab a Bigger Sword and Move to the Next Stage

Document generated by Confluence on Feb 27, 2011 17:37