AWS CodeCommit Git Listener Documentation

Installation

AWS CodeCommit Git Listener is available for any Jira Cloud installation. Just log in to your Jira account, go the AWS CodeCommit Git Listener for Jira Atlassian Marketplace page, and click the button to install the plugin.

Configuration

Once AWS CodeCommit Git Listener is installed, find it in the list of your installed apps in Jira and press the "Configure" button.

Now you need to link your AWS CodeCommit repositories to Jira. In order to do that, provide your Access Key ID and your Secret Key that you can find or create in your AWS console. We recommended assigning the following permissions to the user that you will link to AWS CodeCommit Git Listener: AWSCodeCommitPowerUser and AmazonSNSFullAccess.

AWS CodeCommit Git Listener will automatically detect all Git repositories that your AWS account has access to and display them on the configuration page. You can configure which of the repositories you want to link to Jira, and see when AWS CodeCommit Git Listener last checked them for new data.

If you need to update the credentials used to link AWS CodeCommit Git Listener to your AWS repositories, you can always return to AWS CodeCommit Git Listener configuration page and click "Re-configure AWS integration".

Using AWS CodeCommit Git Listener for Jira

As soon as the configuration is finished, you are ready to use AWS CodeCommit Git Listener. Just navigate to any issue in your Jira project, and you will see Azure Git menu option on the right.

Click on it, an it will display all the Git commits, branches, and pull requests linked to your Jira issue. Linking is done via issue keys (e.g. PROJ-123). That means you will need to include issue keys in your commit and pull request titles, and branch names in order for them to be picked up by AWS CodeCommit Git Listener.

Further information

Feel free to contact us via our feedback form if you have any questions.