Skip to main content
Version: TeamForge 22.1

TeamForge-Git Integration

Although Git is the world’s leading distributed version control system, the enterprise has been slow and tentative in its adoption. Concerned with security breaches, compliance violations and lack of governance, many organizations have chosen to take a "wait and see" approach. With TeamForge, Git is ready for the enterprise. TeamForge lets you realize all the benefits of Git while ensuring the security, governance and manageability your business demands. With TeamForge, you can even manage Git and Subversion together, within each individual project.

Gerrit is an open source code review system designed to work with Git. Gerrit supports various access control mechanisms. The TeamForge Git integration uses Gerrit as a vehicle to bring TeamForge project roles and permissions into Git.

Install or Upgrade TeamForge-Git Integration​

You can install Git on the TeamForge Application Server or on a separate server dedicated for SCM. For more information about installing and upgrading Git, see TeamForge install and upgrade instructions.

Git Integration Blog Posts​

You can also read the CollabNet blog posts on Git and follow the latest developments in the Digital.ai TeamForge-Git integration space.

Add Git as a Linked Application​

Once you have installed Git, you can add Git as a linked application on your TeamForge site.

In TeamForge 7.2 and later versions, installing Git for the first time creates a site-wide linked application automatically.

However, this behavior can be controlled by the teamforge.createTFProjectLinkedApps Gerrit config (gerrit.config) property.

  1. Set up the URL http://<TEAMFORGEHOSTNAME>/gerrit/sso/.

    note

    The / at the end of the URL matters. Make sure you have it.

  2. For instructions on setting up a site-wide linked application in TeamForge, see Create a Site-wide Linked Application.

    Here's an example for Git:

    A link for Git is added to the More menu in your TeamForge navigation bar.

    Clicking Git displays the Git console in the main TeamForge window.

Illustrations on TeamForge-Gerrit Communication​

The following illustrations help you understand the communication flow between TeamForge and Gerrit in a single host and distributed environments.

TeamForge and Git/Gerrit on a Single Host​

TeamForge and Git/Gerrit in a Distributed Two-server Setup​

TeamForge, Git/Gerrit and Replica Server in a Three-server Distributed Setup​