GitHub or GitLab HTTP

Prerequisites

• The target repo must NOT already exist in P4 Server.
• The source repo must not be empty.

• If the repo is private or internal, consider creating a personal access token:

  • For GitHub - Creating a personal access token for the command line - https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/
  • For GitLab - Personal access tokens - https://docs.gitlab.com/ce/user/profile/personal_access_tokens.html

On the Git Connector server

1. Log in as the GitConnector SSH system user or the user you specified when configuring the Git Connector. (The GitConnector configuration script, configure-git-connector.sh, sets the user name to git by default, but you can specify a different user name in the --sshuser parameter.)

2. Configure the webhook for mirroring:

   Copy the URL from your project's HTTP drop-down box.
   
   1. Set the environment variable GCONN_CONFIG to the absolute path to the gconn.conf file:

      export GCONN_CONFIG=/opt/perforce/git-connector/gconn.conf

   2. Add the web hook:

      gconn --mirrorhooks add //graphDepotName/repoName https://access-token:secret@GitHost.com/project/repoName.git

      where access-token:secret represents your personal access token for GitHub or GitLab.

      Use the URL to create the mirror hook. Do not create a mirror hook by using an IP address.

3. Save the secret token that the --mirrorhooks command generates, which is not related to the personal access token for GitHub or GitLab.

   The secret token is also included in the repo spec on the P4 Server. To write the repo spec to standard output, run:

   p4 repo -o {//graphDepotName/repoName}

Mirror a repo over HTTP

1. Go to the hooks URL, which might resemble https://GitHost/project/repo/hooks and represents the web hook URL for your Git client:

   • For GitLab see https://docs.gitlab.com/ce/user/project/integrations/webhooks.html
   • For GitHub, see https://developer.github.com/webhooks/creating/

2. Paste the URL of the Git Connector into the URL text box: https://GitConnector.com/mirrorhooks

3. Paste the webhook secret token in the Secret Token text box.

4. Uncheck Enable SSL verification.

5. Select events to trigger the webhook and click Add Webhook.

6. Click the lower right corner Test button to validate the web hook is correctly set up.