Helix TeamHub configuration

Overview

You, the administrator of Helix TeamHub and the Git Connector of Helix Core Server, can set up mirroring a Git repository into the Helix Core Server. You can choose the type of event that causes mirroring to occur:

Note

For details on setting up continuous integration (CI) builds with Jenkins in Helix TeamHub, see Configuring builds with Jenkins in the Helix TeamHub User Guide. Note that the feature branch workflow in TeamHub requires a successful (green) build from Jenkins before you can merge the feature branch into the target branch in TeamHub.

See also CI builds with Jenkins.

Sequence of events

  1. An end-user does a git push from the local computer to the Helix TeamHub server.
  2. The user's action fires a Repository Webhook in Helix TeamHub to notify the Git Connector.
  3. Git Connector fetches the new changes.
  4. Git Connector mirrors the Git repo into the specified Helix Core graph depot.
  5. Optionally, an automated build occurs, using a tool such as Jenkins, which is supported by p4Jenkins.

Limitations

This use case is for Helix TeamHub on-premise, not the cloud version of Helix TeamHub.

Repo access is through username/password or SSH key. Helix TeamHub on-premise does not support for SSO or two-factor authentication.

For mirroring, use a repository hook, not a company hook or a project hook. For details, see the Helix TeamHub User Guide on Webhooks.

Authentication

Both HTTP and SSH are supported. To use SSH, the public key needs to be added to Helix TeamHub.

System requirements

  • Ubuntu 14.04 LTS, Ubuntu 16.04 LTS, CentOS or Red Hat 6.x, CentOS or Red Hat 7.x
  • Must be an administrator for a working Helix TeamHub, so that you can set up a Repository Webhook
  • Must be an administrator on the Git Connector server, so you can run the command to add a mirror hook
  • A working Git Connector with patch release string 2017.1/1572461
  • A working Helix Core Server server, either 17.1 patch 2017.1/1574018 or 17.2
  • A Helix TeamHub repository that is not empty. This repository will be the source for mirroring into the Helix graph depot.
  • A Helix TeamHub bot account you can use instead of personal credentials. The two options are:
    • A regular bot with access to relevant projects and repositories on the team view
    • A company admin bot account, which has access to every repository inside the company

For more information, see Bots & programmatic repository access in Helix TeamHub User Guide.

Installation of Helix TeamHub On-Premise

You, the Git Connector administrator:

  1. Go to the Download Helix TeamHub page.
  2. Locate the Helix TeamHub package to download.
    See the installation instructions at Getting started with Helix TeamHub.
  3. Run the package for an on-premise installation of Helix TeamHub.

Next steps

Configure for HTTP or SSH. Optionally, set up automated builds with Jenkins.

Also in this section: