Skip to main content

Which Git credentials are used for which actions in Pipelines?

Expected behavior for using individual versus team-shared Git credentials during automated pipeline use.

Sam Wilson avatar
Written by Sam Wilson
Updated yesterday

During the setup of an automated pipeline, you're instructed to use an integration user within Git. These credentials are then used to create the Pipeline. Each user of the Pipeline is then expected to add their own individual Git credentials. We use these credentials the majority of the time.

We do this so that the history of actions in Git is as accurate as possible. You'll know which user initiated each action.

However, we don't always use team-shared credentials for pipeline actions (there are two exceptions), and this article confirms when to expect this to occur.

Manual indicates a user-initiated action, while Automatic indicates an automatic behavior not directly triggered by the user's action. All of the actions listed below are taken in Gearset, not directly in Git.

Individual Git credentials:

  • The user who clicked the button:

    • Manual branch creation (and subsequent promotion branch creation)

    • Manual PR creation (and subsequent promotion PR creation)

    • Manual Release branch creation

    • Manual closing of PR

    • Manual Release PR merge/promotion

    • Automatic closing of PR (due to release branch creation)

  • The user who originally created the PR:

    • Manual PR promotion

    • Automatic reopening of PR (due to release branch abandon)

Integration Git credentials (team-shared):

  • Manual Sync-PR creation.

  • Automatic branch deletion.

Note: Should a change occur with a Gearset user (e.g., someone removes their individual Git credentials, or their entire user is removed), then Gearset may need to automatically revert to using the "Integration Git credentials" instead.

This will depend on the availability of the individual Git credentials.

If you can think of an action that isn't documented here, please let our in-app support know!

Did this answer your question?