GitLab Integration

1. Log in to Collaborator as administrator. (To integrate with GitLab repositories, you need administrator privileges in Collaborator).

2. On the Collaborator main toolbar, click ADMIN, and then select Repository Hosting Services from the tree on the left. Then switch to the Easy Add Repository tab.

3. On the tab, select GitLab in the Add repository for box and click Next:

   

   Click the image to enlarge it.

4. Collaborator will displays a page with connection details.

   Fill in the edit boxes:

   

   Click the image to enlarge it.

   Setting	Description
   Private token	Required. The token for a GitLab account that has access to the remote repository. This is the token that we generated in GitLab earlier.
   Group	Required only for group owned repositories (https://gitlab.com/GroupName/RepoName). Specifies the name of your GitLab group account (GroupName).
   GitLab Community host name	Required for repositories on self-hosted servers. Specifies the host name of your GitLab Enterprise or GitLab Community server.
   Webhooks secret token	Optional. The secret token for webhook events. If provided, must be at least 8 characters long. To learn more about webhook settings on the GitLab side, see GitLab documentation: https://gitlab.com/help/user/project/integrations/webhooks.md
   Override existing configurations	Optional. Specifies whether to override existing configurations that track the same repository URI.
   Branches to track	Optional. The names of branches to track changes and create reviews on merge requests and direct pushes. Separate multiple branch names with commas. You can use Java-style regular expressions to match specific branch names, or you can use the * wildcard (alone, or separated by commas) to match all branches. Note that wildcards and regular expressions cannot be used if you enable the Status check required setting (see below). If this edit box is empty, the branch main will be tracked.
   Ignore pushes for branches	Optional. Specifies branches for which Collaborator will not create reviews on direct pushes. You can enter one or several branch names. Separate multiple branch names with commas. You can also use Java-style regular expressions to match specific branch names, or you can use the * wildcard (alone, or separated by commas) to match all branches. Note that wildcards and regular expressions cannot be used if you enable the Status check required setting (see below).
   When review completed	Optional. Specifies an action to perform when a review corresponding to the merge request was accomplished: Value Description Do nothing Do not perform any action. Merge the merge request Merge the merge request that matches the review. Merge the merge request and delete its branch Merge the merge request that matches the review and delete the corresponding branch. Close the merge request Close the merge request that matches the review. Close the merge request and delete its branch Close the merge request that matches the review and delete the corresponding branch.
   When review cancelled/deleted/rejected	Optional. Specifies an action to perform when a review corresponding to a merge request was cancelled, deleted or rejected: Value Description Do nothing Do not perform any action. Close merge request Close merge request that matches the review. Close merge request and delete its branch Close merge request that matches the review and delete the corresponding branch.
   Reopen a review when	Optional. Specifies in what cases Collaborator should reopen completed reviews. May include any combination of the following: when a push to a merge request is made, when a comment is added to a merge request, when a comment is added to commit which is a part of a merge request
   Sync groups	Specifies whether Collaborator should synchronize its native groups with group information from the GitLab server. Effective if the global Enable group sync setting is turned on. Once enabled, on every logging-in, Collaborator will check user membership in groups on the GitLab server, create new groups (if needed), and automatically add this user to the corresponding groups on the Collaborator server. See Syncing Groups and Their Members for details. To ensure that Collaborator users do not have access to reviews that contain code from the repositories that they do not have access to, use the Restrict Access to Review Content settings.
   Wait for signature (if enabled) before merge	Optional. Effective, if "When review completed" setting is set to "Merge the pull request" or "Merge the pull request and delete its branch". If enabled Collaborator will wait for the completed review to be signed off before merging the respective pull request. Otherwise, pull request will be merged immediately, even if the review have not been signed yet.
   Default review template	Specifies the initial template that will be chosen when creating review (if set to "None", the first template in the list will be chosen). The value of this setting overrides the value of Default review template setting specified on group level.

5. After you specified the settings, click Load repositories. This will display a list of repositories available for the specified user account or organization in GitLab. Select the repositories to track and click Create for selected. To stop suggesting integrations for some specific repositories, select these repositories in the list and click Ignore selected.

   Alternatively, you can click Create for all and use the settings for all repositories that are available for the specified user account or organization in GitLab. Collaborator will create an individual configuration for each repository, and, if needed, will create a webhook for each repo in GitLab.

1. Log in to Collaborator as an administrator. (To configure integration settings, you need administrator privileges in Collaborator).

2. On the Collaborator main toolbar, click ADMIN, and then select Repository Hosting Services from the tree on the left. Then switch to the Configure Remote Systems tab.

3. In the New Remote System Configuration section, select GitLab and click Create:

   

   Click the image to enlarge it.

4. Collaborator will display a page with configuration settings. Specify the setting values:

   Setting	Description
   Title	Required. The configuration name as it will be displayed in Collaborator user interface.
   GitLab repo URI	Required. The URI of the GitLab repository to be tracked, for example, https://gitlab.com/gitlab-org/gitlab-ee.git. You can copy the URI from the repository settings in GitLab: Click the image to enlarge it.
   Private token	Required. The personal access token for the GitLab account that has access to the repository. This is the token that we generated in GitLab earlier.
   Webhooks secret token	Optional. The secret token for webhook events. If provided, must be at least 8 characters long. To learn more about webhook settings on the GitLab side, see GitLab documentation: https://gitlab.com/help/user/project/integrations/webhooks.md
   Branches to track	Optional. The names of branches to track changes and create reviews on merge requests and direct pushes. Separate multiple branch names with commas. You can use Java-style regular expressions to match specific branch names, or you can use the * wildcard (alone, or separated by commas) to match all branches. If this edit box is empty, the branch main will be tracked.
   Ignore pushes for branches	Optional. Specifies branches for which Collaborator will not create reviews on direct pushes. You can enter one or several branch names. Separate multiple branch names with commas. You can also use Java-style regular expressions to match specific branch names, or you can use the * wildcard (alone, or separated by commas) to match all branches.
   When review completed	Optional. Specifies an action to perform when a review corresponding to the merge request was accomplished: Value Description Do nothing Do not perform any action. Merge the merge request Merge the merge request that matches the review. Merge the merge request and delete its branch Merge the merge request that matches the review and delete the corresponding branch. Close the merge request Close the merge request that matches the review. Close the merge request and delete its branch Close the merge request that matches the review and delete the corresponding branch.
   When review cancelled/deleted/rejected	Optional. Specifies an action to perform when a review corresponding to a merge request was cancelled, deleted or rejected: Value Description Do nothing Do not perform any action. Close merge request Close merge request that matches the review. Close merge request and delete its branch Close merge request that matches the review and delete the corresponding branch.
   Reopen a review when	Optional. Specifies in what cases Collaborator should reopen completed reviews. May include any combination of the following: when a push to a merge request is made, when a comment is added to a merge request, when a comment is added to commit which is a part of a merge request
   Sync groups	Specifies whether Collaborator should synchronize its native groups with group information from the GitLab server. Effective if the global Enable group sync setting is turned on. Once enabled, on every logging-in, Collaborator will check user membership in groups on the GitLab server, create new groups (if needed), and automatically add this user to the corresponding groups on the Collaborator server. See Syncing Groups and Their Members for details. To ensure that Collaborator users do not have access to reviews that contain code from the repositories that they do not have access to, use the Restrict Access to Review Content settings.
   Wait for signature (if enabled) before merge	Optional. Effective, if "When review completed" setting is set to "Merge the merge request" or "Merge the merge request and delete its branch". If enabled Collaborator will wait for the completed review to be signed off before merging the respective merge request. Otherwise, merge request will be merged immediately, even if the review have not been signed yet.
   Default review template	Specifies the initial template that will be chosen when creating review (if set to "None", the first template in the list will be chosen). The value of this setting overrides the value of Default review template setting specified on group level.
   Webhook status	Indicates the current status of the webhook: Status Description Webhook is absent The webhook has not been created yet. Webhook isn't active The webhook has been created, but is inactive. Up and running The webhook is active.

5. To create or activate a webhook, click Update webhook.

   Important: Click this button, when you set up integration with your repository for the first time.

   To learn more about webhook settings on the GitLab side, see GitLab documentation:

   https://gitlab.com/help/user/project/integrations/webhooks.md

6. Click Test Connection to verify if you entered data correctly.

   Click Save to store the settings.

Sections above describe how to add integrations for existing repositories. When some new repositories are created on a server, you may integrate them manually. Alternatively, you can setup GitLab auto-polling configuration that will periodically look for new repositories on the specified server, user or group and suggest creating integrations for them.

1. Log in to Collaborator as administrator. (To integrate with GitLab repositories, you need administrator privileges in Collaborator).

2. On the Collaborator main toolbar, click ADMIN, and then select Repository Hosting Services from the tree on the left. Then switch to the Repository Auto-Polling tab.

3. On the tab, select GitLab in the Add configuration box and click Next.

4. Collaborator will displays a page with connection details.

   

   Click the image to enlarge it.

   Fill in the edit boxes:

   Setting	Description
   Server URI	Required. The URI of GitLab server, user or group to be polled for new repositories.
   Token	Required. The private token for the GitLab account. This is the token that we generated in GitLab earlier.

   After specifying these values, you can click Test connection to verify if you entered data correctly.

5. After you specified the values, click Save. This will create an auto-polling configuration and display it in the Auto-Polling Configurations List.
6. Scroll down the Repository Auto-Polling tab and check that the Enable Auto-Polling setting is on and optionally change the Auto-Polling Interval setting.

Now Collaborator will automatically check if any new repositories were found on the specified server. Once found, it will notify administrators and suggest creating integrations with these newly created repositories via the Easy Add Repository wizard.