Tracking Salesforce metadata changes in AWS CodeCommit

Kevin Boyle on June 19th 2017


Amazon Web Services, commonly known as AWS, powers vast swathes of the internet. The rock solid security and reliability explain why even Salesforce have entered into a partnership and deploy several Salesforce clouds inside AWS data centers.

One of the services that AWS offers is git repository hosting, branded as AWS CodeCommit. AWS CodeCommit offers git hosting that is tied into the authentication and user management features of the AWS platform so works great for teams that are already invested into the ecosystem.

Gearset now has first class support for AWS CodeCommit as a way to track changes to your Salesforce metadata and this article walks you through how to get started.

Provisioning your AWS CodeCommit repository

If you already use AWS CodeCommit and are familiar with IAM, Access Keys and all the other AWS bits and pieces then you can skip this section.

The first thing you need to do is make sure you have a user properly configured in AWS IAM that can access AWS CodeCommit. This will most likely be your existing AWS IAM user that you use to access the Management Console, but you can also create a new user specifically for git. In either case, you need to assign that user the AWSCodeCommitFullAccess policy and you’ll also need to create an Access Key Id and Access Key Secret to authenticate as that user.

Creating an IAM user

After properly configuring your user to have the AWSCodeCommitFullAccess policy, we can create a repository:

Step 1: Navigate to the CodeCommit service

AWS Management Console

Step 2: Select Create repository and enter the necessary details

Creating your AWS CodeCommit repository

That’s it! Very simple. Now we can grab the HTTPS clone URL for this repository

Now the repository is ready to clone

Adding your AWS CodeCommit repository to Gearset

Gearset has support for a wide array of code hosting solutions, and you can manage them all from the Manage orgs page in Gearset.

To get started with AWS CodeCommit, simply select Connect to AWS from the Manage linked services list.

Adding AWS CodeCommit to Gearset

Fill in your Repository URL, Access Key and Access Key Secret and test the connection to make sure it works.

Adding AWS CodeCommit to Gearset

Running your first comparison

Once successfuly configured, your AWS CodeCommit repository can be used as the source or target location of your metadata.

Now we can compare orgs with AWS CodeCommit

Here at Gearset, we've spent the last number of years promoting source controlling Salesforce metadata as a robust and reliable way to track changes across your orgs and environments. If you're new to source control or want to get advice on best practice around arranging your repository then you can download our whitepaper.

If you haven't had a chance to try Gearset and want to start tracking your metadata in GitHub, GitLab, BitBucket, TFS or AWS CodeCommit then log in now to start your completely free 30 day trial.

Ready to get started with Gearset?

Sign up now to start your completely free 30 day trial
try it now