Managing Jira projects in CodeCatalyst - Amazon CodeCatalyst

Managing Jira projects in CodeCatalyst

To manage a Jira project in CodeCatalyst, you must first link the Jira project to your CodeCatalyst project. Then, you can add and use Jira issues to a CodeCatalyst pull request in a CodeCatalyst project. Before you can link a Jira project, you must connect the Jira site that the project belongs to with your CodeCatalyst space. For more information, see Connecting a Jira site to a CodeCatalyst space.

If you no longer want to use a Jira project in CodeCatalyst, you can unlink it from your CodeCatalyst project. When a Jira project is unlinked, Jira issues will not be available in the CodeCatalyst project, and CodeCatalyst Issues will be the issue provider again.

Important

To link your Jira project to your CodeCatalyst project, you must be the CodeCatalyst Space administrator or CodeCatalyst Project administrator.

You can use linked Jira projects to manage issues and to link CodeCatalyst pull requests to a Jira issue. Summary status of a pull request and the status of associated CodeCatalyst workflow events are reflected in your Jira issue.

Note

A CodeCatalyst project can only be linked to one Jira project. A Jira project can be linked to multiple CodeCatalyst projects.

To link a Jira project to a CodeCatalyst project from the Jira Software extension details page
  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 The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. in the top menu.

  4. In Jira Software, choose Configure.

  5. In the Linked Jira projects tab, choose Link Jira project.

  6. From the Jira site drop-down menu, choose the Jira site that contains the project that you want to link.

  7. From the Jira project drop-down menu, choose the project you want to link to a CodeCatalyst project.

  8. From the CodeCatalyst project drop-down menu, choose the CodeCatalyst project you want to link to a Jira project.

  9. Choose Link.

Once a Jira project is linked to a CodeCatalyst project, access to CodeCatalyst issues is disabled entirely, and Issues in the CodeCatalyst navigation pane will be replaced with a Jira issues item that links to the Jira project.

Unlinking a project doesn't delete the Jira project, including planning items or development information, or make any changes to it. However, once you unlink a Jira project, the project's Jira issues will no longer be available to link to the CodeCatalyst project.

To unlink a Jira project
  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 The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. in the top menu.

  4. In the Linked Jira projects tab, choose the Jira project you want to unlink.

  5. Choose Unlink Jira project.

  6. In the Unlink dialog box, review the effects of unlinking the repository.

  7. Enter unlink into the text input field and choose Unlink.