GitLab

Setting up a linkSetting up a link

In Tracker issues, you can automatically add links to merge requests from GitLab. To do this, specify the appropriate issue's key in the name or description of a new merge request. The links will be placed in Links to external applications.

You can also enable automatic creation of issue comments with information about merge requests. Auto comments are only available for Managed Service for GitLab.

Create a hook for integrationCreate a hook for integration

To link GitLab merge requests to Tracker issues, create a hook:

1. If you do not have an OAuth token for working with the Tracker API yet, get one.

2. Check if you have access to the API by requesting information about the current user.

3. Open a GitLab instance and go to the hook settings:

   • To enable integration for the entire GitLab instance (GitLab admin privileges are required):
     1. In the left-hand panel, click the Your work drop-down list and select Admin Area.
     2. Go to System Hooks.
   • To enable integration for an individual project:
     1. Go to the project you need.
     2. In the left-hand panel, click Settings and select Webhooks.

4. Specify the hook parameters:

   • URL: https://api.tracker.yandex.net/v2/system/gitlab/receive?comments=true&<organization_type>=<organization_ID>.

     Where:

     • comments=true: Enables automatic creation of comments in an issue with a link to and information about merge requests. Disable it if commenting is not required. This parameter is only available for Managed Service for GitLab.

     • <organization_type>: It may take the following values:

       • x_cloud_org_id: If the type of your organization is Yandex Cloud Organization.
       • x_org_id: If the type of your organization is Yandex 360 for Business or both Yandex 360 for Business and Yandex Cloud Organization.

     • <organization_ID>: ID of the organization from the Tracker organizations page.

   • Secret token: OAuth token of the bot that will be used to add the links, in OAuth <token_contents> format.
     For example: OAuth y1_AQAD-qJScAAAEKEQbBNnChvfBIqR_yEQl_HMO0********.

   • In the Trigger section, disable all options except Merge request events.

   • In the SSL verification section, select Enable SSL verification.

5. Click Add system hook (Add webhook for an individual project).

The System Hooks (Project Hooks for an individual project) section with information about the created hook and its parameters will appear on the page.

Test the hookTest the hook

1. Under System Hooks (Project Hooks for an individual project), click Test.
2. Select Merge request events from the drop-down list.

A test request should return a response saying Hook executed successfully: HTTP 204. If the test request returns an error, the hook parameters are incorrect.

See alsoSee also

• Manual for integrating GitLab with Yandex Tracker

Connecting a repositoryConnecting a repository

To connect your repository on GitLab to Tracker:

1. Make sure you are authorized in Tracker as an administrator.

2. In the left-hand panel, click and select Admin settings → Repositories → Connect.

3. Choose GitLab in the Platform field.

4. Get an OAuth token for your repository on GitLab. For details on how to get a token, see the GitLab documentation. For the proper operation of Tracker, enable the read_repository and read_api options when setting up permissions.

5. Enter the repository address as https://github.com/<repository_owner_login>/<repository_name> and specify the access token.

6. Click Connect.

7. Make sure that the repository status in Tracker is Connected.

To link a commit to an issue, specify the issue key in the comment to the commit.

To view the linked commits, select Show the Commits tab in the queue settings. You can view the linked commits:

• In the Commits tab on the issue page.
• On the queue commits page. To switch to the commits page from the queue page, click → Commits in the top-right corner.

Own serverOwn server

To connect your own server to Tracker:

1. Make sure you are authorized in Tracker as an administrator.

2. In the left-hand panel, click and select Admin settings → Repositories → Connect.

3. In the Platform field, select the platform your server is connected to.

4. In the Link to repository field, specify your server address to any repository that can be accessed using a token.

5. Get an OAuth token for your repository on GitLab. For details on how to get a token, see the GitLab documentation. For the proper operation of Tracker, enable the read_repository and read_api options when setting up permissions.

6. In the Token field, enter the token for connecting to your server.

7. Click Connect.

8. Make sure that the repository status in Tracker is Connected.