For the latest version of this help, see: https://help.apptio.com/en-us/cloudability/admin/connect-jira-cloud.html

This guide will help you set up your Jira Cloud instance within Cloudability.

Prerequisites

Before you begin the process, ensure that:

1. Your organization is using Jira Cloud (versus Jira Server)
2. You are a Cloudability administrator
3. The administrator for your Jira instance is available during the setup process
4. You have the site name for your Jira instance

Cloudability Setup

Once you've identified your site name, you'll be ready to add your Jira credentials to Cloudability.

Adding Jira Credentials

1. Select the Gear Icon in the top right and under App Settings, select Vendor Credentials.
   
   
   
2. Select the Jira tab, above the toolbar.
   
   
3. If this is the first time adding Jira credentials to Cloudability, select Yes, I'm ready.
   
   
   
4. Proceed to Step 2 to enter your site name.
   
   
   
5. Enter the site name of your Base URL.
   
   
   
6. Next, install the Cloudability add-on in the Atlassian Marketplace by selecting "install the Cloudability add-on" link below the Base URL.
   
   
   
7. You will be redirected to the Atlassian Marketplace.
   
   
   
8. Select Installation.
   
   
   
9. You will see the below instructions. Continue to Step 10 to get step-by-step screenshots for all remaining installation steps.
   
   
   
10. Log in to your Jira instance as admin and select the Gear Icon.
    
    
    
11. Select Add-ons.
    
    
    
12. Select Find new add-ons.
    
    
    
13. Search for "cloudability".
    
    
    
14. Select Install.
    
    
    
15. Select Accept & install to confirm the installation.
    
    
    
16. When add-on installation is complete, you will see the below dialogue box. 
    
    
    
17. Once you've completed connecting your Jira instance with Cloudability, you will see the below status on the Vendor Credentials page.