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.
After properly configuring your user to have the
AWSCodeCommitFullAccess policy, we can create a repository:
Step 1: Navigate to the CodeCommit service
Step 2: Select
Create repository and enter the necessary details
That’s it! Very simple. Now we can grab the
HTTPS clone URL for this repository
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.
Fill in your
Access Key and
Access Key Secret and test the connection to make sure it works.
Running your first comparison
Once successfuly configured, your AWS CodeCommit repository can be used as the source or target location of your metadata.
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.