All documentation

AWS CodeCommit Git Listener for Jira

Setup & usage guide

Installation

AWS CodeCommit Git Listener is available for any Jira Cloud installation. Sign in to your Jira account, open the AWS CodeCommit Git Listener for Jira page on the Atlassian Marketplace, and click Install.

Atlassian Marketplace
AWS CodeCommit Git Listener on the Atlassian Marketplace

Configuration

After installation you'll be prompted to configure AWS CodeCommit Git Listener. You can also reach the configuration page at any time from your organization's app management page — open Connected apps, find the app, and choose Configure.

Provide your Access Key ID and Secret Key, which you can find or create in your AWS console. We recommend assigning the following permissions to the user you link: AWSCodeCommitPowerUser and AmazonSNSFullAccess.

Link repositories
Link AWS CodeCommit repositories

AWS CodeCommit Git Listener automatically detects the repositories your AWS account can access and lists them on the configuration page. Choose which repositories to link, and see when each was last checked for new data. To update your credentials, return to the configuration page and click Re-configure AWS integration.

Configure repositories
Configure AWS CodeCommit repositories

Use scoped, least-privilege credentials. The app reads metadata only and never clones your code. See the security overview.

Using AWS CodeCommit Git Listener for Jira

Once configured, open any issue in your Jira project and you'll see the AWS CodeCommit panel on the right. It shows all commits, branches and pull requests linked to the issue.

Linking is done via issue keys (e.g. PROJ-123) — include the issue key in commit messages, branch names and pull-request titles so they're picked up.

Issue view
AWS CodeCommit Git Listener panel on a Jira issue

Further information

Have a question or need a hand? Reach out via our feedback form and we'll be happy to help.