How to integrate AWS CodeCommit with Buddy

May 4, 2020


How to integrate AWS CodeCommit with Buddy
In this article we will show you how to integrate Buddy with AWS CodeCommit, Amazon's Git-based version control solution.

Step 1: Synchronizing repository

  1. At the moment, CodeCommit is not availabe from the source provider list. To add it, start with creating a new project and selecting the private Git server:

Source provider selection listSource provider selection list

  1. Then, in the Repository URL field, enter the SSH address of your CodeCommit repository:

CodeCommit repository detailsCodeCommit repository details

  1. Now we need to authenticate Buddy in your AWS account. To do that, download the SSH key displayed on the creation screen:

Custom repository configuration screenCustom repository configuration screen

  1. Log in to your Amazon IAM settings and add the key by clicking Upload SSH public key:

CodeCommit security credentialsCodeCommit security credentials

Once you add the key, you should see something like this:

CodeCommit keys listCodeCommit keys list

  1. Now, copy the key ID and paste it at the beginning of the repository URL in the following format (see point 3 for comparison):

Repository address with SSH key IDRepository address with SSH key ID

  1. Click Create a new project to finish configuration. After a while, your repository should be successfully synchronized.

Synchronization processSynchronization process

Step 2: Configuring repository webhook

  1. The last step is making sure that Buddy is informed about changes pushed to your CodeCommit repository. Go to your repository settings on AWS and click NotifyCreate notification rule:

Creating AWS notification ruleCreating AWS notification rule

Enter the name and configure the details according to the screenshot below. Select SNS Topic as the target and click Submit when ready:

AWS notification rule configurationAWS notification rule configuration

SNS is a tool used by Amazon to send notifications. If you don't have any topic configured, you need to create it first.

Notification rule settings:

# Detail type:
- Full
# Events:
- Comments: On commits, On pull requests
- Branches and tags: Created, Deleted, Updated
  1. With the rule configured, go to Code where you'll find the synchornization and activity details for the connected repository. Click the hamburger button and select Fetch missing commits only.

The hamburger buttonThe hamburger button

  1. Copy the refresh webhook – we will need it shortly:

Copying the webhookCopying the webhook

  1. Go back to Amazon and switch to the Simple Notification Service (SNS). Look up the topic that you created, click Create subscription, and paste the webhook from Buddy in the Endpoint field:

Amazon SNS subscription creationAmazon SNS subscription creation

  1. With the subscription created, go back to Code in Buddy. On the activity list in the Deliveries tab, you should see a registered webhook from Amazon. Copy the address from the "SubscribeURL" line of the webhook log and open it in your browser. This operation will confirm the topic.

  2. Finally, you can check if everything is working in the Amazon console:

Subscriptions in the AWS consoleSubscriptions in the AWS console

Congratulations! You have successfully integrated your AWS CodeCommit repository with Buddy! 🍾

Related read

  • Deployment to AWS – learn how to configure a deployment pipeline to EC2, S3, Elastic Beanstalk, CodeDeploy, and Lambda services.
  • AWS integration – learn how to properly integrate Amazon services with Buddy using access & secret keys, or role assumption.
  • AWS policies – the list of policies required by Buddy to integrate with AWS
Alexander Kus

Alexander Kus

Customer Success Manager

A story-teller and conversation-lover, Alexander decided to invest his skills to help his friends at Buddy transform the cold language of patch notes into exciting narratives. Also: an avid gamer, hip-hop DJ, Liverpool FC fan, absentminded husband, and the father of two.

With Buddy even the most complicated CI/CD workflows take minutes to create

Sign up for Buddy CI/CD

Start a free trial