Integration Guide

aws codecommit logo AWS CodeCommit Integration

AWS CodeCommit is a git host service by Amazon Web Services to store and manage source code, related files and private Git repositories in the cloud.

helpful tip
You can use the AWS CLI or the AWS CodeCommit console to track and manage your repositories.

Connecting to an AWS CodeCommit Repository (JIRA Cloud)

This process requires an existing AWS CodeCommit repository.

Auto-Connect

To connect your repository to JIRA thru the Git Integration for JIRA Cloud add-on, open the Connect to Git Repository wizard:

  1. On the JIRA navbar, click Git .
  2. Select Manage Git Repositories.
  3. On the following screen, click Connect to Git Repository.
  4. Clicking the dropdown arrow will display supported git host-specific connection setup. You can also use the Auto-connect panel for automatic integration of git repositories. Git for JIRA Cloud Auto-Connect panel Click a git host icon on the Auto-connect panel to start connecting the git repositories for the selected git host. For this case, click on the AWS CodeCommit icon.
  5. On the following screen, select a Region then enter credentials for Access key ID and Secret access key.
  6. Click Next to continue.
  7. Click OK to complete this process.

The Git Integration for JIRA Cloud add-on supports tracked folders for AWS CodeCommit git repositories. The connected git host is scanned for existing repository folders.  The found repositories can then be added to the Git Repositories configuration.

There are two ways to configure the git repository connection using tracked folders with Git for JIRA Cloud:

  • connect via Auto-connect integration panel > AWS CodeCommit, or
  • connect via Connect to Git Repository dropdown > AWS CodeCommit.

If the connected git host has newly added repositories, the Git add-on will automatically add them to the git repositories configuration on the next reindex.  For the deleted git repositories, these will be removed from the Git add-on repositories configuration on the next reindex.

HTTP/HTTPS Connections
  1. Use the host HTTP/HTTPS URL of your AWS CodeCommit repository.  For example, http://git-codecommit.us-east-1.amazonaws.com/v1/repos/test-repo and paste it on the Connect to Git Repository screen.
  2. Git for JIRA Cloud connect to AWS CodeCommit screen
  3. On the Authentication screen, enter the Access Key ID as the username then the Secret Access Key as the password.
  4. Git for JIRA Cloud - Connect to Git Repository - AWS CodeCommit authentication screen
  5. Click Connect.
  6. On the Permissions dialog, set Repository Browser and Project Association permissions, if required.  Click Next.
  7. Click Finish.
SSH Connections

SSH connections are handled automatically if the PUBLIC KEY was added in the AWS IAM console and the associated PRIVATE KEY was added/uploaded on the JIRA side (Git Integration for JIRA > SSH Keys > Add SSH Key).

If authentication issues are encountered during connecting an AWS repository to JIRA, modify the original URL by inserting the SSH Key ID as the username.  The SSH Key ID is an alphanumeric sequence provided by AWS IAM when importing a PUBLIC KEY for a particular user account in IAM.

For example, the original URL is:

ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/test-repo

If the SSH Key ID 1a2b3c4d5e is applied to the original SSH URL, the resulting URL would be:

ssh://1a2b3c4d5e@git-codecommit.us-east-1.amazonaws.com/v1/repos/test-repo

The modified URL can now be used as a valid repository URL via Git Integration for JIRA > Connect to Git Repository.