Skip to main content
All CollectionsTeam managementTeam Collaboration
Team-shared source control connections
Team-shared source control connections

What is a team-shared source control (VCS) connection? And how do I connect one to my Gearset account?

Quinn Kuiper avatar
Written by Quinn Kuiper
Updated over a week ago

What is a team-shared source control connection used for?

Within Gearset the team-shared source control connections are only used in team-shared continuous integration jobs or team-shared pipelines.

These connections are managed by the team owners on each Gearset team.

What account should I use for a team-shared connection?

We recommend a service account for the team-shared connection. This way all CI jobs and jobs within a team-shared pipeline will be done under this account.

How do I add a team-shared connection to Gearset?

You can add a team-shared connection in the same way as you add a normal connection.

From the Source control and services page scroll down to the Team-shared services for continuous integration section, and select your source control provider. Then follow the on-screen instructions.

For more information on how to connect to each source control provider, please see this selection of articles: Managing source control connections.

Can I change my team-shared source control connections account?

While theoretically possible, you should not change your source control connections account.

This account should not be linked to any individual and therefore should not be changed. Doing this could result in any current team-shared CI jobs being unable to run successfully.

What is a service account?

A service account is used to perform source control actions on behalf of a Continuous Integration system.

A service account is a type of account that is not tied to an individual human user. Service accounts are used when the credentials must be set up and maintained without being impacted by changes in the team. This account is created and managed outside of Gearset in your source control provider.

What is a personal connection?

A personal connection is where the account is linked to a named individual connected to a human user on the team. These are unique for each user on the team.

Can I set up a custom Git repository as a team-shared one?

Yes. Gearset allows you to add a custom Git connection (repository) in our app as a team-shared Git connection.

You can connect it on the Source control and services page (at the very bottom) by selecting Add new custom Git repository:

What are the limitations of custom Git connections?

Custom Git connections cannot be used with Vlocity or Gearset Pipelines in our app. To use these solutions a full Version Control System (VCS) connection is required.

Our app will display a pop up window with information required of you to configure a custom Git connection, along with a warning about limitations of this connection type.

Note: We have a separate article where you can read more about limitations of custom Git connections.

Did this answer your question?