Deploy Salesforce metadata to almost any source control repository

Jason Mann on April 19th 2017


Gearset has supported integration with source control via OAuth for some time. With our latest release, you can now add connections to any custom git-based repository using a username/password connection. If it’s accessible to our app, you can deploy to it!

To add a new git connection, head to the manage orgs page and click Add new git repository.

If it runs on git, we support it

Gearset uses native git behind the scenes when talking to source control systems. Until now, we’ve limited source control connections to the OAuth method - this provides the greatest control, ease of use, and security for our users.

We’ve always been a feedback-driven team. One of the most requested features on our feedback forum was adding support for GitLab as the target of a comparison. Due to limitations of how GitLab implements OAuth, we were unable to support this via our existing OAuth flow. To fix this, we decided to enhance our git support across the app.

With custom git support via username/password, you can now use GitLab as the target of your comparisons and deployments, allowing you to seamlessly migrate metadata to and from your repositories in the hosted app.

In fact, you can connect to any git-based source control repository to which Gearset has access. If you’re using an on-premise solution and can open a firewall port for our static IPs - 52.30.99.114, 34.246.69.148, 34.246.80.170, and 52.208.77.76 - you can now configure Gearset to connect to it and manage your metadata.

Adding a custom git connection
  1. Open the manage orgs page in the app
  2. Under the Manage custom git repositories section, click Add new git repository
  3. Enter your username and password, and specify the URL for the repository
  4. Click Add to save the connection

Adding a custom git connection in Gearset

Your connection will now be listed in the manage orgs page.

Viewing a saved git connection

Note: If your account uses 2FA, you may need to create a custom application password for Gearset to connect to your repository.

Running a comparison using a custom git connection
  1. Select Source control as the metadata location type
  2. Choose Custom git from the dropdown
  3. Select the saved connection to use
  4. Enter name of the branch you wish to connect to
  5. Choose the other metadata location as usual, then click Compare now

Selecting a git repo for your comparison

Support for automation jobs coming soon

For now, custom git connections can only be used on manual comparisons/deployments. We’re planning to expand our support for custom git into our automation jobs in the future, allowing you to set up CI jobs using these saved credentials.

Of course, we always prioritise our work based on user feedback. If you’d like to see support for automation job custom git sooner rather than later, head over to our feedback site and create or upvote a suggestion.

Ready to get started with Gearset?

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