Managing Jira sites in CodeCatalyst

To manage Jira projects in CodeCatalyst, you must connect your Jira sites to your CodeCatalyst space. If you no longer want to use a Jira site's projects in CodeCatalyst, you can disconnect that Jira site. When a Jira site is disconnect, Jira issues from the site's projects will not be available in the CodeCatalyst projects, and CodeCatalyst Issues will be the issue provider again.

Important

To connect or disconnect your Jira site and your CodeCatalyst space, you must be both the Jira site administrator and the CodeCatalyst Space administrator.

Contents

• Connecting a Jira site to a CodeCatalyst space
• Disconnecting a Jira site from a CodeCatalyst space

Connecting a Jira site to a CodeCatalyst space

Perform the following steps to connect a Jira site to your CodeCatalyst space.

To connect your Jira site to CodeCatalyst

1. Open the CodeCatalyst console at https://codecatalyst.aws/.

2. Navigate to your CodeCatalyst space.

3. Do one of the following to view the installed Jira Software extension for your space:

   1. Choose Settings, and then choose Installed extensions.

   2. Choose the Catalog icon in the top menu.

4. In Jira Software, choose Configure.

5. In the Connected Jira sites tab, choose Connect Jira site to go to the external site for Atlassian Marketplace.

6. Choose Get it now to get started with installing CodeCatalyst on your Jira site.

   Note

   If you previously installed CodeCatalyst to your Jira site, you will be notified. Choose Get started to be taken to the final step.

7. Depending on your role, do one of the following:

   1. If you are a Jira site administrator, from the site drop-down menu, choose the Jira site to install the CodeCatalyst application, and then choose Install app.

      Note

      If you have one Jira site, this step won't appear, and you'll automatically be directed to the next step.

   2. 1. If you aren't a Jira administrator, from the site drop-down menu, choose the Jira site to install the CodeCatalyst application, and then choose Request app. For more information on installing Jira apps, see Who can install apps?.

      2. Enter the reason you need to install CodeCatalyst into the input text field or keep the default text, and then choose Submit request.

8. Review the actions performed by CodeCatalyst when the application is installed, and then choose Get it now.

9. After the application is installed, choose Return to CodeCatalyst to return to CodeCatalyst.

After connecting your Jira site to CodeCatalyst, you can view the connected site in the Connected Jira sites tab of the Jira Software extension details page.

Disconnecting a Jira site from a CodeCatalyst space

Perform the following steps to disconnect a Jira site from your CodeCatalyst space.

Note

To disconnect a Jira site, you must first unlink all linked Jira projects from that account. For more information, see Unlinking a Jira project from a CodeCatalyst project.

To disconnect a Jira site

1. Open the CodeCatalyst console at https://codecatalyst.aws/.

2. Navigate to your CodeCatalyst space.

3. Do one of the following to view the installed Jira Software extension for your space:

   1. Choose Settings, and then choose Installed extensions.

   2. Choose the Catalog icon in the top menu.

4. In Jira Software, choose Configure.

5. In the Connected Jira sites tab, choose the Jira site that you want to disconnect.

6. Choose Disconnect Jira site.

7. In the Disconnect dialog box, review the effects of disconnecting the site.

8. Enter disconnect into the text input field, and then choose Disconnect.